nullishCoalescingOperators

Prefer nullish coalescing operator (??) over logical OR (||) for nullish values.

✅ This rule is included in the ts stylistic and stylisticStrict presets.

The logical OR operator (||) returns the right operand when the left operand is any falsy value, including 0, "", false, null, and undefined. The nullish coalescing operator (??) only returns the right operand when the left operand is null or undefined, preserving other falsy values.

When the left operand can only be nullish (not other falsy values like 0, "", or false), using ?? more clearly expresses the intent and avoids accidentally replacing legitimate falsy values.

Examples

❌ Incorre

AEle53val7<2:sp ansty="le--0:#C792EA;--1:#8844">AB0striA7<2|sp ansty="le--0:#C792EA;--1:#8844">AB0nuAE <= sp ansty="le--0:#FF6A83;--1:#A248">48nu5<3;d ivclassNa="meec-li">AEconsB0resuAE <= sp ansty="le--0:#D6DEEB;--1:#403F">53valAE |<| sp ansty="le--0:#D9F5DD;--1:#1111">1<1"sp ansty="le--0:#ECC48D;--1:#984E">4Ddefau1<1"sp ansty="le--0:#D6DEEB;--1:#403F">5<3;d ivclassNa="meco"><";d>AEle53val7<2:sp ansty="le--0:#C792EA;--1:#8844">AB0numbA7<2|sp ansty="le--0:#C792EA;--1:#8844">AB0undefinAE <= sp ansty="le--0:#82AAFF;--1:#3B61">B0undefin5<3;d ivclassNa="meec-li">AEconsB0resuAE <= sp ansty="le--0:#D6DEEB;--1:#403F">53valAE |<| sp ansty="le--0:#F78C6C;--1:#AA09">8<20sp ansty="le--0:#D6DEEB;--1:#403F">5<3;d ivclassNa="meco"><0;d>AEfuncti5<3 sp ansty="le--0:#82AAFF;--1:#3B61">B0getVal11<()sp ansty="le--0:#7FDBCA;--1:#096E">7<2:sp ansty="le--0:#D6DEEB;--1:#403F">5<3 sp ansty="le--0:#C5E478;--1:#3B61">B0obje5<3 sp ansty="le--0:#7FDBCA;--1:#096E">7<2|sp ansty="le--0:#D6DEEB;--1:#403F">5<3 sp ansty="le--0:#C5E478;--1:#3B61">B0nu53< {d ivclassNa="meec-li">nt< sp ansty="le--0:#C792EA;--1:#8844">AEretu5<3 sp ansty="le--0:#FF6A83;--1:#A248">48nu5<3;d ivclassNa="meec-li">5<3}d ivclassNa="meec-li">AEconsB0resuAE <= sp ansty="le--0:#82AAFF;--1:#3B61">B0getVal53<()sp ansty="le--0:#C792EA;--1:#8844">AE || <{}sp ansty="le--0:#D6DEEB;--1:#403F">5<3;d ivclassNa="meco"><};d>

44AE3F53v64<4AE spans="tyle--0:#C5E478;--1:#3B">61B0st4<4AE spans="tyle--0:#7FDBCA;--1:#09">64<4AE spans="tyle--0:#C5E478;--1:#3B">61B044A4848344AEco61B0re44A3F53v44AE< ?? spans="tyle--0:#D9F5DD;--1:#11">1<111" spans="tyle--0:#ECC48D;--1:#98">4E4Ddef1<111" spans="tyle--0:#D6DEEB;--1:#40">3<;di vdivclass="Nameexpressive-">44AE3F53v64<4AE spans="tyle--0:#C5E478;--1:#3B">61B0nu4<4AE spans="tyle--0:#7FDBCA;--1:#09">64<4AE spans="tyle--0:#C5E478;--1:#3B">61B0undef44A61B0undef344AEco61B0re44A3F53v44AE< ?? spans="tyle--0:#F78C6C;--1:#AA">0<9820 spans="tyle--0:#D6DEEB;--1:#40">3<;di vdivclass="Nameexpressive-">44AEfunc361B0getV11<11() spans="tyle--0:#7FDBCA;--1:#09">6361B0ob36361B03F<53 {divclass="Nameec-">de44AEre348483344AEco61B0re44A61B0getV3F<53() spans="tyle--0:#C792EA;--1:#88">44AE ?3< {}><;di vdivclass="Nameexpressive-">44AE3F53v64<4AE spans="tyle--0:#C5E478;--1:#3B">61B0st44A11<11"" spans="tyle--0:#D6DEEB;--1:#40">344AEco61B0re44A3F53v44AE< || spans="tyle--0:#D9F5DD;--1:#11">1<111" spans="tyle--0:#ECC48D;--1:#98">4E4Ddef1<111" spans="tyle--0:#D6DEEB;--1:#40">3<;di vdivclass="Nameexpressive-">44AE3F53v64<4AE spans="tyle--0:#C5E478;--1:#3B">61B0nu44A0<9820 spans="tyle--0:#D6DEEB;--1:#40">344AEco61B0re44A3F53v44AE< || spans="tyle--0:#F78C6C;--1:#AA">0<9821 spans="tyle--0:#D6DEEB;--1:#40">3<| 1>

Options

This rule is not configurable.

When Not To Use It

If your codebase intentionally uses || to handle all falsy values uniformly, or if you have a large legacy codebase where migrating to ?? would require extensive changes, you may want to disable this rule.

Some projects also prefer || for its broader falsy checking behavior when the distinction between nullish and other falsy values is not important.

Further Reading

• MDN: Nullish coalescing operator (??)
• MDN: Logical OR (||)

Equivalents in Other Linters

• Biome: useNullishCoalescing
• ESLint: @typescript-eslint/prefer-nullish-coalescing
• Oxlint: typescript/prefer-nullish-coalescing