Baseline Widely available
Die shift()
Methode von Array
Instanzen entfernt das erste Element aus einem Array und gibt dieses entfernte Element zurück. Diese Methode verändert die Länge des Arrays.
const array = [1, 2, 3];
const firstElement = array.shift();
console.log(array);
// Expected output: Array [2, 3]
console.log(firstElement);
// Expected output: 1
Syntax Parameter
Keine.
RückgabewertDas entfernte Element aus dem Array; undefined
, wenn das Array leer ist.
Die shift()
Methode verschiebt alle Werte um 1 nach links und verringert die Länge um 1, was dazu führt, dass das erste Element entfernt wird. Wenn die length
-Eigenschaft 0 ist, wird undefined
zurückgegeben.
Die pop()
-Methode verhält sich ähnlich wie shift()
, wird jedoch auf das letzte Element in einem Array angewendet.
Die shift()
Methode ist eine mutierende Methode. Sie verändert die Länge und den Inhalt von this
. Falls Sie den Wert von this
gleich belassen, aber ein neues Array mit dem ersten entfernten Element zurückgeben möchten, können Sie stattdessen arr.slice(1)
verwenden.
Die shift()
Methode ist generisch. Sie erwartet nur, dass der this
-Wert eine length
-Eigenschaft und integer-indizierte Eigenschaften hat. Obwohl Strings ebenfalls array-ähnlich sind, ist diese Methode ungeeignet für Strings, da Strings unveränderlich sind.
Der folgende Code zeigt das myFish
-Array vor und nach dem Entfernen seines ersten Elements. Es zeigt auch das entfernte Element an:
const myFish = ["angel", "clown", "mandarin", "surgeon"];
console.log("myFish before:", myFish);
// myFish before: ['angel', 'clown', 'mandarin', 'surgeon']
const shifted = myFish.shift();
console.log("myFish after:", myFish);
// myFish after: ['clown', 'mandarin', 'surgeon']
console.log("Removed this element:", shifted);
// Removed this element: angel
Verwendung der shift() Methode in einer While-Schleife
Die shift() Methode wird oft in einer Bedingung innerhalb einer While-Schleife verwendet. Im folgenden Beispiel wird bei jeder Iteration das nächste Element aus einem Array entfernt, bis es leer ist:
const names = ["Andrew", "Tyrone", "Paul", "Maria", "Gayatri"];
while (typeof (i = names.shift()) !== "undefined") {
console.log(i);
}
// Andrew, Tyrone, Paul, Maria, Gayatri
Aufruf von shift() auf Nicht-Array-Objekten
Die shift()
Methode liest die length
-Eigenschaft von this
. Wenn die normalisierte Länge 0 ist, wird length
wieder auf 0
gesetzt (während es vorher negativ oder undefined
sein könnte). Andernfalls wird die Eigenschaft bei 0
zurückgegeben, und die restlichen Eigenschaften werden um eins nach links verschoben. Die Eigenschaft bei length - 1
wird gelöscht, und die length
-Eigenschaft wird um eins verringert.
const arrayLike = {
length: 3,
unrelated: "foo",
2: 4,
};
console.log(Array.prototype.shift.call(arrayLike));
// undefined, because it is an empty slot
console.log(arrayLike);
// { '1': 4, length: 2, unrelated: 'foo' }
const plainObj = {};
// There's no length property, so the length is 0
Array.prototype.shift.call(plainObj);
console.log(plainObj);
// { length: 0 }
Spezifikationen Browser-Kompatibilität Siehe auch
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4