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

const a = 3;const b = -2;console.log(a > 0 || b > 0);// Expected output: true

Syntaxe

expr1 || expr2;

Description

Siexpr1 peut être converti entrue, c'estexpr1 qui sera renvoyé, sinon ce seraexpr2.

Si une valeur peut être convertie entrue, elle peut être qualifiée detruthy. Si une valeur peut être convertie enfalse, on la qualifiera alors defalsy.

Parmi les expressions qui peuvent être converties enfalse, 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 enune 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 doubleopérateur NON (!) ou le constructeurBoolean().

É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 partieexpr ci-avantn'est pas évaluée, tout effet de bord lié à cette évaluation n'aura pas lieu (par exemple, siexpr 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 :

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|| (voirl'article sur la précédence des opérateurs).

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||.

o1 = true || true; // t || t renvoie trueo2 = false || true; // f || t renvoie trueo3 = true || false; // t || f renvoie trueo4 = false || 3 == 4; // f || f renvoie falseo5 = "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 falseo9 = false || ""; // f || f renvoie ""o10 = false || varObject; // f || object renvoie varObject

Règles de conversion booléennes

Convertir ET en OU

L'opération suivante, utilisant desbooléens :

bCondition1 && bCondition2;

sera toujours équivalente à :

!(!bCondition1 || !bCondition2);

Convertir OU en ET

L'opération suivante, utilisant desbooléens :

bCondition1 || bCondition2;

sera toujours équivalente à :

!(!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 desbooléens :

bCondition1 && (bCondition2 || bCondition3);

sera toujours équivalente à :

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

Spécifications

Compatibilité des navigateurs

Voir aussi

• L'opérateur de coalescence des nuls (??)
• Boolean
• Truthy
• Falsy