Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

Valores predefinidos na desestruturação

Um valor predefinido na desestruturação só substitui `undefined`. Preserva `null`, `false` e `0`, e a expressão predefinida só é avaliada quando é necessária.

Versão: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxe

const { property: local = fallback } = source;
const [first = fallback] = iterable;
let target;
({ property: target = fallback } = source);
function configure({ volume = 10 } = {}) { return volume; }

A notação = expressão dentro de um padrão de desestruturação fornece um valor predefinido para uma propriedade ou um elemento. O JavaScript só avalia a expressão se o valor extraído for undefined. Um padrão de objeto usa a pesquisa normal de propriedades, incluindo as herdadas. Um padrão de array lê valores de um iterador; se este se esgotar, um elemento em falta é tratado como undefined. Valores como null, false, 0, "" e NaN mantêm-se inalterados.

Em const { volume: level = 10 } = source, volume é a chave da propriedade e level é a nova variável. Para atribuir o valor a uma variável existente, escreve ({ volume: level = 10 } = source);. Quando a atribuição é uma instrução autónoma, os parênteses impedem que { seja interpretado como o início de um bloco.

Em function configure({ volume = 10 } = {}) { return volume; }, o = {} exterior fornece um objeto vazio se o argumento for omitido ou tiver o valor undefined. O = 10 interior só se aplica se a leitura de volume devolver undefined. A chamada configure(null) lança um TypeError: o valor predefinido exterior não substitui null, e um padrão de objeto não o pode desestruturar.

Exemplos

let calls = 0;
function fallback() {
  calls += 1;
  return 10;
}

const { volume: level = fallback(), muted = fallback(), label = "auto" } = {
  volume: undefined,
  muted: false,
  label: null,
};
const [first = fallback(), second = fallback()] = [0];

console.log(JSON.stringify({ level, muted, label, first, second, calls }));

Resultado

{"level":10,"muted":false,"label":null,"first":0,"second":10,"calls":2}

`fallback()` só é chamada para `level` e `second`: `volume` tem o valor `undefined` e o iterador do array não tem um segundo elemento. Os valores `false`, `null` e `0` são preservados, pelo que `calls` vale `2`.

Lições relacionadas

  • JavaScript · Lição 2 · Intermédio · Versão: 3

Fontes