Håndtering af typeløse tredjepartsbiblioteker
Brug @types-pakker, og skriv manuelle deklarationer
Håndtering af typeløse tredjepartsbiblioteker er en gratis TypeScript Academy-lektion på CoddyKit. Dette er lektion 4 af 4. Du kan læse hele lektionen gratis nedenfor — og derefter øve dig praktisk i browseren med en indbygget kodeeditor og en AI-vejleder, der er tilgængelig døgnet rundt. Den er en del af læringsforløbet i TypeScript Academy, og dine fremskridt synkroniseres på tværs af nettet og CoddyKit-appen. TypeScript Academy-kurset indeholder 4 lektioner i alt.
Problemet: Manglende typer
Nogle npm-pakker leveres ikke med TypeScript-erklæringer og har ingen @types/-pakke. TypeScript behandler dem som any som standard, så typesikkerheden forsvinder ved grænsen.
import legacyLib from "untyped-lib"; // legacyLib: anyPakker med @types
Projektet DefinitelyTyped leverer community-vedligeholdte typeerklæringer til tusindvis af biblioteker. Søg på npm efter @types/library-name.
npm install --save-dev @types/lodash
npm install --save-dev @types/express
# Now lodash and express have full TypeScript typesSkrivning af en deklarationsfil (.d.ts)
Hvis der ikke findes en @types-pakke, skal du skrive en minimal deklarationsfil i dit projekt for at erklære modulet og dets typer.
// src/types/untyped-lib.d.ts
declare module "untyped-lib" {
export function doSomething(x: string): number;
export const version: string;
}Moduludvidelse
Udvid eksisterende tredjepartstyper ved at tilføje dine egne erklæringer til et eksisterende modul uden at oprette en afgrening af det.
// Extend Express Request with a custom property
declare namespace Express {
interface Request {
user?: AuthUser;
}
}Modulerklæringer med jokertegn
For hele kategorier af importer uden typer, f.eks. ressourcefiler, skal du bruge modulerklæringer med jokertegn.
// 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 og biblioteker uden typer
Med noImplicitAny: true medfører import af et modul uden typer en kompileringsfejl. Brug en deklarationsfil, eller deaktivér noImplicitAny pr. fil med // @ts-ignore.
// Quick fix for a single untyped import:
// @ts-ignore
import untypedLib from "untyped-lib";Bidrag til DefinitelyTyped
Hvis du skriver typer af høj kvalitet til et bibliotek uden typer, kan du indsende dem til DefinitelyTyped for at hjælpe fællesskabet.
# Fork DefinitelyTyped and add:
# types/your-library/index.d.ts
# types/your-library/package.json
# Submit a PR at github.com/DefinitelyTyped/DefinitelyTypedBrug af any som sidste udvej
Når du ikke hurtigt kan få fat i typerne, skal du bruge eksplicit any med en kommentar, der holder styr på den tekniske gæld. Det er bedre end implicitte any, fordi det er bevidst og synligt.
// eslint-disable-next-line @typescript-eslint/no-explicit-any
const lib: any = require("untyped-lib"); // TODO: add typesskipLibCheck til deklarationsfejl
Hvis en tredjeparts-.d.ts-fil indeholder interne fejl, undertrykker skipLibCheck: true dem uden at påvirke din egen typekontrol.
{
"compilerOptions": {
"skipLibCheck": true
}
}Typeindpakninger til usikre biblioteker
Skriv et typetilpasset omslagsmodul omkring et bibliotek uden typer for at afgrænse any og stille en typesikker API til rådighed for resten af din kodebase.
// 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); }Opsummering: Biblioteker uden typer
Håndtér biblioteker uden typer: Tjek først @types/-pakker, skriv minimale deklarationsfiler, brug moduludvidelse, opret typetilpassede omslag, og brug skipLibCheck til deklarationsfejl i afhængigheder.
Hurtigt tjek
Hvad er det første sted, du skal lede efter typeerklæringer til en npm-pakke uden typer?
Det har du lært
Biblioteker uden typer: Tjek @types/-pakker, skriv deklarationsfiler, udvid eksisterende typer, brug modulerklæringer med jokertegn, pak usikre biblioteker ind i typetilpassede facader, og brug skipLibCheck til afhængighedsfejl.
Lær TypeScript med en AI-underviser — gratis
Skriv og kør rigtig kode i din browser, få øjeblikkelig hjælp fra en AI-underviser døgnet rundt, og fortsæt, hvor du slap, på web eller i appen.
- Kurser
- 101
- Lektioner
- 352
Ofte stillede spørgsmål
Er lektionen “Håndtering af typeløse tredjepartsbiblioteker” gratis?
Ja — hele teksten til “Håndtering af typeløse tredjepartsbiblioteker” kan læses gratis her på nettet. Hvis du vil øve dig interaktivt med en indbygget kodeeditor og en AI-vejleder døgnet rundt og få adgang til resten af TypeScript Academy-kurset, skal du opgradere til CoddyKit PRO. TypeScript Academy-kurset indeholder 4 lektioner i alt.
Hvad lærer jeg i “Håndtering af typeløse tredjepartsbiblioteker”?
Brug @types-pakker, og skriv manuelle deklarationer Du øver dig i TypeScript Academy med praktisk kode, som du kører direkte i browseren, og en AI-vejleder døgnet rundt besvarer dine spørgsmål, mens du arbejder dig gennem lektionen.
Skal jeg have erfaring for at begynde på TypeScript Academy?
Der kræves ingen tidligere erfaring. TypeScript Academy på CoddyKit er tilrettelagt for både begyndere og øvede, så du kan starte her eller fra begyndelsen og lære i dit eget tempo. Dette er lektion 4 af 4.
Hvor lang tid tager lektionen “Håndtering af typeløse tredjepartsbiblioteker”?
De fleste CoddyKit-lektioner tager cirka 5–10 minutter. Hver lektion er kort og interaktiv, så du gør løbende fremskridt og kan fortsætte, hvor du slap – på både web og app.
Kan jeg skrive og køre kode i denne TypeScript Academy-lektion?
Ja. Alle TypeScript Academy-lektioner har en indbygget kodeeditor, så du kan skrive og køre rigtig kode direkte i din browser og få øjeblikkelig feedback fra AI – uden lokal opsætning.
Alle lektioner i dette kursus
- Start på migreringen: allowJs og checkJs
- JSDoc-typeannoteringer som overgang
- Strategi for konvertering fil for fil
- Håndtering af typeløse tredjepartsbiblioteker