Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Přiřazení s logickým OR (||=)

Operátor ||= přiřadí hodnotu z pravé strany pouze tehdy, když je aktuální hodnota cíle falsy. Vyhodnocuje podmíněně a referenci cíle vyhodnotí jen jednou.

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

Syntaxe

target ||= expression

target ||= expression přečte hodnotu cíle a otestuje ji pomocí ToBoolean. Pokud je truthy, operátor ji vrátí, aniž by vyhodnotil expression nebo provedl přiřazení. Jinak vyhodnotí pravou stranu, přiřadí její hodnotu a vrátí ji; výsledkem nemusí být hodnota typu boolean.

Mezi falsy hodnoty patří false, 0, -0, 0n, "", NaN, null a undefined. Operátor ||= tedy může přepsat platnou nulu nebo prázdný řetězec. Použijte ??=, pokud mají chybějící hodnotu označovat pouze null a undefined. Operátor |= provádí bitové OR a není náhradou za ||=.

Reference cíle se vyhodnotí pouze jednou. obj[key()] ||= value zavolá key() jednou, na rozdíl od naivního rozvinutí obj[key()] = obj[key()] || value. Při čtení se může spustit getter, ale pokud je načtená hodnota truthy, setter se přeskočí. Cíl musí být platným cílem přiřazení; takto nelze inicializovat nedeklarovanou proměnnou.

Operátor je součástí ECMAScript 2021. Jde o syntaxi jazyka, nikoli o Web API. Před nasazením ověřte podporu syntaxe v cílových enginech nebo kód transformujte; přítomnost Node 24 v repozitáři nedokládá podporu v prohlížečích.

Příklady

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);

Výsledek

Guest
admin
1
10

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje