TypeScript Academy · Pelajaran

skipLibCheck dan Deklarasi Terisolasi

Gunakan flag compiler untuk mempercepat proyek besar.

skipLibCheck dan Deklarasi Terisolasi adalah pelajaran TypeScript Academy gratis di CoddyKit. Ini adalah pelajaran 3 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.

Apa itu skipLibCheck?

skipLibCheck: true memberi tahu TypeScript untuk melewati pemeriksaan tipe pada semua berkas deklarasi .d.ts. Opsi ini menukar keamanan dengan kecepatan.

// tsconfig.json
{
  "compilerOptions": {
    "skipLibCheck": true
  }
}

Kapan Menggunakan skipLibCheck

Gunakan opsi ini ketika berkas .d.ts pihak ketiga memiliki kesalahan yang tidak dapat Anda perbaiki, atau dalam proyek besar ketika pemeriksaan tipe pustaka mendominasi waktu kompilasi.

// Common scenario: two libraries ship conflicting .d.ts
// skipLibCheck: true silences those errors so you can focus on your code

Risiko skipLibCheck

Anda mungkin melewatkan kesalahan tipe nyata dalam berkas deklarasi yang dapat mendeteksi bug pada batas antarkomponen. Gunakan secara sadar dan aktifkan kembali secara berkala untuk memeriksa regresi.

// Risk: incorrect .d.ts in a library goes undetected
// Mitigation: enable skipLibCheck only for known-safe packages

skipDefaultLibCheck

skipDefaultLibCheck: true adalah opsi yang lebih terarah dan hanya melewati deklarasi pustaka bawaan TypeScript (lib.d.ts), bukan deklarasi pihak ketiga.

{
  "compilerOptions": {
    "skipDefaultLibCheck": true
    // Third-party .d.ts files still checked
  }
}

Apa itu Deklarasi Terisolasi?

isolatedDeclarations: true (TS 5.5+) mengharuskan setiap simbol yang diekspor memiliki anotasi tipe eksplisit, sehingga TypeScript dapat membuat deklarasi tanpa inferensi tipe penuh.

// tsconfig.json
{
  "compilerOptions": {
    "isolatedDeclarations": true
  }
}

Mengapa isolatedDeclarations Mempercepat Proses

Dengan isolatedDeclarations, deklarasi setiap berkas dapat dibuat secara independen—tanpa menganalisis bagian program lainnya. Alat pembangunan dapat menjalankan pekerjaan per berkas ini secara paralel.

// Without isolatedDeclarations:
// File A's .d.ts requires type-checking File B's return type first.
// With isolatedDeclarations:
// Each file's .d.ts generated from its explicit annotations alone.

Kesalahan: Anotasi Tipe Kembalian Tidak Ada

Ketika isolatedDeclarations aktif, fungsi yang diekspor tanpa anotasi tipe kembalian menyebabkan kesalahan kompilasi.

// Error with isolatedDeclarations: true
export function getUser(id: string) { return fetchUser(id); }

// Fix: add explicit return type
export function getUser(id: string): Promise<User> { return fetchUser(id); }

isolatedDeclarations dan Penggabung DTS

Alat seperti dts-buddy dan oxc memanfaatkan isolatedDeclarations untuk membuat bundel deklarasi jauh lebih cepat daripada tsc.

# oxc with isolatedDeclarations for fast .d.ts generation
npx oxc-transform ./src --declarations

Menggabungkan Kedua Opsi

Untuk performa maksimum dalam monorepo besar: gunakan skipLibCheck: true untuk mengabaikan kesalahan deklarasi pihak ketiga, dan isolatedDeclarations: true untuk pembuatan deklarasi secara paralel.

{
  "compilerOptions": {
    "skipLibCheck": true,
    "isolatedDeclarations": true
  }
}

Jalur Migrasi

Mengaktifkan isolatedDeclarations pada basis kode yang sudah ada memerlukan penambahan anotasi tipe kembalian pada setiap fungsi yang diekspor. Gunakan ts-migrate atau perbaikan otomatis ESLint untuk melakukannya dalam skala besar.

# ESLint rule to auto-add return types:
# @typescript-eslint/explicit-function-return-type

Rangkuman: skipLibCheck dan Deklarasi Terisolasi

skipLibCheck melewati pemeriksaan tipe .d.ts demi kecepatan. isolatedDeclarations mengharuskan anotasi eksplisit untuk memungkinkan pembuatan deklarasi secara paralel dan per berkas—faktor penting untuk alat yang lebih cepat.

Pemeriksaan Singkat

Apa yang diwajibkan oleh isolatedDeclarations: true?

Yang Anda Pelajari

skipLibCheck meningkatkan kecepatan dengan mengabaikan kesalahan deklarasi pihak ketiga. isolatedDeclarations mengharuskan tipe kembalian eksplisit pada ekspor, sehingga memungkinkan pembuatan deklarasi per berkas secara paralel dan alur kerja alat yang lebih cepat.

Pertanyaan yang Sering Diajukan

Apakah pelajaran “skipLibCheck dan Deklarasi Terisolasi” gratis?

Ya — teks lengkap “skipLibCheck dan Deklarasi Terisolasi” 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 “skipLibCheck dan Deklarasi Terisolasi”?

Gunakan flag compiler untuk mempercepat proyek besar. 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 3 dari 4.

Berapa lama pelajaran “skipLibCheck dan Deklarasi Terisolasi” 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

Membuat Profil Kompilasi TypeScript yang Lambat
Menghindari Operasi Tipe yang Mahal
skipLibCheck dan Deklarasi Terisolasi
Pemeriksaan Tipe di CI: Strategi dan Alat

← Kembali ke TypeScript Academy