Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Przypisanie z logicznym OR (||=)

Operator ||= przypisuje wartość prawej strony tylko wtedy, gdy bieżąca wartość celu jest fałszywa w kontekście logicznym. Działa ze skróconą ewaluacją i oblicza odwołanie do celu tylko raz.

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

Składnia

target ||= expression

target ||= expression odczytuje wartość celu i sprawdza ją przez ToBoolean. Jeśli jest prawdziwa w kontekście logicznym (truthy), zwraca ją bez obliczania expression i bez przypisania. W przeciwnym razie oblicza prawą stronę, przypisuje jej wartość i ją zwraca; wynik nie musi być typu boolean.

Wartości fałszywe w kontekście logicznym (falsy) obejmują false, 0, -0, 0n, "", NaN, null i undefined. Dlatego ||= może nadpisać poprawne zero lub pusty tekst. Gdy tylko null i undefined mają oznaczać brak wartości, użyj ??=. Operator |= wykonuje bitowe OR i nie jest zamiennikiem ||=.

Odwołanie do celu jest obliczane tylko raz. obj[key()] ||= value wywołuje key() raz, w przeciwieństwie do naiwnego rozwinięcia obj[key()] = obj[key()] || value. Getter może zostać wywołany przy odczycie, ale setter jest pomijany, gdy odczytana wartość jest truthy. Cel musi być poprawnym celem przypisania; niezadeklarowana zmienna nie zostanie w ten sposób zainicjalizowana.

Operator należy do ECMAScript 2021. To składnia języka, nie Web API. Przy wdrożeniu sprawdź obsługę składni w docelowych silnikach lub zastosuj transformację kodu; sam Node 24 w repozytorium nie potwierdza obsługi w przeglądarkach.

Przykłady

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

Wynik

Guest
admin
1
10

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła