TypeScript Academy · Lektion

Assertionsfunktioner och användardefinierade typvakter

Skriv assertionsfunktioner (asserts x is T) och användardefinierade typvakter (x is T) för att säkert förfina unknown- och unionvärden.

Lektion 3 av 38 steg

Assertionsfunktioner och användardefinierade typvakter är en gratis lektion i TypeScript Academy på CoddyKit. Detta är lektion 3 av 3. Ni kan läsa hela lektionen gratis nedan och sedan öva praktiskt i webbläsaren med en inbyggd kodredigerare och en AI-handledare som är tillgänglig dygnet runt. Den ingår i lärvägen för TypeScript Academy, och Era framsteg synkroniseras mellan webben och CoddyKit-appen. Kursen i TypeScript Academy innehåller totalt 3 lektioner.

Introduktion

Mål: Omvandla kontroller vid körning till typförfiningar med assertionsfunktioner och egendefinierade type guards för säkra API:er.

Assertionsfunktion

En assertionsfunktion förfinar typerna i efterföljande kod om den returnerar; annars måste den kasta ett fel.

function assertIsString(x: unknown): asserts x is string {
  if (typeof x !== "string") {
    throw new Error("Expected string");
  }
}

let v: unknown = Math.random() > 0.5 ? "ok" : 42;
assertIsString(v); // after this, v is string
console.log(v.toUpperCase());

Type guard-funktion

En type guard returnerar x is T, vilket möjliggör smart typförfining i grenar och hjälpfunktioner.

type Circle = { kind: "circle"; radius: number };
type Square = { kind: "square"; size: number };

type Shape = Circle | Square;

function isCircle(s: Shape): s is Circle {
  return s.kind === "circle";
}

function area(s: Shape): number {
  if (isCircle(s)) {
    return Math.PI * s.radius ** 2; // s is Circle here
  }
  return s.size * s.size; // s is Square here
}

console.log(area({ kind: "circle", radius: 2 }));

Type guards i filter

Type guards kan fungera som predikat för array-metoder (till exempel filter) och förfina elementtyper på ett tydligt sätt.

type Item = { id: number } | null | undefined;

function isPresent<T>(x: T | null | undefined): x is T {
  return x != null;
}

const items: Item[] = [{ id: 1 }, null, undefined, { id: 2 }];
const present = items.filter(isPresent);
// present has type { id: number }[]
console.log(present.map(i => i.id));

Assertionskontroll av data vid körning

Kombinera parsning med en assertion för att snabbt avbryta när ett värde inte har den förväntade typen.

function parseJson(s: string): unknown {
  return JSON.parse(s);
}

try {
  const data = parseJson("{\"name\":\"Ada\"}");
  assertIsString(data); // will throw, because data is object
} catch (e) {
  console.log("Handled:", e instanceof Error ? e.message : e);
}

Riktlinjer

Riktlinjer:

  • Assertions måste kasta ett fel vid misslyckande.
  • Föredra type guards (x is T) för förgreningslogik.
  • Använd assertions vid API-gränser (I/O, JSON, DOM).

Kontroll av assertionsfunktioner

Snabbkontroll: Vad garanterar en assertionsfunktion med asserts x is string?

Sammanfattning

Sammanfattning: Använd assertionsfunktioner för att säkerställa typer efter kontroller och egendefinierade type guards för att förfina grenar och samlingar.

Gratis att börja

Lär dig TypeScript med en AI-lärare – gratis

Skriv och kör riktig kod i webbläsaren, få omedelbar hjälp av en AI-lärare dygnet runt och fortsätt där du slutade – på webben eller i appen.

Kurser
101
Lektioner
352

Vanliga frågor

Är lektionen ”Assertionsfunktioner och användardefinierade typvakter” gratis?

Ja – hela texten till ”Assertionsfunktioner och användardefinierade typvakter” kan läsas gratis här på webben. Om Ni vill öva interaktivt med en inbyggd kodredigerare och en AI-handledare som är tillgänglig dygnet runt och låsa upp resten av kursen i TypeScript Academy, kan Ni uppgradera till CoddyKit PRO. Kursen i TypeScript Academy innehåller totalt 3 lektioner.

Vad lär jag mig i ”Assertionsfunktioner och användardefinierade typvakter”?

Skriv assertionsfunktioner (asserts x is T) och användardefinierade typvakter (x is T) för att säkert förfina unknown- och unionvärden. Ni övar på TypeScript Academy med praktisk kod som körs direkt i webbläsaren, medan en AI-handledare som är tillgänglig dygnet runt svarar på Era frågor under lektionen.

Behöver jag någon erfarenhet för att börja lära mig TypeScript Academy?

Du behöver inga förkunskaper. Utbildningen i TypeScript Academy på CoddyKit är upplagd för allt från nybörjare till avancerade elever, så att du kan börja här eller från början och gå fram i din egen takt. Detta är lektion 3 av 3.

Hur lång tid tar lektionen ”Assertionsfunktioner och användardefinierade typvakter”?

De flesta CoddyKit-lektioner tar cirka 5–10 minuter. Varje lektion är kort och interaktiv, så att du gör stadiga framsteg och kan fortsätta precis där du slutade – på webben eller i appen.

Kan jag skriva och köra kod i den här TypeScript Academy-lektionen?

Ja. Varje TypeScript Academy-lektion innehåller en inbyggd kodredigerare, så att du kan skriva och köra riktig kod direkt i webbläsaren och få omedelbar AI-feedback – utan lokal installation.

Alla lektioner i den här kursen

  1. Funktionsöverlagring och anropssignaturer
  2. Typning av this-parametern; void, never
  3. Assertionsfunktioner och användardefinierade typvakter
← Tillbaka till TypeScript Academy