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

CKTIS / JavaScript

Atribuição nullish: ??=

O operador ??= atribui um valor apenas quando o alvo contém null ou undefined. Mantém 0, false e a cadeia vazia.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

target ??= expression

target ??= expression lê o alvo e atribui o resultado de expression apenas se este contiver null ou undefined. Devolve o valor mantido ou atribuído.

O lado esquerdo é avaliado uma única vez. Se a atribuição for ignorada, o lado direito não é avaliado e não é chamado nenhum setter. A própria leitura pode invocar um getter.

Ao contrário de ||=, mantém 0, false, "" e NaN. ?? por si só não efetua uma atribuição. O alvo tem de ser um alvo de atribuição válido; o operador não declara uma variável.

O operador foi introduzido no ECMAScript 2021 (12.ª edição).

Exemplos

const settings = { retries: 0, label: null };
let calls = 0;
function fallback() {
  calls += 1;
  return "Guest";
}
settings.retries ??= fallback();
settings.label ??= fallback();
console.log(JSON.stringify(settings));
console.log(calls);

Resultado

{"retries":0,"label":"Guest"}
1

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes