CKTIS / JavaScript
Destrutturazione di array nei parametri di funzione
Un pattern di array nella lista dei parametri scompone un unico argomento iterabile. I valori predefiniti dell’argomento e dei singoli elementi sono distinti.
Versione: ECMAScript 2024 and the current web platform; runtime support varies
Sintassi
function f([first = 1, , third = 3, ...rest] = []) { /* function body */ }Nella lista dei parametri, [first, third] è un pattern di binding per array che scompone un unico argomento, non due parametri separati. A ogni chiamata il pattern inizializza i nomi locali nell’ordine di iterazione, prima che venga eseguito il corpo della funzione. Si può passare un array o un altro iterabile, come un Set; un oggetto ordinario con chiavi numeriche e una proprietà length non basta.
In [first = 1, , third = 3, ...rest], lo spazio vuoto tra le virgole salta il secondo valore. ...rest raccoglie i valori rimanenti in un nuovo array. È un elemento rest del pattern, non un parametro rest che raccoglie argomenti separati della chiamata. Deve essere l’ultimo elemento e non può essere seguito da una virgola.
Il = [] esterno sostituisce l’intero argomento solo se viene omesso o se vale undefined. I valori predefiniti interni = 1 e = 3 si applicano se il valore corrispondente manca o vale undefined. Un null all’interno dell’array resta null. Se l’intero argomento è null o un altro valore non iterabile, viene generato un TypeError prima di eseguire il corpo. Senza = [], omettere l’argomento o passare undefined genera ugualmente un TypeError.
Esempi
function describe([first = 1, , third = 3, ...rest] = []) {
return [first, third, rest];
}
console.log(JSON.stringify(describe()));
console.log(JSON.stringify(describe([undefined, 20, null, 40, 50])));
console.log(JSON.stringify(describe(new Set([10, 20, 30]))));
try {
describe(null);
} catch (error) {
console.log(error.name);
}Risultato
[1,3,[]] [1,null,[40,50]] [10,30,[]] TypeError
La prima chiamata usa entrambi i livelli di valori predefiniti. Nella seconda, `20` viene saltato, `null` resta invariato e `rest` vale `[40,50]`. La terza mostra che funziona anche un `Set`. L’ultima stampa il nome dell’errore anziché un messaggio specifico dell’ambiente di esecuzione.
Lezioni correlate
- JavaScript · Lezione 28 · Intermedio · Versione: 3