Array.prototype.push()

element1, …, elementN

Das oder die Elemente, die an das Ende des Arrays angefügt werden sollen.

Die neue length Eigenschaft des Objekts, auf dem die Methode aufgerufen wurde.

Die push() Methode fügt Werte zu einem Array hinzu.

Array.prototype.unshift() hat ein ähnliches Verhalten wie push(), wird aber auf den Anfang eines Arrays angewendet.

Die push() Methode ist eine mutierende Methode. Sie ändert die Länge und den Inhalt von this. Wenn Sie möchten, dass der Wert von this gleich bleibt, aber ein neues Array mit an das Ende angefügten Elementen zurückgegeben wird, können Sie stattdessen arr.concat([element0, element1, /* ... ,*/ elementN]) verwenden. Beachten Sie, dass die Elemente in ein zusätzliches Array eingeschlossen sind — andernfalls, wenn das Element selbst ein Array ist, würde es aufgrund des Verhaltens von concat() verteilt, anstatt als einzelnes Element angefügt zu werden.

Die push() Methode ist generisch. Sie erwartet nur, dass der Wert von this eine length Eigenschaft und ganzzahlenschlüsselige Eigenschaften hat. Obwohl Strings ebenfalls array-ähnlich sind, ist diese Methode nicht geeignet, um auf ihnen angewendet zu werden, da Strings unveränderlich sind.

Der folgende Code erstellt das sports Array, das zwei Elemente enthält, und fügt dann zwei Elemente hinzu. Die Variable total enthält die neue Länge des Arrays.

const sports = ["soccer", "baseball"];
const total = sports.push("football", "swimming");

console.log(sports); // ['soccer', 'baseball', 'football', 'swimming']
console.log(total); // 4

Dieses Beispiel verwendet die Spread-Syntax, um alle Elemente eines zweiten Arrays in das erste Array zu pushen.

const vegetables = ["parsnip", "potato"];
const moreVegs = ["celery", "beetroot"];

// Merge the second array into the first one
vegetables.push(...moreVegs);

console.log(vegetables); // ['parsnip', 'potato', 'celery', 'beetroot']

Das Zusammenführen von zwei Arrays kann auch mit der concat() Methode erfolgen.

Die push() Methode liest die length Eigenschaft von this. Sie setzt dann jeden Index von this, beginnend bei length, mit den an push() übergebenen Argumenten. Schließlich setzt sie length auf die vorherige Länge plus die Anzahl der hinzugefügten Elemente.

const arrayLike = {
  length: 3,
  unrelated: "foo",
  2: 4,
};
Array.prototype.push.call(arrayLike, 1, 2);
console.log(arrayLike);
// { '2': 4, '3': 1, '4': 2, length: 5, unrelated: 'foo' }

const plainObj = {};
// There's no length property, so the length is 0
Array.prototype.push.call(plainObj, 1, 2);
console.log(plainObj);
// { '0': 1, '1': 2, length: 2 }

Wie oben erwähnt, ist push absichtlich generisch, und wir können das zu unserem Vorteil nutzen. Array.prototype.push kann ebenso gut auf einem Objekt arbeiten, wie dieses Beispiel zeigt.

Beachten Sie, dass wir kein Array erstellen, um eine Sammlung von Objekten zu speichern. Stattdessen speichern wir die Sammlung auf dem Objekt selbst und verwenden call auf Array.prototype.push, um die Methode dazu zu bringen, zu glauben, dass wir es mit einem Array zu tun haben — und es funktioniert einfach, dank der Art und Weise, wie JavaScript es uns ermöglicht, den Ausführungskontext auf jede gewünschte Weise festzulegen.

const obj = {
  length: 0,

  addElem(elem) {
    // obj.length is automatically incremented
    // every time an element is added.
    [].push.call(this, elem);
  },
};

// Let's add some empty objects just to illustrate.
obj.addElem({});
obj.addElem({});
console.log(obj.length); // 2

Beachten Sie, dass obwohl obj kein Array ist, die Methode push erfolgreich die length Eigenschaft von obj inkrementiert hat, als ob wir es mit einem tatsächlichen Array zu tun hätten.

• Polyfill von Array.prototype.push in core-js mit Korrekturen dieser Methode
• es-shims polyfill von Array.prototype.push
• Indexierte Sammlungen Leitfaden
• Array
• Array.prototype.pop()
• Array.prototype.shift()
• Array.prototype.unshift()
• Array.prototype.concat()
• Array.prototype.splice()