La propriété globaleundefined représente la valeur primitiveundefined. Cette valeur est l'un des types primitifs de JavaScript.

Exemple interactif

function test(t) {  if (t === undefined) {    return "Undefined value!";  }  return t;}let x;console.log(test(x));// Expected output: "Undefined value!"

Syntaxe

undefined;

Description

undefined est une propriété del'objet global, c'est-à-dire qu'elle est accessible globalement. La valeur initiale d'undefined est la valeur primitiveundefined.

Dans les navigateurs modernes (JavaScript 1.8.5 / Firefox 4+), d'après la spécification ECMAScript 5,undefined est une propriété non-configurable et non accessible en écriture. Si, toutefois, elle peut être modifiée dans l'environnement utilisé, il faut éviter de l'écraser.

Une variable pour laquelle aucune valeur n'a été assignée sera de typeundefined. Une méthode ou instruction renvoie égalementundefined si la variable à évaluer n'a pas de valeur assignée. Une fonction renvoieundefined si aucune valeur n'a étérenvoyée.

// À NE PAS FAIRE// affiche "toto string" dans la console(function () {  const undefined = "toto";  console.log(undefined, typeof undefined);})();// affiche "toto string" dans la console(function (undefined) {  console.log(undefined, typeof undefined);})("toto");

Exemples

L'égalité stricte etundefined

Il est possible d'utiliserundefined et les opérateurs stricts pour l'égalité et l'inégalité strictes afin de déterminer si une variable a une valeur affectée. Dans le code qui suit, la variablex n'est pas initialisée et la première instructionif sera évaluée àtrue (vrai).

let x;if (x === undefined) {  // ces instructions seront exécutées} else {  // ces instructions ne seront pas exécutées}

L'opérateurtypeof etundefined

L'opérateurtypeof peut également être utilisé :

let x;if (typeof x === "undefined") {  // ces instructions seront exécutées}

Une des raisons pour utiliser l'opérateurtypeof est qu'il ne renverra pas d'erreur si la variable n'a pas été définie :

// x n'a pas encore été définiif (typeof x === "undefined") {  // donnera true sans erreur  // ces instructions seront exécutées}if (x === undefined) {  // déclenche une ReferenceError}

Il existe toutefois une autre alternative. Puisque JavaScript utilise la portée statique, on saura qu'une variable a été déclarée si elle est définie dans un contexte englobant.

La portée globale est rattachée àl'objet global, alors on peut vérifier l'existence d'une variable dans le contexte global en examinant la présence d'une propriété surl'objet global via l'opérateurin. Par exemple :

if ("x" in window) {  // ces instructions seront exécutées uniquement  // si x est défini dans la portée globale}

L'opérateurvoid etundefined

L'opérateurvoid est une troisième solution.

let x;if (x === void 0) {  // ces instructions seront exécutées}// y n'a pas été défini avantif (y === void 0) {  // déclenche une Uncaught ReferenceError: y is not defined}

Spécifications

Compatibilité des navigateurs

Voir aussi

• Lesvaleurs primitives de JavaScript
• null