0Pricing
TypeScript Academy · Aula

typeof e restrição por veracidade

Utilize verificações com typeof para restringir tipos primitivos

typeof e restrição por veracidade é uma aula grátis de TypeScript Academy no CoddyKit. Esta é a aula 1 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de TypeScript Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de TypeScript Academy inclui 4 aulas no total.

Boas-vindas

TypeScript refina os tipos de união dentro de blocos condicionais. As verificações com `typeof` e de veracidade são as técnicas de refinamento mais comuns.

Refinamento com typeof

Use `typeof` para verificar tipos primitivos. TypeScript entende as verificações com typeof e refina o tipo dentro do bloco.
function process(val: string | number) {
  if (typeof val === 'string') {
    return val.toUpperCase(); // val: string
  }
  return val.toFixed(2); // val: number
}

Valores retornados por typeof

typeof retorna 'string', 'number', 'boolean', 'bigint', 'symbol', 'undefined', 'object' ou 'function'. Observação: typeof null === 'object' — uma peculiaridade de JavaScript.
typeof 'hello'    // 'string'
typeof 42         // 'number'
typeof true       // 'boolean'
typeof null       // 'object' (quirk!)
typeof undefined  // 'undefined'

Refinamento por veracidade

Os valores de JavaScript podem ser verdadeiros ou falsos. TypeScript refina `T | null | undefined` para `T` dentro de uma verificação de veracidade.
function greet(name: string | null) {
  if (name) {
    console.log('Hello, ' + name); // name: string
  } else {
    console.log('Hello, stranger');
  }
}

Valores falsos

Valores falsos em JavaScript: false, 0, '', null, undefined, 0n e NaN. O refinamento por veracidade remove esses valores do tipo quando a verificação é satisfeita.

Refinamento com coerção booleana

Usar `Boolean(val)` ou `!!val` também remove null e undefined por meio do refinamento.
const items: (string | null)[] = ['a', null, 'b', null];
const strings = items.filter((x): x is string => x !== null);

Condições negadas

TypeScript também refina os tipos nos blocos else e depois de retornos antecipados.
function getLength(val: string | null): number {
  if (!val) return 0; // early return narrows
  return val.length;  // val: string here
}

Combinação de typeof com igualdade

A igualdade estrita (===) combinada com typeof produz um refinamento preciso.
function accept(x: string | number | boolean) {
  if (typeof x === 'string' || typeof x === 'number') {
    console.log(x); // x: string | number
  }
}

typeof não pode refinar para null

Para refinar null, use a igualdade estrita `=== null`. A veracidade não consegue distinguir null de outros valores falsos.
function check(x: string | null | 0) {
  if (x === null) { /* x: null */ }
  else if (x === 0) { /* x: 0 */ }
  else { /* x: string */ }
}

Refinamento em laços

TypeScript também aplica o refinamento dentro dos corpos de laços, não apenas em instruções if.

Análise do fluxo de controle

TypeScript acompanha o tipo em cada ponto do seu código usando a análise do fluxo de controle. As atribuições também atualizam o tipo.
let x: string | number = 'hello';
// x: string
x = 42;
// x: number

Verificação rápida

Dentro de `if (typeof val === 'string')`, qual é o tipo de `val`, considerando que originalmente era `string | number`?

Recapitulação

As verificações com typeof e as condições de veracidade refinam os tipos de união em TypeScript. TypeScript usa a análise do fluxo de controle para acompanhar os tipos em cada ponto. Use a igualdade estrita para verificar null e undefined.

Perguntas Frequentes

A aula “typeof e restrição por veracidade” é grátis?

Sim — o texto completo de “typeof e restrição por veracidade” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de TypeScript Academy, atualize para CoddyKit PRO. O curso de TypeScript Academy inclui 4 aulas no total.

O que vou aprender em “typeof e restrição por veracidade”?

Utilize verificações com typeof para restringir tipos primitivos Você pratica TypeScript Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.

Preciso ter experiência prévia para começar TypeScript Academy?

Nenhuma experiência prévia é necessária. TypeScript Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 1 de 4.

Quanto tempo leva a aula “typeof e restrição por veracidade”?

A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.

Posso escrever e executar código nesta aula de TypeScript Academy?

Sim. Cada aula de TypeScript Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.

Todas as aulas deste curso

  1. typeof e restrição por veracidade
  2. instanceof e in na restrição de tipos
  3. Funções de guarda de tipos definidas pelo usuário
  4. Verificação de exaustividade com never
← Voltar para TypeScript Academy