OU logique (||)

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

L'opérateur OU logique (||) (disjonction logique) renvoie vrai si et seulement si au moins un de ses opérandes est vrai. Cet opérateur est généralement utilisé avec des valeurs booléennes et, lorsque c'est le cas, il renvoie une valeur booléenne. Toutefois, || peut aussi être utilisé avec des valeurs non-booléennes et, dans ce cas, renverra une valeur non-booléenne.

Exemple interactif

Syntaxe

js
expr1 || expr2;

Description

Si expr1 peut être converti en true, c'est expr1 qui sera renvoyé, sinon ce sera expr2.

Si une valeur peut être convertie en true, elle peut être qualifiée de truthy. Si une valeur peut être convertie en false, on la qualifiera alors de falsy.

Parmi les expressions qui peuvent être converties en false, on a :

  • null ;
  • NaN ;
  • 0 ;
  • la chaîne de caractères vide ("" ou '' ou ``) ;
  • undefined.

Bien que l'opérateur || puisse être utilisé avec des opérandes qui ne soient pas des valeurs booléennes, il reste un opérateur booléen, car sa valeur de retour peut toujours être convertie en une valeur primitive booléenne. Pour convertir explicitement la valeur de retour (ou tout expression de façon plus générale) dans sa valeur booléenne correspondante, on pourra utiliser un double opérateur NON (!) ou le constructeur Boolean().

Évaluation en court-circuit

L'expression utilisant un OU logique est évaluée de gauche à droite. Le moteur cherche s'il est possible d'utiliser un court-circuit de la façon suivante :

(une expression équivalente à vrai) || expr sera court-circuité pour fournir directement le résultat de l'expression équivalente à vrai.

Cette notion de court-circuit indique que la partie expr ci-avant n'est pas évaluée, tout effet de bord lié à cette évaluation n'aura pas lieu (par exemple, si expr est un appel de fonction, la fonction n'est pas appelée). Ce fonctionnement a lieu, car la valeur du résultat peut d'office être déterminée par l'évaluation du premier opérande. Par exemple :

js
function A() {
  console.log("A a été appelée");
  return false;
}

function B() {
  console.log("B a été appelée");
  return true;
}

console.log(B() || A());
// affichera "B a été appelée" dans la console via l'appel de la fonction
// puis affichera true (la valeur du résultat de l'expression avec l'opérateur)
// on voit que la fonction A n'est pas du tout appelée

Précédence des opérateurs

Les expressions suivantes peuvent sembler équivalentes mais ne le sont pas. En effet, l'opérateur && est exécuté avant l'opérateur || (voir l'article sur la précédence des opérateurs).

js
true || false && false; // renvoie true, car && est exécuté en premier
(true || false) && false; // renvoie false, car la précédence par défaut ne s'applique pas avec les parenthèses

Exemples

Utiliser le OU logique

Le code suivant illustre quelques usages de l'opérateur OU logique ||.

js
o1 = true || true; // t || t renvoie true
o2 = false || true; // f || t renvoie true
o3 = true || false; // t || f renvoie true
o4 = false || 3 == 4; // f || f renvoie false
o5 = "Chat" || "Chien"; // t || t renvoie "Chat"
o6 = false || "Chat"; // f || t renvoie "Chat"
o7 = "Chat" || false; // t || f renvoie "Chat"
o8 = "" || false; // f || f renvoie false
o9 = false || ""; // f || f renvoie ""
o10 = false || varObject; // f || object renvoie varObject

Note : Si vous utilisez cet opérateur afin de fournir une valeur par défaut à une variable. Soyez conscient⋅e qu'une valeur équivalente à false ne pourra pas être utilisée ainsi. Si vous souhaitez uniquement écarter null ou undefined, privilégiez l'utilisation de l'opérateur de coalescence des nuls.

Règles de conversion booléennes

Convertir ET en OU

L'opération suivante, utilisant des booléens :

js
bCondition1 && bCondition2;

sera toujours équivalente à :

js
!(!bCondition1 || !bCondition2);

Convertir OU en ET

L'opération suivante, utilisant des booléens :

js
bCondition1 || bCondition2;

sera toujours équivalente à :

js
!(!bCondition1 && !bCondition2);

Retrait des parenthèses imbriquées

Les expressions logiques sont évaluées de gauche à droite, il est donc possible de retirer les parenthèses d'une expression complexe en suivant quelques règles.

L'opération composite suivante, utilisant des booléens :

js
bCondition1 && (bCondition2 || bCondition3);

sera toujours équivalente à :

js
!(!bCondition1 || (!bCondition2 && !bCondition3));

Spécifications

Specification
ECMAScript Language Specification
# prod-LogicalORExpression

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi