WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Spread- und Rest-Syntax (...)

Die Schreibweise `...` hat je nach Kontext zwei Rollen: Spread erweitert Werte oder Eigenschaften, Rest sammelt übrige Argumente, Elemente oder Eigenschaften. Sie ist kein eigenständiger Ausdrucksoperator. Mit dieser Syntax erstellte Kopien sind flach.

Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

fn(...iterable)
[...iterable]
({ ...source })
function fn(first, ...args) {}
const [first, ...tail] = iterable;
const { key, ...remaining } = source;

... bezeichnet je nach Position die Spread- oder Rest-Syntax; es ist kein eigenständiger Ausdrucksoperator. Spread in fn(...iterable) übergibt Werte als Argumente, während [...iterable] sie in ein neues Array einfügt. Die Quelle muss iterierbar sein: Ein einfaches Objekt genügt nicht. Sehr große Argumenterweiterungen können das Limit einer Engine überschreiten.

Spread in { ...source } kopiert eigene aufzählbare Eigenschaften, einschließlich Symbol-Schlüsseln; Iterierbarkeit ist nicht erforderlich. Spätere Definitionen überschreiben frühere Werte desselben Schlüssels. Der Prototyp und Eigenschaftsdeskriptoren werden nicht kopiert, und das Lesen von Eigenschaften kann Getter aufrufen. Die Quellen null und undefined werden hier ignoriert, aber [...null] löst einen TypeError aus.

Rest in function fn(first, ...args) {} sammelt übrige Argumente in einem echten Array. Bei der Destrukturierung sammelt const [first, ...tail] = iterable übrige Iteratorwerte in einem Array, während const { key, ...remaining } = source ein Objekt mit den übrigen eigenen aufzählbaren Eigenschaften erstellt. Rest muss in seiner Liste an letzter Stelle stehen und darf kein nachgestelltes Komma haben; ein Restparameter kann keinen Standardwert haben.

Kopien sind flach: Verschachtelte Objekte bleiben gemeinsam genutzt. Das Beispiel zeigt Erweiterung, Sammlung und die gemeinsame Nutzung von settings. Restparameter, Array-Rest und Spread für Arrays und Argumente gibt es seit ES2015; Objekt-Rest/Spread seit ES2018. Dies sind ECMAScript-Funktionen, keine Web APIs. Die Spezifikation ist keine Browser-Kompatibilitätstabelle; die Unterstützung in einem bestimmten Browser muss separat geprüft werden, und Node 24 in einem Repository belegt sie nicht.

Beispiele

function sum(...values) {
  return values.reduce((total, value) => total + value, 0);
}

const numbers = [2, 3, 4];
const [first, ...tail] = numbers;
const original = { name: "Ada", settings: { active: true } };
const copy = { ...original, name: "Lin" };
const { name, ...remaining } = copy;

console.log(sum(...numbers));
console.log(JSON.stringify([first, ...tail, 5]));
console.log(name, remaining.settings === original.settings);

Ergebnis

9
[2,3,4,5]
Lin true

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen