Definindo formatos de objetos com interfaces

Boas-vindas

Interface básica

interface User {
  id: number;
  name: string;
  email: string;
}
const alice: User = { id: 1, name: 'Alice', email: 'a@b.com' };

Propriedades opcionais com ?

interface Config {
  host: string;
  port?: number;     // optional
  timeout?: number;  // optional
}

Propriedades somente leitura

interface Point {
  readonly x: number;
  readonly y: number;
}
const p: Point = { x: 5, y: 10 };
// p.x = 0; // Error!

Assinaturas de métodos

interface Animal {
  name: string;
  speak(): string;
  move(distance: number): void;
}

Assinaturas de índice

interface StringMap {
  [key: string]: string;
}
const headers: StringMap = {
  'content-type': 'application/json',
  'accept': 'text/html',
};

Tipagem estrutural

interface Named { name: string; }
function greet(obj: Named) { console.log(obj.name); }
greet({ name: 'Alice', age: 30 }); // Extra props OK when not a literal

Verificação de propriedades excedentes

interface Config { host: string; }
// const c: Config = { host: 'localhost', extra: 1 }; // Error on literal
const obj = { host: 'localhost', extra: 1 };
const c: Config = obj; // OK — not a fresh literal

Interface para tipos de função

interface Greeter {
  (name: string): string;
}
const greet: Greeter = name => 'Hello, ' + name;

Interfaces aninhadas

interface Address { street: string; city: string; }
interface Person { name: string; address: Address; }
const p: Person = { name: 'Alice', address: { street: '1 Main', city: 'NY' } };

Interface versus instância de classe

interface Saveable { save(): Promise<void>; }
class UserService implements Saveable {
  async save() { /* ... */ }
}

Verificação rápida

Recapitulação