Type vs Interface no TypeScript

O Que São Type e Interface no TypeScript

Galera, vamos direto ao ponto. Tanto type quanto interface servem pra definir o formato de dados no TypeScript. Parecem gêmeos, mas têm personalidades bem diferentes.

Interface nasceu pra descrever a forma de objetos. Pensa nela como um contrato: 'esse objeto precisa ter esses campos'. Type alias é mais versátil. Dá pra representar objetos, unions, intersections, primitivos, tuplas e muito mais.

Na prática, a grande sacada é: interface é aberta (pode ser estendida depois) e type é fechado (uma vez definido, não muda). Isso muda completamente como você organiza código em projetos grandes.

O TypeScript trata os dois de forma parecida na compilação, mas cada um tem superpoderes próprios. Entender onde cada um brilha é o que separa o dev que chuta do dev que decide com confiança.

Como Decidir entre Type e Interface Passo a Passo

Não precisa decorar regra. Segue esse fluxo e você acerta em 95% dos casos:

Exemplos Práticos

Vamos ver código de verdade. Primeiro, a syntax básica de cada um:

// Interface - descreve objetos
interface User {
  name: string;
  age: number;
  email: string;
}

// Type alias - descreve qualquer tipo
type UserType = {
  name: string;
  age: number;
  email: string;
};

// Até aqui, fazem a mesma coisa
const user1: User = { name: "Ana", age: 28, email: "ana@dev.com" };
const user2: UserType = { name: "Ana", age: 28, email: "ana@dev.com" };

Agora, onde interface brilha: extending e declaration merging.

// Extending com interface (extends)
interface Animal {
  name: string;
}

interface Dog extends Animal {
  breed: string;
}

// Declaration merging - só interface faz isso
interface Config {
  apiUrl: string;
}

interface Config {
  timeout: number;
}

// Config agora tem apiUrl E timeout
const config: Config = { apiUrl: "https://api.com", timeout: 5000 };

E onde type manda: unions, intersections, tuplas e tipos complexos.

// Union types - só type faz
type Status = "loading" | "success" | "error";
type ID = string | number;

// Intersection com type (&)
type Admin = User & { role: "admin" };

// Tupla - só type
type Coordinate = [number, number];

// Mapped types - só type
type ReadonlyUser = {
  readonly [K in keyof User]: User[K];
};

// Conditional types - só type
type IsString = T extends string ? "sim" : "nao";

Resumo rápido: interface pra objetos e contratos. Type pra todo o resto. Em projetos reais, você vai usar os dois juntos sem problema.

Erros Comuns