narrowing Fundamentos do estreitamento (veracidade e atribuição)

Última atualização: 2026-10-22

narrowing Fundamentos do estreitamento (veracidade e atribuição)

Um tipo união reúne várias possibilidades em uma única variável, então, antes de usá-la, é preciso descobrir o que ela realmente é naquele momento — reduzir o tipo amplo a um tipo concreto chama-se estreitamento (narrowing). O TypeScript analisa o fluxo de controle (if, switch, verificações de veracidade) e estreita automaticamente a variável para o tipo do ramo correspondente; só então é seguro acessar os membros exclusivos desse ramo.

ℹ️ Info O editor transpila TypeScript para JavaScript e o executa (sem verificação de tipos); veja a Saída de cada exemplo para o resultado da verificação.

📝 Sintaxe

function handle(value: string | number | null) {
  if (value == null) return;        // elimina null/undefined por estreitamento
  if (typeof value === "string") {
    value.toUpperCase();            // value está estreitado para string aqui
  } else {
    value.toFixed(2);               // value está estreitado para number aqui
  }
}

⚙️ Parâmetros

Retorno：Sem valor de retorno — o estreitamento é uma análise de fluxo de controle em tempo de compilação e não gera nenhum código em tempo de execução.

▶ Exemplo

Edite o código abaixo e clique em Testar para ver o resultado transpilado:

Saída：

Hello, guest
Hello, guest
Hello, anonymous
Hello, Ada (length 3)

(Saída de execução após a transpilação; é possível acessar name.length com segurança em cada ramo porque o tsc já estreitou name para string — em tempo de execução existem apenas os valores)

💡 Observações

🏷️ Restrição e Asserções de Tipos Relacionadas

💡 Casos relacionados

📚 Tutoriais relacionados

❓ Perguntas frequentes

Equipe Técnica Web-Tutorial

Uma plataforma de tutoriais mantida por diversos desenvolvedores. Cada tutorial é escrito e revisado por profissionais da área correspondente. Trabalhamos para manter nosso conteúdo preciso e confiável — se encontrar algum problema, avise-nos.

Sobre Nós