unknown

Onde usar

Recomendado para dados externos, como o valor capturado em um catch ou o corpo de uma requisição. Obriga a validar antes de usar, o que fecha a porta que o any deixa aberta.

Em código

function tamanho(v: unknown): number {
  if (typeof v === 'string') return v.length;
  if (Array.isArray(v)) return v.length;
  return 0;
}
tamanho('abc');
tamanho(null);

Exemplos

Parse the body as unknown and validate it before using it.

Trate o corpo como unknown e valide antes de usar.

You can't call methods on unknown until you narrow it.

Você não pode chamar métodos em unknown até estreitá-lo.

Cuidado

Não é um any com outro nome: com unknown, acessar propriedade ou chamar método é erro de compilação até haver narrowing.

Sinônimos

top type seguro

Antônimos

never