Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

typeof: verificar a categoria de um valor

typeof devolve uma cadeia que descreve a categoria de um valor JavaScript. Ajuda a identificar tipos primitivos, mas não distingue todas as espécies de objetos.

Versão: ECMAScript 2020+

Sintaxe

typeof expression

Os resultados incluem cadeias como "number", "string", "boolean", "undefined", "bigint", "symbol", "function" e "object". Compara essas cadeias explicitamente, por exemplo com typeof value === "string". NaN continua a ter o tipo number: o tipo não prova que um valor seja adequado para um cálculo.

Por razões históricas, typeof null devolve "object". Os arrays também devolvem "object"; usa Array.isArray para os identificar. Para rejeitar um valor ausente, verifica value !== null em vez de depender apenas de typeof.

typeof missingName pode devolver "undefined" para um nome não declarado. Isto não significa que o operador nunca lance erros: aceder a uma variável let ou const na sua zona morta temporal lança um ReferenceError. Ler uma propriedade inexistente também exige um objeto de base válido.

O operador não altera o valor. Os parênteses esclarecem a expressão analisada: typeof (1 + "2") verifica o resultado da adição, não apenas o número 1.

Exemplos

console.log(typeof 5, typeof "5", typeof NaN);
console.log(typeof null, typeof []);
console.log(Array.isArray([]));
console.log(typeof (1 + "2"));

Resultado

number string number
object object
true
string
try {
  console.log(typeof value);
  let value = 3;
} catch (error) {
  console.log(error.name);
}

Resultado

ReferenceError

Fontes