ExpertiDict

JavaScript · Essencial · Inglês · Técnico

undefined

/ˌʌndɪˈfaɪnd/valor primitivo

Valor primitivo atribuído a variáveis não inicializadas, propriedades inexistentes e parâmetros omitidos. Indica ausência de valor por padrão, ao contrário de null, que é intencional.

Onde usar

Aparece quando você lê uma propriedade que não existe ou chama uma função sem argumento. Em code review, a regra comum é nunca atribuir undefined de propósito e usar null para vazio intencional.

Em código

let a;
const o = {};
console.log(a);        // undefined
console.log(o.x);      // undefined
console.log(typeof y); // 'undefined'

Exemplos

The property doesn't exist, so you get undefined.

A propriedade não existe, então você recebe undefined.

Don't assign undefined on purpose; use null instead.

Não atribua undefined de propósito; use null.

Cuidado

Confundir com variável não declarada: ler um nome que nunca foi declarado lança ReferenceError, não devolve undefined.

Antônimos

null

Veja também

Todos os termos de JavaScript