Przeciążenia funkcji i sygnatury wywołania
Deklarowanie sygnatur przeciążeń dla różnych postaci wywołań oraz używanie sygnatur wywołania wewnątrz typów obiektów na potrzeby elastycznych API
Przeciążenia funkcji i sygnatury wywołania to bezpłatna lekcja TypeScript Academy na CoddyKit. To lekcja 1 z 3. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej TypeScript Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs TypeScript Academy zawiera 3 lekcji w sumie.
Wprowadzenie
Cel: Modelować funkcje, które przyjmują różne dane wejściowe i zwracają różne dane wyjściowe, używając przeciążeń, oraz opisywać sygnatury wywołania w typach obiektów na potrzeby API przypominających interfejsy wywołań zwrotnych.
Wzorzec przeciążenia
Przeciążenia deklaruje się jako wiele sygnatur oraz jedną implementację, która zawęża dane wejściowe i zwraca właściwy 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)Sygnatury wywołań
Sygnatura wywołania pozwala wywoływać wartości typu obiektowego z użyciem przeciążeń, co jest przydatne w bibliotekach udostępniających funkcje wywoływalne z właściwościami.
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));Zawężanie w implementacji
Implementacja musi obsługiwać wszystkie warianty przeciążeń. Należy używać sprawdzeń in lub unii dyskryminowanych, aby bezpiecznie rozdzielać obsługę przypadków.
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 }));Przeciążenia a unie
Przeciążenia a unie:
- Przeciążenia zapewniają precyzyjne typy zwracane dla każdego wywołania.
- Unie zachowują jedną sygnaturę, co upraszcza kod, ale daje mniej szczegółowe typy.
- Należy wybrać przeciążenia, gdy kod wywołujący korzysta na dokładnych typach zwracanych.
Wskazówki DX
Wskazówki:
- Należy ograniczać liczbę przeciążeń i zachowywać ich przejrzystość.
- Należy dokumentować różnice w parametrach i typach zwracanych.
- Warto preferować precyzję typu zwracanego, gdy poprawia to komfort korzystania z API.
Sprawdzenie przeciążeń
Szybkie sprawdzenie: Który wzorzec poprawnie deklaruje przeciążenia funkcji?
Podsumowanie
Podsumowanie: Należy używać przeciążeń, aby uzyskać precyzyjne typy dla poszczególnych wywołań, oraz sygnatur wywołań do modelowania wywoływalnych obiektów. W pojedynczej implementacji należy zawężać typy tak, aby obsłużyć każdy przypadek.
Często zadawane pytania
Czy lekcja „Przeciążenia funkcji i sygnatury wywołania” jest bezpłatna?
Tak — pełny tekst „Przeciążenia funkcji i sygnatury wywołania” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu TypeScript Academy, przejdź na CoddyKit PRO. Kurs TypeScript Academy zawiera 3 lekcji w sumie.
Co nauczysz się w „Przeciążenia funkcji i sygnatury wywołania”?
Deklarowanie sygnatur przeciążeń dla różnych postaci wywołań oraz używanie sygnatur wywołania wewnątrz typów obiektów na potrzeby elastycznych API Ćwiczysz TypeScript Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.
Czy potrzebuję doświadczenia, aby zacząć TypeScript Academy?
Nie wymagamy żadnego doświadczenia. TypeScript Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 1 z 3.
Ile czasu zajmuje lekcja „Przeciążenia funkcji i sygnatury wywołania”?
Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.
Czy mogę pisać i uruchamiać kod w tej lekcji TypeScript Academy?
Tak. Każda lekcja TypeScript Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.
Wszystkie lekcje w tym kursie
- Przeciążenia funkcji i sygnatury wywołania
- Typowanie parametru this; void i never
- Funkcje asercji i strażnicy typów definiowani przez użytkownika