Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Sintassi spread e rest (...)

La notazione `...` ha due ruoli a seconda del contesto: spread espande valori o proprietà, mentre rest raccoglie gli argomenti, gli elementi o le proprietà rimanenti. Non è un operatore di espressione autonomo. Le copie create con questa sintassi sono superficiali.

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

Sintassi

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

... indica la sintassi spread o rest a seconda della posizione; non è un operatore di espressione autonomo. Spread in fn(...iterable) passa valori come argomenti, mentre [...iterable] li inserisce in un nuovo array. La sorgente deve essere iterabile: un normale oggetto non basta. Espansioni di argomenti molto grandi possono superare il limite del motore.

Spread in { ...source } copia le proprietà proprie enumerabili, comprese le chiavi Symbol; non richiede iterabilità. Le definizioni successive sovrascrivono i valori precedenti della stessa chiave. Non copia il prototipo né i descrittori delle proprietà, e la lettura delle proprietà può invocare getter. Qui le sorgenti null e undefined vengono ignorate, ma [...null] genera un TypeError.

Rest in function fn(first, ...args) {} raccoglie gli argomenti rimanenti in un vero array. Nella destrutturazione, const [first, ...tail] = iterable raccoglie i valori rimanenti dell’iteratore in un array, mentre const { key, ...remaining } = source crea un oggetto con le proprietà proprie enumerabili rimanenti. Rest deve essere l’ultimo elemento della propria lista e non può avere una virgola finale; un parametro rest non può avere un valore predefinito.

Le copie sono superficiali: gli oggetti annidati restano condivisi. L’esempio mostra l’espansione, la raccolta e la condivisione di settings. I parametri rest, il rest degli array e lo spread di array e argomenti risalgono a ES2015; il rest/spread degli oggetti a ES2018. Sono funzionalità ECMAScript, non Web API. La specifica non è una tabella di compatibilità dei browser; il supporto in un browser specifico va verificato separatamente, e la presenza di Node 24 in un repository non lo dimostra.

Esempi

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);

Risultato

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

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti