undefined em JavaScript: 5 maneiras de verificar (e qual escolher)

«Uncaught ReferenceError» — seu primeiro inimigo? Aprendendo a verificar corretamente undefined em JavaScript

Todo mundo que escreveu pelo menos algumas linhas em JavaScript já encontrou o misterioso undefined. Não é apenas um "espaço vazio" — é um tipo de dado completo com seu próprio valor. Mas como capturá-lo corretamente? Se você pesquisou "How can I check for undefined in JavaScript", não está sozinho: esta pergunta no Stack Overflow tem centenas de milhares de visualizações. O problema é que em JS existem várias maneiras de verificar, e cada uma tem suas armadilhas.

Neste artigo, vamos analisar 5 abordagens, do simples ao complexo, comparar seu desempenho e confiabilidade, e descobrir qual método usar em 2025. Vamos lá!

O que é undefined na verdade?

Antes de verificar, vamos definir os termos. undefined é um valor primitivo que é atribuído a uma variável se ela foi declarada, mas não inicializada:

let a;\nconsole.log(a); // undefined\n

Importante: undefined ≠ null ≠ not defined. null é um "nada" intencional, enquanto not defined (ReferenceError) ocorre quando a variável nem foi declarada. Essas nuances são críticas para escolher a verificação correta.

Método nº1: Operador typeof — o padrão ouro?

A maneira mais popular e segura é usar typeof:

if (typeof x === 'undefined') {\n  console.log('x não está definido');\n}\n

Por que isso funciona mesmo para variáveis não declaradas? typeof nunca lança um ReferenceError. Se a variável não existe, ele simplesmente retorna a string "undefined".

Prós:

\n
• Seguro para variáveis não declaradas
\n
• Código legível e compreensível
\n
• Funciona em todos os navegadores e ambientes (Node.js, Deno)
\n

Contras:

\n
• Um pouco longo para uso frequente
\n
• Pode enganar iniciantes (comparação de strings)
\n

Veredito: Melhor escolha para verificações globais e casos onde a variável pode não estar declarada.

Método nº2: Comparação estrita com undefined (===)

A segunda maneira mais popular é comparar o valor diretamente:

if (x === undefined) {\n  console.log('x é igual a undefined');\n}\n

Aqui há uma nuance: a variável deve estar declarada. Se x não existir, você receberá um ReferenceError. Portanto, esse código é seguro apenas para:

\n
• Propriedades de objetos (obj.prop === undefined)
\n
• Parâmetros de funções
\n
• Variáveis declaradas com let, const ou var
\n

Armadilha: undefined global

Em navegadores antigos (IE 8 e anteriores), undefined podia ser sobrescrito:

undefined = 'agora sou uma string'; // Pesadelo!\n

Isso não é mais possível (no modo estrito), mas se você suporta código legado — é melhor usar typeof.

Veredito: Excelente método para variáveis locais e propriedades de objetos. Rápido e conciso.

Método nº3: Operador void

Uma maneira pouco conhecida, mas elegante, é void 0:

if (x === void 0) {\n  console.log('x undefined');\n}\n

O operador void avalia uma expressão e retorna undefined. void 0 é a maneira mais curta de obter um undefined puro, independente da variável global.

Quando é útil?

\n
• Em código minificado (economiza bytes)
\n
• Em bibliotecas onde a proteção contra sobrescrita de undefined é importante
\n
• Em programação funcional (por exemplo, em cadeias de promises)
\n

Contra: Parece estranho