CKTIS / JavaScript
Destrutturazione dei parametri di funzione
Scrivi i pattern direttamente nell’elenco dei parametri per leggere proprietà di oggetti o valori di iterabili. Distingui i valori predefiniti dell’intero parametro da quelli all’interno del pattern.
Versione: ECMAScript 2024 and the current web platform; runtime support varies
Sintassi
function readOptions({ label: name = "untitled" } = {}) { return name; }
function readFirst([count = 1] = []) { return count; }Destrutturare i parametri significa scrivere un pattern di binding direttamente nell’elenco dei parametri della funzione. Per un parametro ordinario, il pattern usa il valore corrispondente a una sola posizione tra gli argomenti e crea binding locali disponibili nel corpo della funzione. Anche un parametro rest (...) può usare un pattern di binding, ma in questo caso il pattern destruttura l’array che contiene gli argomenti rimanenti. Gli argomenti restano posizionali, non passati per nome.
Il pattern per oggetti { label } legge la proprietà per nome e crea un binding locale chiamato label. { label: name } legge la stessa proprietà, ma ne associa il valore al nome locale name. Il pattern per array [count] prende il primo valore nell’ordine di iterazione, da un array o da un altro iterabile.
I valori predefiniti esterni = {} e = [] sostituiscono l’intero argomento prima della destrutturazione, ma solo se viene omesso o è undefined. I valori predefiniti interni, come in name = "untitled" e count = 1, si applicano solo se il valore estratto è undefined, per esempio se manca una proprietà o l’iteratore non fornisce un altro valore. null, 0, false e "" non attivano i valori predefiniti.
Passare null come intero argomento a uno dei due pattern genera un TypeError prima che venga eseguito il corpo della funzione. Senza un valore predefinito esterno, omettere l’argomento o passare undefined genera lo stesso errore. Un pattern per array genera un TypeError anche se il valore non è iterabile. La destrutturazione non sostituisce la validazione dei dati di ingresso.
Esempi
function describe({ label: name = "untitled" } = {}, [count = 1] = []) {
return `${name}: ${count}`;
}
console.log(describe());
console.log(describe({ label: "draft" }, [0]));
console.log(describe({ label: null }, []));Risultato
untitled: 1 draft: 0 null: 1
La prima chiamata usa entrambi i livelli di valori predefiniti. La seconda mantiene `0`. Nella terza, `label` vale `null` e non viene sostituito, mentre l’array vuoto fa scattare `count = 1`.
Lezioni correlate
- JavaScript · Lezione 2 · Intermedio · Versione: 3