CKTIS / JavaScript
Atribuição OR lógica (||=)
O operador ||= atribui o valor da direita apenas quando o valor atual do destino é falsy. Avalia condicionalmente e avalia a referência ao destino apenas uma vez.
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 valor do destino e testa-o com ToBoolean. Se for truthy, o operador devolve-o sem avaliar expression nem efetuar uma atribuição. Caso contrário, avalia a expressão à direita, atribui o respetivo valor e devolve-o; o resultado não tem de ser do tipo boolean.
Os valores falsy incluem false, 0, -0, 0n, "", NaN, null e undefined. Por isso, ||= pode substituir um zero válido ou uma cadeia vazia. Usa ??= quando apenas null e undefined devem significar que falta um valor. O operador |= efetua um OR bit a bit e não substitui ||=.
A referência ao destino é avaliada apenas uma vez. obj[key()] ||= value chama key() uma vez, ao contrário da expansão ingénua obj[key()] = obj[key()] || value. Um getter pode ser executado durante a leitura, mas o setter é ignorado se o valor lido for truthy. O destino tem de ser um destino de atribuição válido; uma variável não declarada não pode ser inicializada desta forma.
O operador faz parte do ECMAScript 2021. É sintaxe da linguagem, não uma Web API. Para a implementação, verifica o suporte da sintaxe nos motores de destino ou transforma o código; a presença de Node 24 num repositório não comprova o suporte nos browsers.
Exemplos
let calls = 0;
function fallback() {
calls += 1;
return "Guest";
}
const profile = { name: "", role: "admin" };
profile.name ||= fallback();
profile.role ||= fallback();
let limit = 0;
limit ||= 10;
console.log(profile.name);
console.log(profile.role);
console.log(calls);
console.log(limit);Resultado
Guest admin 1 10
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.