undefined

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 proprit de l'objet global, c'est--dire qu'elle est accessible globalement. La valeur initiale d'undefined est la valeur primitive undefined.

Dans les navigateurs modernes (JavaScript 1.8.5 / Firefox 4+), d'aprs la spcification ECMAScript 5, undefined est une proprit non-configurable et non accessible en criture. Si, toutefois, elle peut tre modifie dans l'environnement utilis, il faut viter de l'craser.

Une variable pour laquelle aucune valeur n'a t assigne sera de type undefined. Une mthode ou instruction renvoie galement undefined si la variable valuer n'a pas de valeur assigne. Une fonction renvoie undefined si aucune valeur n'a t renvoye.

//  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 et undefined

Il est possible d'utiliser undefined et les oprateurs stricts pour l'galit et l'ingalit strictes afin de dterminer si une variable a une valeur affecte. Dans le code qui suit, la variable x n'est pas initialise et la premire instruction if sera value true (vrai).

let x;
if (x === undefined) {
  // ces instructions seront excutes
} else {
  // ces instructions ne seront pas excutes
}

L'oprateur typeof et undefined

L'oprateur typeof peut galement tre utilis :

let x;
if (typeof x === "undefined") {
  // ces instructions seront excutes
}

Une des raisons pour utiliser l'oprateur typeof est qu'il ne renverra pas d'erreur si la variable n'a pas t dfinie :

// x n'a pas encore t dfini
if (typeof x === "undefined") {
  // donnera true sans erreur
  // ces instructions seront excutes
}

if (x === undefined) {
  // dclenche une ReferenceError
}

Il existe toutefois une autre alternative. Puisque JavaScript utilise la porte statique, on saura qu'une variable a t dclare si elle est dfinie dans un contexte englobant.

La porte globale est rattache l'objet global, alors on peut vrifier l'existence d'une variable dans le contexte global en examinant la prsence d'une proprit sur l'objet global via l'oprateur in. Par exemple :

if ("x" in window) {
  // ces instructions seront excutes uniquement
  // si x est dfini dans la porte globale
}

L'oprateur void et undefined

L'oprateur void est une troisime solution.

let x;
if (x === void 0) {
  // ces instructions seront excutes
}

// y n'a pas t dfini avant
if (y === void 0) {
  // dclenche une Uncaught ReferenceError: y is not defined
}

Spcifications

Compatibilit des navigateurs

Voir aussi

• Les valeurs primitives de JavaScript
• null