CKTIS / JavaScript
Affectation OU logique (||=)
L’opérateur ||= affecte la valeur de droite uniquement lorsque la valeur actuelle de la cible est falsy. Il évalue les expressions de façon conditionnelle et n’évalue la référence de la cible qu’une seule fois.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
target ||= expressiontarget ||= expression lit la valeur de la cible et la teste avec ToBoolean. Si elle est truthy, l’opérateur la renvoie sans évaluer expression ni effectuer d’affectation. Sinon, il évalue l’expression de droite, affecte sa valeur et la renvoie ; le résultat n’a pas nécessairement le type boolean.
Les valeurs falsy comprennent false, 0, -0, 0n, "", NaN, null et undefined. Par conséquent, ||= peut écraser un zéro valide ou une chaîne vide. Utilisez ??= lorsque seuls null et undefined doivent signifier qu’une valeur manque. L’opérateur |= effectue un OU bit à bit et ne remplace pas ||=.
La référence de la cible n’est évaluée qu’une seule fois. obj[key()] ||= value appelle key() une fois, contrairement à la réécriture naïve obj[key()] = obj[key()] || value. Un getter peut être exécuté lors de la lecture, mais le setter est ignoré si la valeur lue est truthy. La cible doit être une cible d’affectation valide ; une variable non déclarée ne peut pas être initialisée de cette manière.
Cet opérateur fait partie d’ECMAScript 2021. Il s’agit de syntaxe du langage, et non d’une Web API. Pour le déploiement, vérifiez la prise en charge de cette syntaxe par les moteurs visés ou transformez le code ; la présence de Node 24 dans un dépôt ne prouve pas la prise en charge par les navigateurs.
Exemples
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);Résultat
Guest admin 1 10
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.