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 ??= expressiontarget ??= 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"}
1O 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.