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

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 ||= expression

target ||= 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.

Fontes