Deklaracje ambient (.d.ts) i typy bibliotek zewnętrznych
Pisanie deklaracji ambient w plikach .d.ts do opisywania zmiennych globalnych i modułów oraz bezpieczne instalowanie i używanie typów bibliotek zewnętrznych
Deklaracje ambient (.d.ts) i typy bibliotek zewnętrznych to bezpłatna lekcja TypeScript Academy na CoddyKit. To lekcja 2 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: Opisywać zewnętrzny kod JavaScript za pomocą deklaracji ambientowych w plikach .d.ts oraz używać typów dostarczanych przez podmioty trzecie w przypadku bibliotek, które nie mają typów.
Deklaracje globalne
globals.d.ts: Deklaruj elementy globalne i rozszerzaj ambientowe interfejsy (np. Window) bez generowania kodu JavaScript.
// file: globals.d.ts
// Declare global variables and interfaces
declare const VERSION: string;
declare interface Window {
appReady?: boolean;
}Podstawy lambdy z receiverem
- Receiver = instancja buildera używana wewnątrz lambdy.
- Czytelniejsze wywołania: item("Tea") zamiast builder.item.
- Używaj krótkich nazw i jasno określaj działania.
Deklaracje modułów
declare module opisuje pakiet, który nie dostarcza typów. Teraz import { coolify } jest poprawnie sprawdzany pod względem typów.
// file: cool-lib.d.ts
// Provide types for an untyped JS module
declare module "cool-lib" {
export function coolify(s: string): string;
export const version: string;
}Rozszerzanie modułu
Rozszerzanie modułu pozwala rozszerzać zainstalowane definicje typów, np. dodawać własną właściwość do istniejącego interfejsu.
// file: react-augment.d.ts
// Extend an existing module (augmentation)
declare module "react" {
interface HTMLAttributes<T> {
dataTestId?: string;
}
}Typy bibliotek zewnętrznych
Jeśli biblioteka nie dostarcza typów, należy preferować pakiety @types/ z DefinitelyTyped. Dodają one do kompilacji wyłącznie pliki .d.ts.
// install: npm i -D @types/lodash
// usage:
import _ from "lodash";
const r = _.chunk([1,2,3,4], 2);Wskazówki i rozwiązywanie typów
Wskazówki:
- Umieść pliki .d.ts w katalogu src/ lub uwzględnij je za pomocą tsconfig.json (
include/typeRoots/types). - Używaj rozszerzania modułu, aby je rozszerzać; unikaj edytowania katalogu node_modules.
- Unikaj zbyt szerokiego
any; określaj minimalne, dokładne struktury.
Sprawdzenie deklaracji ambientowych
Szybkie sprawdzenie: Do czego służy deklaracja ambientowa?
Podsumowanie
Podsumowanie: Używaj plików .d.ts dla elementów globalnych i modułów, preferuj @types w przypadku typów społecznościowych oraz bezpiecznie rozszerzaj typy za pomocą rozszerzania modułu.
Podsumowanie
Podsumowanie: Używaj odbiorników o określonym typie w każdym bloku, dodaj @DslMarker dla bezpieczeństwa zakresów i zwracaj niezmienny model, aby korzystanie z niego było przejrzyste.
Często zadawane pytania
Czy lekcja „Deklaracje ambient (.d.ts) i typy bibliotek zewnętrznych” jest bezpłatna?
Tak — pełny tekst „Deklaracje ambient (.d.ts) i typy bibliotek zewnętrznych” 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 „Deklaracje ambient (.d.ts) i typy bibliotek zewnętrznych”?
Pisanie deklaracji ambient w plikach .d.ts do opisywania zmiennych globalnych i modułów oraz bezpieczne instalowanie i używanie typów bibliotek zewnętrznych Ć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 2 z 3.
Ile czasu zajmuje lekcja „Deklaracje ambient (.d.ts) i typy bibliotek zewnętrznych”?
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
- Moduły ES (named a default) i re-eksporty
- Deklaracje ambient (.d.ts) i typy bibliotek zewnętrznych
- Mapowanie ścieżek i rozwiązywanie modułów