TypeScript Academy · Les

Unions verfijnen over functiegrenzen heen

Neem veilige vernauwing mee over functiegrenzen heen met gediscrimineerde unions, predicateretourtypen en Result-achtige typen.

Les 3 van 38 stappen

Unions verfijnen over functiegrenzen heen is een gratis TypeScript Academy-les op CoddyKit. Dit is les 3 van 3. Je kunt de volledige les hieronder gratis lezen en daarna in de browser praktisch oefenen met een ingebouwde code-editor en een AI-begeleider die 24/7 beschikbaar is. Deze les maakt deel uit van het leertraject TypeScript Academy. Je voortgang wordt gesynchroniseerd op het web en in de CoddyKit-app. De cursus TypeScript Academy bevat in totaal 3 lessen.

Introductie

Doel: behoud je typeversmalling over functieaanroepen heen met getagde unietypen, predicaatretourwaarden en validatiehulpfuncties.

  • Geen onveilige as op aanroeppunten
  • Typeverfijningen reizen mee met de gegevens

Retourwaarde van een getagde unie

Het patroon Result: de aanroeper versmalt het type door ok te controleren. Geen casts en een duidelijke controlestroom.

type Ok<T> = { ok: true; value: T }
type Err = { ok: false; error: string }

type Result<T> = Ok<T> | Err

function parseIntSafe(s: string): Result<number> {
  const n = Number(s)
  return Number.isFinite(n) ? { ok: true, value: n } : { ok: false, error: "NaN" }
}

function useIt(s: string) {
  const r = parseIntSafe(s)
  if (r.ok) {
    // r is Ok<number>
    return r.value * 2
  }
  // r is Err
  return `bad: ${r.error}`
}

Predicaatretourwaarde

Predicaatretourwaarden (x is T) centraliseren controles en behouden de typeverfijning op aanroeppunten.

type User = { id: number; name: string }

type MaybeUser = User | null

function hasUser(x: MaybeUser): x is User {
  return x !== null
}

function greet(x: MaybeUser) {
  if (hasUser(x)) {
    // x narrowed to User
    return `Hello ${x.name}`
  }
  return "Anonymous"
}

Typeverfijning doorgeven

Verfijn het type met een bewaker (bijvoorbeeld isCircle) en geef de waarde daarna door; stroomafwaartse functies zien het versmalde type.

type Shape =
  | { kind: "circle"; radius: number }
  | { kind: "square"; size: number }

function isCircle(s: Shape): s is Extract<Shape, { kind: "circle" }> {
  return s.kind === "circle"
}

function area(s: Shape) {
  if (isCircle(s)) {
    // s is circle here
    return Math.PI * s.radius * s.radius
  }
  return s.size * s.size
}

Valideren op de grens

Valideer op de grens en retourneer Valid/Invalid; aanroepers versmallen het type aan de hand van de tag en krijgen volledig getypeerde gegevens.

type Payload = { email: string; retries?: number }

type Valid = { ok: true; data: Required<Payload> }
type Invalid = { ok: false; issues: string[] }

type Validation = Valid | Invalid

function validate(p: unknown): Validation {
  const issues: string[] = []
  if (typeof p !== "object" || p === null) return { ok: false, issues: ["not an object"] }
  const x = p as any
  if (typeof x.email !== "string") issues.push("email:string")
  if (x.retries !== undefined && typeof x.retries !== "number") issues.push("retries:number")
  if (issues.length) return { ok: false, issues }
  return { ok: true, data: { email: x.email, retries: x.retries ?? 0 } }
}

function handle(p: unknown) {
  const v = validate(p)
  if (!v.ok) return `bad: ${v.issues.join(",")}`
  // v.data is fully typed here
  return `send to ${v.data.email} (${v.data.retries})`
}

Tips

Beste werkwijzen:

  • Geef de voorkeur aan kleine, stabiele tags (ok, kind)
  • Centraliseer controles in predicaathelpers
  • Gebruik uitputtende switch-instructies op aanroeppunten
  • Vermijd any en onveilige casts

Typeversmalling over grenzen heen

Snelle controle: welk patroon behoudt typeversmalling het best over functiegrenzen heen?

Samenvatting

Samenvatting: neem typeverfijningen mee als gegevens (Result), valideer op grenzen en vermijd onveilige casts; aanroepers versmallen het type via eenvoudige tagcontroles.

Gratis beginnen

Leer TypeScript met een AI-tutor — gratis

Schrijf echte code en voer die uit in je browser, krijg direct hulp van een AI-tutor die 24/7 beschikbaar is en ga verder waar je gebleven bent op het web of in de app.

Cursussen
101
Lessen
352

Veelgestelde vragen

Is de les “Unions verfijnen over functiegrenzen heen” gratis?

Ja — de volledige tekst van “Unions verfijnen over functiegrenzen heen” kun je hier gratis op het web lezen. Als je interactief wilt oefenen met een ingebouwde code-editor en een AI-begeleider die 24/7 beschikbaar is, en de rest van de cursus TypeScript Academy wilt ontgrendelen, kun je upgraden naar CoddyKit PRO. De cursus TypeScript Academy bevat in totaal 3 lessen.

Wat leer ik in “Unions verfijnen over functiegrenzen heen”?

Neem veilige vernauwing mee over functiegrenzen heen met gediscrimineerde unions, predicateretourtypen en Result-achtige typen. Je oefent met TypeScript Academy door code rechtstreeks in de browser uit te voeren. Een AI-begeleider die 24/7 beschikbaar is beantwoordt je vragen terwijl je de les doorwerkt.

Heb ik ervaring nodig om met TypeScript Academy te beginnen?

Ervaring vooraf is niet nodig. TypeScript Academy op CoddyKit is opgebouwd voor beginners tot gevorderden, zodat je hier of bij het begin kunt starten en in je eigen tempo kunt leren. Dit is les 3 van 3.

Hoe lang duurt de les “Unions verfijnen over functiegrenzen heen”?

De meeste lessen van CoddyKit duren ongeveer 5–10 minuten. Elke les is kort en interactief, zodat je gestaag vooruitgaat en op het web en in de app precies verdergaat waar je was gebleven.

Kan ik code schrijven en uitvoeren in deze les over TypeScript Academy?

Ja. Elke les over TypeScript Academy bevat een ingebouwde code-editor, zodat je rechtstreeks in je browser echte code kunt schrijven en uitvoeren en direct feedback van AI krijgt — lokale installatie is niet nodig.

Alle lessen in deze cursus

  1. Volledige switches en never-controles
  2. Predicatefuncties en de satisfies-operator
  3. Unions verfijnen over functiegrenzen heen
← Terug naar TypeScript Academy