Funktionsöverlagring och anropssignaturer
Deklarera överlagringssignaturer för olika anropsformer och använd anropssignaturer i objekttyper för flexibla API:er.
Funktionsöverlagring och anropssignaturer är en gratis lektion i TypeScript Academy på CoddyKit. Detta är lektion 1 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: Modellera funktioner som accepterar olika indata och returnerar olika utdata med hjälp av overloads, samt beskriva anropssignaturer i objekttyper för callback-liknande API:er.
Överlagringsmönster
Overloads deklareras som flera signaturer plus en implementation som förfinar indata och returnerar rätt typ.
// 1) Overload signatures (no body)
function parse(input: string): number;
function parse(input: number): string;
// 2) Single implementation compatible with all overloads
function parse(input: string | number): string | number {
if (typeof input === "string") {
return input.length; // string -> number
} else {
return String(input); // number -> string
}
}
console.log(parse("TS")); // 2 (number)
console.log(parse(123)); // "123" (string)Anropssignaturer
En anropssignatur gör att en objekttyp kan anropas med överlagringar (användbart för bibliotek som tillhandahåller anropsbara funktioner med egenskaper).
type Stringify = {
(v: number): string;
(v: boolean): string;
};
const toStr: Stringify = (v: number | boolean) => {
return typeof v === "number" ? v.toFixed(1) : (v ? "true" : "false");
};
console.log(toStr(3));
console.log(toStr(false));Typförfining i implementationen
Implementationen måste hantera alla former av överlagringen. Använd in-kontroller eller diskriminerade unioner för att förgrena säkert.
function area(value: { r: number } | { w: number; h: number }): number {
if ("r" in value) {
return Math.PI * value.r ** 2; // circle
}
return value.w * value.h; // rect
}
console.log(area({ r: 2 }));
console.log(area({ w: 3, h: 4 }));Överlagringar kontra unioner
Överlagringar kontra unioner:
- Överlagringar ger exakta returtyper för varje anrop.
- Unioner behåller en signatur, vilket är enklare men mindre specifikt.
- Välj överlagringar när anroparna har nytta av exakta returtyper.
DX-tips
Tips:
- Håll antalet överlagringar litet och tydligt.
- Dokumentera skillnader i parametrar och returvärden.
- Föredra precisa returtyper när det förbättrar utvecklarupplevelsen.
Kontroll av överlagringar
Snabbkontroll: Vilket mönster deklarerar funktionsöverlagringar korrekt?
Sammanfattning
Sammanfattning: Använd överlagringar för precisa typer per anrop och anropssignaturer för att modellera anropsbara objekt. Förfina typen i den enda implementationen så att alla fall täcks.
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 ”Funktionsöverlagring och anropssignaturer” gratis?
Ja – hela texten till ”Funktionsöverlagring och anropssignaturer” 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 ”Funktionsöverlagring och anropssignaturer”?
Deklarera överlagringssignaturer för olika anropsformer och använd anropssignaturer i objekttyper för flexibla API:er. 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 1 av 3.
Hur lång tid tar lektionen ”Funktionsöverlagring och anropssignaturer”?
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
- Funktionsöverlagring och anropssignaturer
- Typning av this-parametern; void, never
- Assertionsfunktioner och användardefinierade typvakter