Nullish Coalescing in JavaScript: guida all'operatore ?? con esempi di utilizzo

Scopri come funziona il Nullish Coalescing in JavaScript (??), le differenze con l'operatore OR (||), gli esempi pratici e l'utilizzo con Optional Chaining. 
Che cos'è il Nullish Coalescing Operator
Il Nullish Coalescing Operator, introdotto con ECMAScript 2020 (ES11), è un operatore logico che consente di specificare un valore alternativo quando un'espressione restituisce null oppure undefined.
La sua sintassi è particolarmente semplice:
const risultato = valore ?? valorePredefinito;
Il comportamento è il seguente:
- Se
valoreè diverso danulleundefined, viene restituito il valore originale. - Se
valoreènulloppureundefined, viene restituitovalorePredefinito.
A differenza di altri operatori JavaScript, il nullish coalescing non valuta la cosiddetta falsiness di un valore, ma verifica esclusivamente che non sia nullo o non definito.
Nullish Coalescing vs Logical OR: quali sono le differenze?
Per comprendere realmente l'utilità dell'operatore ??, è importante confrontarlo con l'operatore OR (||), spesso utilizzato per assegnare valori predefiniti.
Consideriamo questo esempio:
const numeroElementi = 0;
const risultatoOr = numeroElementi || 10;
const risultatoNullish = numeroElementi ?? 10;
console.log(risultatoOr); // 10
console.log(risultatoNullish); // 0
La differenza è evidente: l'operatore OR considera 0 un valore falsy e restituisce quindi il valore alternativo. L'operatore nullish coalescing, invece, riconosce che 0 è un valore valido e lo mantiene.
Lo stesso comportamento si verifica con altri valori falsy di JavaScript:
const valori = [
false,
0,
"",
null,
undefined,
NaN
];
for (const valore of valori) {
console.log(valore || "default");
console.log(valore ?? "default");
}
La tabella seguente riassume le differenze:
| Valore | Operatore || | Operatore ?? |
|---|---|---|
false | "default" | false |
0 | "default" | 0 |
"" | "default" | "" |
null | "default" | "default" |
undefined | "default" | "default" |
NaN | "default" | NaN |
La scelta tra i due operatori dipende quindi dalla logica applicativa: utilizza || quando vuoi considerare tutti i valori falsy come assenti, mentre preferisci ?? quando vuoi intervenire esclusivamente in presenza di null o undefined.
Utilizzare il Nullish Coalescing per definire valori predefiniti
Uno degli scenari più comuni è la definizione di valori predefiniti per variabili, configurazioni e parametri provenienti da fonti esterne.
Immaginiamo di dover leggere il numero di risultati da mostrare in una pagina, recuperandolo da un oggetto di configurazione:
const config = {
pageSize: 0
};
const pageSize = config.pageSize ?? 20;
console.log(pageSize); // 0
In questo caso, il valore 0 viene mantenuto. Potrebbe rappresentare una scelta esplicita dell'applicazione, ad esempio la volontà di non mostrare alcun risultato.
Con l'operatore OR, invece, il risultato sarebbe stato 20, sovrascrivendo involontariamente la configurazione originale.
Lo stesso approccio è utile quando si lavora con dati provenienti da API:
function formatUser(user) {
return {
name: user.name ?? "Utente anonimo",
active: user.active ?? false,
notifications: user.notifications ?? 0
};
}
In questo modo vengono gestiti i valori mancanti senza alterare quelli validi, anche quando questi ultimi corrispondono a false, 0 o a una stringa vuota.
Nullish Coalescing e Optional Chaining
L'operatore nullish coalescing viene spesso utilizzato insieme all'Optional Chaining (?.), introdotto anch'esso in ECMAScript 2020.
Questa combinazione è particolarmente utile quando si accede a proprietà annidate che potrebbero non essere presenti.
Consideriamo un oggetto utente che contiene informazioni di contatto:
const user = {
name: "Mario",
contact: null
};
const email = user.contact?.email ?? "Email non disponibile";
console.log(email); // Email non disponibile
L'Optional Chaining interrompe l'accesso alla proprietà quando incontra un valore null o undefined, evitando un errore di esecuzione. Il Nullish Coalescing permette invece di fornire un valore alternativo.
I due operatori svolgono quindi funzioni complementari:
?.permette di accedere in sicurezza a proprietà o metodi potenzialmente assenti.??permette di sostituire un risultato nullo o non definito con un valore alternativo.
La combinazione dei due operatori consente di scrivere codice più leggibile, riducendo la necessità di controlli condizionali ripetitivi.
Nullish Coalescing Assignment: l'operatore ??=
JavaScript mette a disposizione anche una variante dell'operatore nullish coalescing: il Nullish Coalescing Assignment, identificato dalla sintassi ??=.
Questo operatore consente di assegnare un valore a una variabile o a una proprietà solamente quando il valore corrente è null oppure undefined.
Vediamo un esempio:
let configurazione = {
timeout: null,
retries: 0
};
configurazione.timeout ??= 5000;
configurazione.retries ??= 3;
console.log(configurazione);
// {
// timeout: 5000,
// retries: 0
// }
La proprietà timeout viene inizializzata perché contiene null, mentre retries mantiene il valore 0.
L'operatore ??= è sostanzialmente equivalente alla seguente espressione:
if (configurazione.timeout === null ||
configurazione.timeout === undefined) {
configurazione.timeout = 5000;
}
È importante ricordare che l'assegnazione non avviene quando il valore esistente è già definito, anche se si tratta di un valore falsy.
Limitazioni sintattiche e precedenza degli operatori
Il nullish coalescing presenta una particolarità sintattica da conoscere: non è possibile combinarlo direttamente con gli operatori AND (&&) e OR (||) senza utilizzare le parentesi.
Ad esempio, questa espressione genera un SyntaxError:
// Sintassi non valida
const risultato = valore ?? valoreAlternativo || altroValore;
Per rendere esplicito l'ordine di valutazione, è necessario utilizzare le parentesi:
// Sintassi valida
const risultato = (valore ?? valoreAlternativo) || altroValore;
// Oppure
const risultato = valore ?? (valoreAlternativo || altroValore);
Le due espressioni non sono equivalenti: le parentesi determinano quale operatore viene valutato per primo e, di conseguenza, il comportamento dell'intera espressione.
Questa restrizione è stata introdotta per evitare ambiguità nella lettura del codice e rendere più esplicita l'intenzione dello sviluppatore.
Compatibilità con i browser
Il Nullish Coalescing Operator è una funzionalità standardizzata con ECMAScript 2020 ed è supportato dalle versioni moderne dei principali browser.
Non rappresenta quindi un problema per i progetti che possono fare affidamento su browser aggiornati. Tuttavia, se l'applicazione deve supportare ambienti legacy o runtime JavaScript meno recenti, è opportuno verificare preventivamente la compatibilità.
Per i progetti che utilizzano strumenti di compilazione come Babel, è possibile trasformare la sintassi moderna in codice compatibile con ambienti meno recenti, configurando opportunamente il target di compilazione.
Per verificare il supporto aggiornato è possibile consultare Can I Use - Nullish Coalescing e la documentazione ufficiale di MDN Web Docs.
Best practice: quando utilizzare il Nullish Coalescing
Il nullish coalescing è uno strumento semplice, ma può contribuire sensibilmente alla qualità del codice JavaScript quando viene utilizzato nei contesti appropriati.
Ecco alcune indicazioni pratiche:
- Preferisci
??per i valori predefiniti: quando0,falsee""rappresentano valori validi, evita di utilizzare||per assegnare un fallback. - Utilizzalo con dati esterni: quando elabori risposte API, configurazioni o oggetti provenienti da altre componenti dell'applicazione, può aiutarti a gestire proprietà mancanti.
- Combinalo con Optional Chaining: la combinazione di
?.e??è particolarmente efficace nella gestione di strutture dati annidate. - Evita fallback indiscriminati: un valore
nullpotrebbe avere un significato specifico nella logica applicativa. Prima di sostituirlo, verifica sempre che il comportamento sia quello desiderato. - Non confondere assenza e invalidità:
??non verifica che un valore sia corretto o utilizzabile. Ad esempio,NaNe una stringa vuota vengono considerati valori presenti.
La scelta dell'operatore deve sempre derivare dalla semantica dei dati e non soltanto dalla volontà di ridurre il numero di righe di codice.
Link utili per approfondire
Per approfondire il funzionamento degli operatori nullish coalescing e le funzionalità correlate di JavaScript, puoi consultare queste risorse:
- MDN - Nullish Coalescing Operator (??): documentazione tecnica, sintassi ed esempi.
- MDN - Nullish Coalescing Assignment (??=): approfondimento sull'operatore di assegnazione.
- MDN - Optional Chaining (?.): documentazione sull'accesso sicuro alle proprietà.
- ECMAScript Language Specification: specifica ufficiale del linguaggio JavaScript.
- Can I Use - Nullish Coalescing: panoramica della compatibilità con i browser.
Conclusioni
L'operatore nullish coalescing rappresenta una soluzione efficace per gestire i valori mancanti in JavaScript, permettendo di distinguere chiaramente tra un valore assente e un valore semplicemente falsy.
Rispetto all'operatore OR, ?? interviene esclusivamente quando il risultato è null o undefined, preservando valori come 0, false e stringhe vuote.
La possibilità di combinarlo con Optional Chaining e di utilizzare la variante di assegnazione ??= lo rende particolarmente utile nella gestione di configurazioni, dati provenienti da API e strutture JavaScript complesse.
Conoscere le differenze tra questi operatori permette di scrivere codice più prevedibile, leggibile e coerente con le intenzioni dell'applicazione. Una piccola funzionalità sintattica che, utilizzata correttamente, può evitare errori logici difficili da individuare.
