Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Destrutturazione degli oggetti

La destrutturazione degli oggetti legge le proprietà per chiave anziché per posizione. Permette di dichiarare variabili, assegnare valori a destinazioni esistenti, impostare valori predefiniti e raccogliere le proprietà rimanenti.

Versione: ECMAScript 2024 and the current web platform; runtime support varies

Sintassi

const { name, theme: colorTheme = "light", ...rest } = profile;
let score;
({ points: score } = profile);
const { [key]: value, settings: { mode } = {} } = options;
function readName({ name = "Guest" } = {}) { return name; }

La destrutturazione degli oggetti usa un pattern tra {} per leggere le proprietà per chiave. In const { name } = profile, la variabile name riceve il valore di profile.name. Il pattern { name: displayName } legge la stessa chiave e mette il valore nella variabile displayName, senza rinominare la proprietà. Con { [key]: value } la chiave viene calcolata; { settings: { mode } } legge una proprietà annidata e crea un'associazione solo per mode.

In una dichiarazione con const, let o var, oppure in un parametro di funzione, il pattern crea associazioni. L'assegnazione ({ points: score } = profile) scrive nella variabile esistente score; anche una proprietà scrivibile può essere la destinazione. In un'istruzione a sé stante, le parentesi impediscono che la graffa iniziale venga interpretata come l'inizio di un blocco.

In { theme = "light" }, l'espressione predefinita viene valutata solo se la lettura restituisce undefined, per esempio quando la proprietà non viene trovata. Valori come null, false e 0 restano invariati. Applicare un pattern di oggetto a null o undefined genera un TypeError, anche in un pattern annidato. In function readName({ name = "Guest" } = {}), il valore predefinito del parametro = {} interviene se l'argomento è omesso o vale undefined, ma non se vale null.

La ricerca di una chiave esplicita può trovare una proprietà ereditata. Invece ...rest copia in un nuovo oggetto solo le proprietà proprie ed enumerabili rimanenti, incluse quelle con chiavi di tipo simbolo. La copia è superficiale: i valori che sono oggetti restano condivisi. ...rest deve essere l'ultimo elemento, senza virgola finale.

È sintassi di ECMAScript 2024, non un'API del browser. Negli ambienti JavaScript meno recenti, verifica il supporto per le forme che usi, soprattutto ...rest.

Esempi

{
  const profile = { name: "Mira", theme: undefined, badge: null, points: 7 };
  const { name: displayName, theme = "light", badge = "none", ...rest } = profile;
  let score;
  ({ points: score } = profile);
  console.log(`${displayName} | ${theme} | ${badge} | ${score} | ${Object.keys(rest).join(",")}`);
}

Risultato

Mira | light | null | 7 | points

`displayName` riceve il valore di `name`, `theme` assume il valore predefinito e `badge` resta `null`. L'assegnazione scrive `7` in `score`; `points` è l'unica chiave di `rest`.

Lezioni correlate

  • JavaScript · Lezione 39 · Avanzato · Versione: 4
  • JavaScript · Lezione 5 · Base · Versione: 4
  • JavaScript · Lezione 18 · Base · Versione: 4
  • JavaScript · Lezione 2 · Intermedio · Versione: 3
  • JavaScript · Lezione 8 · Intermedio · Versione: 3
  • JavaScript · Lezione 10 · Intermedio · Versione: 3

Fonti