TypeScript Academy · Lekcja

Praca z nietypowanymi bibliotekami firm trzecich

Używaj pakietów @types i pisz ręczne deklaracje.

Praca z nietypowanymi bibliotekami firm trzecich to bezpłatna lekcja TypeScript Academy na CoddyKit. To lekcja 4 z 4. 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 4 lekcji w sumie.

Problem: brakujące typy

Niektóre pakiety npm nie zawierają deklaracji TypeScriptu i nie mają pakietu @types/. TypeScript domyślnie traktuje je jako any, co oznacza utratę bezpieczeństwa typów na granicy biblioteki.

import legacyLib from "untyped-lib"; // legacyLib: any

Pakiety @types

Projekt DefinitelyTyped udostępnia deklaracje typów utrzymywane przez społeczność dla tysięcy bibliotek. Wyszukuj w npm pakiety w formacie @types/library-name.

npm install --save-dev @types/lodash
npm install --save-dev @types/express
# Now lodash and express have full TypeScript types

Pisanie pliku deklaracji (.d.ts)

Jeśli nie istnieje pakiet @types, napisz w projekcie minimalny plik deklaracji, aby zadeklarować moduł i jego typy.

// src/types/untyped-lib.d.ts
declare module "untyped-lib" {
  export function doSomething(x: string): number;
  export const version: string;
}

Rozszerzanie modułów

Rozszerzaj istniejące typy bibliotek zewnętrznych, dodając własne deklaracje do istniejącego modułu, bez tworzenia jego forka.

// Extend Express Request with a custom property
declare namespace Express {
  interface Request {
    user?: AuthUser;
  }
}

Deklaracje modułów z symbolami wieloznacznymi

W przypadku całych kategorii importów bez typów, na przykład plików zasobów, używaj deklaracji modułów z symbolami wieloznacznymi.

// src/types/assets.d.ts
declare module "*.svg" {
  const content: string;
  export default content;
}
declare module "*.json" {
  const value: Record<string, unknown>;
  export default value;
}

noImplicitAny a biblioteki bez typów

Przy noImplicitAny: true importowanie modułu bez typów powoduje błąd kompilacji. Użyj pliku deklaracji albo wyłącz noImplicitAny dla pojedynczego pliku za pomocą // @ts-ignore.

// Quick fix for a single untyped import:
// @ts-ignore
import untypedLib from "untyped-lib";

Współtworzenie DefinitelyTyped

Jeśli napiszesz wysokiej jakości typy dla biblioteki bez typów, prześlij je do projektu DefinitelyTyped, aby pomóc społeczności.

# Fork DefinitelyTyped and add:
# types/your-library/index.d.ts
# types/your-library/package.json
# Submit a PR at github.com/DefinitelyTyped/DefinitelyTyped

Używanie any w ostateczności

Gdy nie można szybko uzyskać typów, użyj jawnego any i dodaj komentarz śledzący powstały dług. Jest to lepsze niż implicit any, ponieważ użycie jest zamierzone i widoczne.

// eslint-disable-next-line @typescript-eslint/no-explicit-any
const lib: any = require("untyped-lib"); // TODO: add types

skipLibCheck dla błędów deklaracji

Jeśli zewnętrzny plik .d.ts zawiera błędy wewnętrzne, skipLibCheck: true wycisza je bez wpływu na sprawdzanie własnych typów.

{
  "compilerOptions": {
    "skipLibCheck": true
  }
}

Opakowania typów dla niebezpiecznych bibliotek

Napisz moduł opakowujący z typami wokół biblioteki bez typów, aby ograniczyć użycie any i udostępnić reszcie bazy kodu bezpieczne API z typami.

// src/lib/safe-legacy.ts
// eslint-disable-next-line @typescript-eslint/no-explicit-any
const raw: any = require("untyped-lib");
export function doSomething(x: string): number { return raw.doSomething(x); }

Podsumowanie: biblioteki bez typów

Obsługa bibliotek bez typów: najpierw sprawdź pakiety @types/, napisz minimalne pliki deklaracji, użyj rozszerzania modułów, utwórz opakowania z typami i zastosuj skipLibCheck w przypadku błędów deklaracji w zależnościach.

Szybkie sprawdzenie

Gdzie należy najpierw szukać deklaracji typów dla pozbawionego typów pakietu npm?

Czego się Państwo nauczyli

Biblioteki bez typów: sprawdzaj pakiety @types/, pisz pliki deklaracji, rozszerzaj istniejące typy, używaj deklaracji modułów z symbolami wieloznacznymi, opakowuj niebezpieczne biblioteki w fasady z typami i stosuj skipLibCheck w przypadku błędów zależności.

Często zadawane pytania

Czy lekcja „Praca z nietypowanymi bibliotekami firm trzecich” jest bezpłatna?

Tak — pełny tekst „Praca z nietypowanymi bibliotekami firm trzecich” 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 4 lekcji w sumie.

Co nauczysz się w „Praca z nietypowanymi bibliotekami firm trzecich”?

Używaj pakietów @types i pisz ręczne deklaracje. Ć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 4 z 4.

Ile czasu zajmuje lekcja „Praca z nietypowanymi bibliotekami firm trzecich”?

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

Rozpoczęcie migracji: allowJs i checkJs
Adnotacje typów JSDoc jako pomost
Strategia konwersji plik po pliku
Praca z nietypowanymi bibliotekami firm trzecich

← Powrót do TypeScript Academy