Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

Asignación OR lógico (||=)

El operador ||= asigna el valor de la derecha solo cuando el valor actual del destino es falsy. Evalúa de forma condicional y evalúa la referencia al destino una sola vez.

Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxis

target ||= expression

target ||= expression lee el valor del destino y lo comprueba mediante ToBoolean. Si es truthy, el operador lo devuelve sin evaluar expression ni realizar una asignación. De lo contrario, evalúa la expresión de la derecha, asigna su valor y lo devuelve; el resultado no tiene por qué ser de tipo boolean.

Entre los valores falsy están false, 0, -0, 0n, "", NaN, null y undefined. Por ello, ||= puede sobrescribir un cero válido o una cadena vacía. Usa ??= cuando solo null y undefined deban indicar que falta un valor. El operador |= realiza un OR bit a bit y no sustituye a ||=.

La referencia al destino se evalúa una sola vez. obj[key()] ||= value llama a key() una vez, a diferencia de la expansión ingenua obj[key()] = obj[key()] || value. Puede ejecutarse un getter durante la lectura, pero se omite el setter si el valor leído es truthy. El destino debe ser un destino de asignación válido; una variable no declarada no puede inicializarse de esta manera.

El operador forma parte de ECMAScript 2021. Es sintaxis del lenguaje, no una Web API. Para el despliegue, comprueba la compatibilidad sintáctica de los motores de destino o transforma el código; que un repositorio use Node 24 no demuestra la compatibilidad de los navegadores.

Ejemplos

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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes