Obiecte: type și interface

Ce înseamnă să tipezi un obiect

Descrii forma obiectului: ce chei are și ce tip are fiecare valoare. TS verifică apoi că fiecare obiect folosit respectă forma.

type Product = {
  id: number
  name: string
  price: number
  tags?: string[]          // opțional — poate lipsi
  readonly sku: string     // nu poate fi modificat după creare
}

const p: Product = { id: 1, name: 'Laptop', price: 4000, sku: 'LP-1' }
p.sku = 'X'                // ✗ readonly
p.color                    // ✗ nu există în Product

type vs interface — diferențe și când

Ambele descriu forma unui obiect. În 90% din cazuri sunt interschimbabile.

Recomandare practică: type implicit (merge pentru orice), interface când scrii o librărie pe care alții o extind sau când echipa preferă așa. Important e să fii consecvent.

Proprietăți opționale și readonly

type User = {
  id: number
  email: string
  nickname?: string            // string | undefined
  readonly createdAt: Date
}

function displayName(user: User) {
  return user.nickname ?? user.email   // TS te obligă să tratezi lipsa
}

Dicționare: index signature și Record

Când cheile nu sunt cunoscute dinainte:

type Prices = { [productId: string]: number }
type Prices2 = Record<string, number>            // echivalent, mai citeț

const stock: Record<'ro' | 'md', number> = { ro: 10, md: 2 }   // chei fixe dintr-un union

Tipuri imbricate și compuse

type Address = { city: string; zip: string }
type Customer = { name: string; address: Address }

type Timestamps = { createdAt: Date; updatedAt: Date }
type Post = { title: string } & Timestamps      // intersecție: are tot din ambele

Structural typing

TS compară obiectele după formă, nu după nume: orice obiect care are câmpurile cerute e acceptat.

type Point = { x: number; y: number }
const p3 = { x: 1, y: 2, z: 3 }
const p: Point = p3          // ✓ are x și y — câmpul în plus nu deranjează

(Excepție: un obiect literal scris direct cu câmpuri în plus dă eroare — „excess property check” — ca să prindă typo-uri.)

Pe scurt

• Tipezi forma obiectului; ? opțional, readonly nemodificabil.
• type implicit; interface pentru extindere / librării.
• Record<K, V> pentru dicționare; & pentru combinare.

Surse oficiale

• TypeScript — Object Types
• TypeScript — Differences Between Type Aliases and Interfaces