TypeScript Academy · Pelajaran

Mengendalikan Pustaka Pihak Ketiga Tanpa Jenis

Gunakan pakej @types dan tulis deklarasi secara manual.

Pelajaran 4 daripada 413 langkah

Mengendalikan Pustaka Pihak Ketiga Tanpa Jenis ialah pelajaran TypeScript Academy percuma di CoddyKit. Ini ialah pelajaran 4 daripada 4. Anda boleh membaca keseluruhan pelajaran di bawah secara percuma — kemudian berlatih secara praktikal dalam pelayar menggunakan penyunting kod terbina dalam dan tutor kecerdasan buatan 24/7. Pelajaran ini merupakan sebahagian daripada laluan pembelajaran TypeScript Academy, dan kemajuan anda disegerakkan merentas web serta aplikasi CoddyKit. Kursus TypeScript Academy merangkumi sejumlah 4 pelajaran.

Masalah: Jenis yang Hilang

Sesetengah pakej npm tidak menyediakan pengisytiharan TypeScript dan tidak mempunyai pakej @types/. Secara lalai, TypeScript menganggapnya sebagai any, lalu menghilangkan keselamatan jenis pada sempadan tersebut.

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

Pakej @types

Projek DefinitelyTyped menyediakan pengisytiharan jenis yang diselenggara oleh komuniti untuk ribuan pustaka. Cari @types/library-name di npm.

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

Menulis Fail Pengisytiharan (.d.ts)

Jika tiada pakej @types, tulis fail pengisytiharan minimum dalam projek Anda untuk mengisytiharkan modul dan jenisnya.

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

Pelanjutan Modul

Luaskan jenis pihak ketiga sedia ada dengan menambahkan pengisytiharan Anda sendiri pada modul sedia ada tanpa membuat cabang berasingan daripadanya.

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

Pengisytiharan Modul Kad Bebas

Untuk keseluruhan kategori import tanpa jenis, contohnya fail aset, gunakan pengisytiharan modul kad bebas.

// 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 dan Pustaka Tanpa Jenis

Dengan noImplicitAny: true, mengimport modul tanpa jenis menyebabkan ralat kompilasi. Gunakan fail pengisytiharan atau nyahaktifkan noImplicitAny bagi setiap fail dengan // @ts-ignore.

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

Menyumbang kepada DefinitelyTyped

Jika Anda menulis jenis berkualiti tinggi untuk pustaka tanpa jenis, hantarkannya kepada DefinitelyTyped untuk membantu komuniti.

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

Menggunakan any sebagai Pilihan Terakhir

Apabila Anda tidak dapat mendapatkan jenis dengan segera, gunakan any yang jelas bersama komen untuk menjejaki hutang tersebut. Ini lebih baik daripada any tersirat kerana penggunaannya disengajakan dan dapat dilihat.

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

skipLibCheck untuk Ralat Pengisytiharan

Jika fail .d.ts pihak ketiga mempunyai ralat dalaman, skipLibCheck: true menyenyapkannya tanpa menjejaskan semakan jenis Anda sendiri.

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

Pembungkus Jenis untuk Pustaka Tidak Selamat

Tulis modul pembungkus berjenis di sekeliling pustaka tanpa jenis untuk mengurung any dan mendedahkan API berjenis yang selamat kepada seluruh pangkalan kod Anda.

// 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); }

Ringkasan: Pustaka Tanpa Jenis

Kendalikan pustaka tanpa jenis: semak pakej @types/ terlebih dahulu, tulis fail pengisytiharan minimum, gunakan pelanjutan modul, cipta pembungkus berjenis, dan gunakan skipLibCheck untuk ralat pengisytiharan dalam kebergantungan.

Semakan Ringkas

Di manakah tempat pertama untuk mencari pengisytiharan jenis bagi pakej npm tanpa jenis?

Jawab dalam pelajaran interaktif

Perkara yang Dipelajari

Pustaka tanpa jenis: semak pakej @types/, tulis fail pengisytiharan, luaskan jenis sedia ada, gunakan pengisytiharan modul kad bebas, bungkus pustaka tidak selamat dalam fasad berjenis, dan gunakan skipLibCheck untuk ralat kebergantungan.

Percuma untuk bermula

Pelajari TypeScript dengan tutor kecerdasan buatan — percuma

Tulis dan jalankan kod sebenar dalam pelayar anda, dapatkan bantuan segera daripada tutor kecerdasan buatan yang tersedia 24/7, dan sambung semula dari tempat anda berhenti di web atau dalam aplikasi.

Kursus: 101
Pelajaran: 352

Mula belajar secara percuma Lihat kursus penuh

Soalan Lazim

Adakah pelajaran “Mengendalikan Pustaka Pihak Ketiga Tanpa Jenis” percuma?

Ya — teks penuh “Mengendalikan Pustaka Pihak Ketiga Tanpa Jenis” boleh dibaca secara percuma di web ini. Untuk berlatih secara interaktif menggunakan penyunting kod terbina dalam dan tutor kecerdasan buatan 24/7, serta membuka kunci baki kursus TypeScript Academy, tingkat taraf kepada CoddyKit PRO. Kursus TypeScript Academy merangkumi sejumlah 4 pelajaran.

Apakah yang akan saya pelajari dalam “Mengendalikan Pustaka Pihak Ketiga Tanpa Jenis”?

Gunakan pakej @types dan tulis deklarasi secara manual. Anda berlatih TypeScript Academy menggunakan kod praktikal yang dijalankan terus dalam pelayar, manakala tutor kecerdasan buatan 24/7 menjawab soalan anda semasa anda mengikuti pelajaran.

Adakah saya memerlukan pengalaman untuk memulakan TypeScript Academy?

Tiada pengalaman terdahulu diperlukan. Pembelajaran TypeScript Academy di CoddyKit disusun untuk pelajar daripada peringkat pemula hingga lanjutan, jadi anda boleh bermula di sini atau dari awal dan belajar mengikut kadar anda sendiri. Ini ialah pelajaran 4 daripada 4.

Berapa lamakah pelajaran “Mengendalikan Pustaka Pihak Ketiga Tanpa Jenis” diambil?

Kebanyakan pelajaran CoddyKit mengambil masa kira-kira 5–10 minit. Setiap pelajaran ringkas dan interaktif, jadi anda boleh membuat kemajuan secara berterusan dan menyambung tepat dari tempat anda berhenti di web atau aplikasi.

Bolehkah saya menulis dan menjalankan kod dalam pelajaran TypeScript Academy ini?

Ya. Setiap pelajaran TypeScript Academy menyertakan penyunting kod terbina dalam, jadi anda boleh menulis dan menjalankan kod sebenar terus dalam pelayar serta menerima maklum balas kecerdasan buatan serta-merta — tanpa memerlukan persediaan setempat.

Semua pelajaran dalam kursus ini

Memulakan Migrasi: allowJs dan checkJs
Anotasi Jenis JSDoc sebagai Jambatan
Strategi Penukaran Fail demi Fail
Mengendalikan Pustaka Pihak Ketiga Tanpa Jenis

← Kembali ke TypeScript Academy