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