TypeScript Academy · Pelajaran

Menangani Pustaka Pihak Ketiga Tanpa Tipe

Gunakan paket @types dan tulis deklarasi secara manual.

Menangani Pustaka Pihak Ketiga Tanpa Tipe adalah pelajaran TypeScript Academy gratis di CoddyKit. Ini adalah pelajaran 4 dari 4. Kamu bisa membaca pelajaran lengkapnya di bawah secara gratis — lalu praktikkan langsung di browser dengan editor kode bawaan dan tutor AI 24/7. Ini adalah bagian dari jalur belajar TypeScript Academy, dan progresmu tersinkronisasi di web dan aplikasi CoddyKit. Kursus TypeScript Academy mencakup 4 pelajaran total.

Masalahnya: Tipe yang Hilang

Beberapa paket npm tidak menyertakan deklarasi TypeScript dan tidak memiliki paket @types/. Secara bawaan, TypeScript memperlakukannya sebagai any, sehingga keamanan tipe pada batas tersebut hilang.

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

Paket @types

Proyek DefinitelyTyped menyediakan deklarasi tipe yang dikelola komunitas 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 Berkas Deklarasi (.d.ts)

Jika tidak ada paket @types, tulis berkas deklarasi minimal dalam proyek Anda untuk mendeklarasikan modul dan tipenya.

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

Augmentasi Modul

Perluas tipe pihak ketiga yang sudah ada dengan menambahkan deklarasi Anda sendiri ke modul yang ada tanpa membuat percabangan baru.

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

Deklarasi Modul Karakter Pengganti

Untuk seluruh kategori impor tanpa tipe, misalnya berkas aset, gunakan deklarasi modul dengan karakter pengganti.

// 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 Tipe

Dengan noImplicitAny: true, mengimpor modul tanpa tipe menyebabkan kesalahan kompilasi. Gunakan berkas deklarasi atau nonaktifkan noImplicitAny per berkas dengan // @ts-ignore.

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

Berkontribusi ke DefinitelyTyped

Jika Anda menulis tipe berkualitas tinggi untuk pustaka tanpa tipe, kirimkan tipe tersebut ke DefinitelyTyped untuk membantu komunitas.

# 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

Ketika Anda tidak dapat memperoleh tipe dengan cepat, gunakan any eksplisit disertai komentar yang melacak utang tersebut. Ini lebih baik daripada any implisit karena penggunaannya disengaja dan terlihat.

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

skipLibCheck untuk Kesalahan Deklarasi

Jika berkas .d.ts pihak ketiga memiliki kesalahan internal, skipLibCheck: true membungkamnya tanpa memengaruhi pemeriksaan tipe Anda sendiri.

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

Pembungkus Tipe untuk Pustaka Tidak Aman

Tulis modul pembungkus bertipe di sekitar pustaka tanpa tipe untuk membatasi penggunaan any dan menyediakan API bertipe yang aman bagi seluruh basis kode 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 Tipe

Tangani pustaka tanpa tipe: periksa paket @types/ terlebih dahulu, tulis berkas deklarasi minimal, gunakan augmentasi modul, buat pembungkus bertipe, dan gunakan skipLibCheck untuk kesalahan deklarasi dalam dependensi.

Pemeriksaan Singkat

Di mana tempat pertama untuk mencari deklarasi tipe bagi paket npm tanpa tipe?

Yang Anda Pelajari

Pustaka tanpa tipe: periksa paket @types/, tulis berkas deklarasi, perluas tipe yang ada, gunakan deklarasi modul dengan karakter pengganti, bungkus pustaka yang tidak aman dalam fasad bertipe, dan gunakan skipLibCheck untuk kesalahan dependensi.

Pertanyaan yang Sering Diajukan

Apakah pelajaran “Menangani Pustaka Pihak Ketiga Tanpa Tipe” gratis?

Ya — teks lengkap “Menangani Pustaka Pihak Ketiga Tanpa Tipe” gratis dibaca di sini di web. Untuk praktiknya secara interaktif (editor kode bawaan dan tutor AI 24/7) dan buka sisa kursus TypeScript Academy, upgrade ke CoddyKit PRO. Kursus TypeScript Academy mencakup 4 pelajaran total.

Apa yang akan aku pelajari di “Menangani Pustaka Pihak Ketiga Tanpa Tipe”?

Gunakan paket @types dan tulis deklarasi secara manual. Kamu berlatih TypeScript Academy dengan kode praktik yang langsung kamu jalankan di browser, dan tutor AI 24/7 menjawab pertanyaanmu saat kamu mengerjakan pelajaran ini.

Apakah aku perlu pengalaman untuk memulai TypeScript Academy?

Tidak diperlukan pengalaman sebelumnya. TypeScript Academy di CoddyKit dirancang untuk pemula hingga pelajar tingkat lanjut, jadi kamu bisa memulai di sini atau dari awal dan belajar sesuai kecepatan kamu sendiri. Ini adalah pelajaran 4 dari 4.

Berapa lama pelajaran “Menangani Pustaka Pihak Ketiga Tanpa Tipe” memakan waktu?

Sebagian besar pelajaran CoddyKit memakan waktu sekitar 5–10 menit. Setiap pelajaran ringkas dan interaktif, jadi kamu membuat kemajuan stabil dan melanjutkan dari tempat kamu tinggalkan di web dan aplikasi.

Bisakah aku menulis dan menjalankan kode dalam pelajaran TypeScript Academy ini?

Ya. Setiap pelajaran TypeScript Academy menyertakan editor kode bawaan, jadi kamu menulis dan menjalankan kode nyata langsung di browser dan mendapatkan umpan balik AI instan — tidak diperlukan penyiapan lokal.

Semua pelajaran dalam kursus ini

Memulai Migrasi: allowJs dan checkJs
Anotasi Tipe JSDoc sebagai Penghubung
Strategi Konversi File demi File
Menangani Pustaka Pihak Ketiga Tanpa Tipe

← Kembali ke TypeScript Academy