Interface versus type: quando utilizar cada um

Boas-vindas

Semelhanças

interface A { x: number; }
type B = { x: number; };
// Both describe the same shape

Diferença principal: fusão de declarações

interface Config { host: string; }
interface Config { port: number; } // OK — merged

type Settings = { host: string; };
// type Settings = { port: number; }; // Error

Diferença principal: união e interseção

type ID = string | number;        // union — only with type
type Nullable<T> = T | null;       // union — only with type
type Point = [number, number];     // tuple — only with type

Diferença principal: propriedades calculadas

type ReadonlyUser = Readonly<{ name: string; age: number }>; // mapped type
type Keys = keyof User; // only with type

Usando interface para contratos de classes

interface Repository<T> {
  findById(id: number): T | null;
  save(item: T): void;
}
class UserRepo implements Repository<User> { /* ... */ }

Desempenho: interfaces versus tipos

As mensagens de erro diferem

Recomendação oficial do TypeScript

A consistência da equipe é o mais importante

Tabela de decisão resumida

// interface
interface User { name: string; age: number; }

// type (union)
type ID = string | number;

// type (tuple)
type Coord = [number, number];

Verificação rápida

Recapitulação