Skip to content
StackPulse
Advertisement320×50 → 728×90 responsive
TypeScript

Diferença entre interface e type no TypeScript: quando usar cada um

Tanto interface quanto type permitem definir formas de objetos no TypeScript. Apesar de parecidos, existem diferenças práticas que impactam legibilidade, extensibilidade e manutenção do código.

Publicado em 2026-01-2010 min de leitura

Visão geral

interface é ideal para definir contratos de objetos e classes. type (type alias) é mais geral: pode representar uniões, interseções, tuplas, primitivos e tipos mapeados. Em muitos casos de objeto, ambos funcionam de forma intercambiável — a escolha final costuma ser mais sobre convenção do time do que sobre capacidade técnica.

Uma regra prática ajuda a decidir: se a forma é um objeto e existe a intenção de estendê-la, use interface. Se a forma envolve composição — união, interseção, tupla ou primitivo — use type. Fora desses casos, a consistência dentro do projeto vale mais do que a escolha em si.

Diferenças principais

Aspectointerfacetype
Extensão (herança)Suporta extends e declaração conjunta (merging)Suporta interseção &; não faz declaration merging
União / InterseçãoLimitado (melhor com type)Excelente para A | B, A & B
Primitivos / TuplasNão permitidoPermitido (type ID = string | number)
ClassesPode ser implementado por class implementsTambém pode, mas interface é mais idiomático
Declaration mergingSim (útil para augmentação de libs)Não
Erros de mensagemMensagens mais claras e específicasMensagens mais genéricas em unions

Exemplos práticos

Extensão com interface

interface User {
  id: number;
  name: string;
}

interface Admin extends User {
  permissions: string[];
}

União com type

type Status = "loading" | "success" | "error";

type Result =
  | { status: "success"; data: User }
  | { status: "error"; message: string };

Note o uso de união discriminada: o campo status funciona como discriminante e permite ao TypeScript estreitar o tipo dentro de cada ramo do if. É o padrão mais seguro para modelar estados de requisição.

Interseção

type Timestamped = { createdAt: Date; updatedAt: Date };
type UserWithTimestamps = User & Timestamped;

Mesma forma, duas sintaxes

interface Point { x: number; y: number }
type Point = { x: number; y: number }

// Equivalentes para o compilador — mas apenas a interface
// aceita declaration merging e `extends`.

Quando usar cada um?

  • Use interface para definir formas de objetos que podem ser estendidas por outras partes do código (component props, entidades de domínio, contratos de API).
  • Use type para uniões, interseções, tuplas, primitivos, tipos utilitários e casos mais complexos.
  • Em código TypeScript moderno, muitos times adotam: interface por padrão para objetos; type quando precisa de união/interseção. Não há regra rígida.
  • Para props de componentes React, o padrão da comunidade é interface — o que permite a augmentação de tipos por bibliotecas.
  • Para resultados de API gerados automaticamente, ambos funcionam; a escolha depende de o tipo precisar ser estendido depois.

Armadilhas comuns

  • Declaration merging é acidental. Duas interface com o mesmo nome no mesmo escopo são combinadas silenciosamente. Com type, isso gera erro de compilação — um dos motivos para preferir type quando a duplicata seria um bug.
  • Propriedades opcionais não são undefined. Em strict, name?: string significa string | undefined — o compilador obriga você a checar antes de usar.
  • Index signatures exigem rótulo explícito. [key: string]: unknown é diferente de { [key: string]: unknown } e o segundo caso é o correto.
  • União de objetos é mais estrita que interseção. Em { a: string } | { b: number }, o objeto precisa satisfazer um dos ramos completos, o que costuma ser mais rígido do que o esperado.

Conclusão

A diferença prática é menor hoje, mas entender extends vs &, declaration merging e suporte a uniões ajuda a tomar a decisão certa. Para a maioria dos casos, priorize clareza e consistência: defina uma convenção no projeto, aplique-a em code review e você evita metade das discussões sobre estilo. Quando os tipos vierem de respostas de API, use JSON to TypeScript para gerar a base automaticamente — o guia completo está em como converter JSON em TypeScript.