Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Dichiarazione con destrutturazione di oggetti

Una dichiarazione con destrutturazione di oggetti crea binding di variabili dalle proprietà della sorgente. Il pattern permette di scegliere i nomi, impostare valori predefiniti e raccogliere le proprietà rimanenti.

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

Sintassi

const { property, key: local = fallback, [computedKey]: selected, nested: { inner } = {}, ...rest } = source;
let { property: mutable } = source;
var { property: variable } = source;

In una dichiarazione ordinaria come const { property } = source;, le parentesi graffe racchiudono un pattern di binding, non un letterale oggetto. L’espressione source è l’inizializzatore obbligatorio. const e let hanno ambito di blocco; const impedisce di riassegnare il binding, ma non di modificare un oggetto. Dentro una funzione, var ha ambito di funzione, non di blocco.

{ key: local } legge key e dichiara local, non key. { [computedKey]: selected } calcola la chiave, mentre un pattern annidato legge proprietà al livello successivo. Un’espressione predefinita viene valutata solo se la lettura restituisce undefined, per esempio se manca la proprietà. Non sostituisce null, false o 0. Destrutturare null o undefined genera un TypeError, anche in un pattern annidato.

Una proprietà selezionata esplicitamente può essere ereditata. ...rest crea un nuovo oggetto con una copia superficiale delle sole proprietà proprie ed enumerabili rimaste, comprese quelle con chiavi Symbol. Nella dichiarazione deve comparire per ultimo, associare un identificatore e non essere seguito da una virgola. La destrutturazione non convalida i dati in ingresso; la lettura di una proprietà può invocare un getter.

({ property } = source); assegna un valore a una variabile esistente, anziché dichiararla. All’inizio di un’istruzione, le parentesi tonde impediscono che { venga interpretata come l’inizio di un blocco. ECMAScript 2024 specifica questa sintassi; controlla che l’ambiente di esecuzione di destinazione la supporti.

Esempi

{
  const key = "theme";
  const source = { name: "Ada", theme: null, active: false };
  const {
    name: displayName,
    [key]: theme = "light",
    settings: { density = "compact" } = {},
    ...rest
  } = source;

  console.log(JSON.stringify([displayName, theme, density, rest]));
}

Risultato

["Ada",null,"compact",{"active":false}]

`name` viene associato a `displayName` e `theme` rimane `null`. Poiché manca `settings`, si usa prima il valore predefinito `{}`, poi `density` assume il valore `"compact"`. In `rest` rimane soltanto `active: false`.

Lezioni correlate

  • JavaScript · Lezione 1 · Avanzato · Versione: 4
  • JavaScript · Lezione 8 · Avanzato · Versione: 4
  • JavaScript · Lezione 11 · Avanzato · Versione: 4

Fonti