Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Assegnazione OR logico (||=)

L’operatore ||= assegna il valore a destra solo quando il valore corrente del target è falsy. Valuta le espressioni in modo condizionale e valuta il riferimento al target una sola volta.

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

Sintassi

target ||= expression

target ||= expression legge il valore del target e lo verifica con ToBoolean. Se è truthy, l’operatore lo restituisce senza valutare expression né eseguire un’assegnazione. Altrimenti valuta l’espressione a destra, ne assegna il valore e lo restituisce; il risultato non deve necessariamente essere di tipo boolean.

I valori falsy includono false, 0, -0, 0n, "", NaN, null e undefined. Di conseguenza, ||= può sovrascrivere uno zero valido o una stringa vuota. Usa ??= quando solo null e undefined devono indicare un valore mancante. L’operatore |= esegue un OR bit a bit e non è un sostituto di ||=.

Il riferimento al target viene valutato una sola volta. obj[key()] ||= value chiama key() una volta, a differenza dell’espansione ingenua obj[key()] = obj[key()] || value. Durante la lettura può essere eseguito un getter, ma il setter viene ignorato se il valore letto è truthy. Il target deve essere un target di assegnazione valido; una variabile non dichiarata non può essere inizializzata in questo modo.

L’operatore fa parte di ECMAScript 2021. È sintassi del linguaggio, non una Web API. Per la distribuzione, verifica il supporto della sintassi nei motori di destinazione oppure trasforma il codice; la presenza di Node 24 in un repository non dimostra il supporto nei browser.

Esempi

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

Risultato

Guest
admin
1
10

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti