Mengkonfigurasi Watch

Kompilator mendukung konfigurasi cara mengawasi berkas dan direktori menggunakan kompilator flags di TypeScript 3.8+, dan variabel environment.

Latar Belakang

Implementasi --watch dari compiter bergantung pada penggunaan fs.watch dan fs.watchFile yang disediakan oleh node, kedua metode ini memiliki kelebihan dan kekurangan.

fs.watch menggunakan berkas system event untuk memberi tahu perubahan dalam berkas/direktori. Tetapi ini bergantung pada OS dan notifikasi tidak sepenuhnya dapat diandalkan dan tidak berfungsi seperti yang diharapkan pada banyak OS. Juga mungkin ada batasan jumlah watch yang dapat dibuat, misalnya linux dan kami dapat melakukannya dengan cukup cepat dengan program yang menyertakan banyak berkas. Tetapi karena ini menggunakan berkas system event, tidak banyak siklus CPU yang terlibat. Kompilator biasanya menggunakan fs.watch untuk melihat direktori (misalnya. Direktori sumber disertakan oleh berkas konfigurasi, direktori di mana resolusi modul gagal, dll.) Ini dapat menangani ketepatan yang hilang dalam memberi tahu tentang perubahan. Tetapi memantau secara rekursif hanya didukung pada Windows dan OSX. Artinya kita membutuhkan sesuatu untuk menggantikan sifat rekursif di OS lain.

fs.watchFile menggunakan polling dan karenanya melibatkan siklus CPU. Tetapi ini adalah mekanisme yang paling andal untuk mendapatkan pembaruan status berkas/direktori. Kompilator biasanya menggunakan fs.watchFile untuk melihat berkas sumber, berkas konfigurasi dan berkas yang hilang (referensi berkas hilang) yang berarti penggunaan CPU bergantung pada jumlah berkas dalam program.

Konfigurasi berkas watching menggunakan tsconfig.json

{
  // Beberapa opsi kompilator umumnya
  "compilerOptions": {
    "target": "es2020",
    "moduleResolution": "node"
    // ...
  },
  // BARU: Opsi untuk memantau berkas/direktori
  "watchOptions": {
    // Gunakan native berkas system events untuk berkas dan direktori
    "watchFile": "useFsEvents",
    "watchDirectory": "useFsEvents",
    // Dapatkan pembaruan berkas
    // ketika terdapat update yang besar.
    "fallbackPolling": "dynamicPriority"
  }
}

Anda dapat membacanya lebih lanjut di catatan rilis.

Konfigurasi berkas watching menggunakan variabel environment TSC_WATCHFILE

Mengonfigurasi pengawasan direktori menggunakan variabel environment TSC_WATCHDIRECTORY

Pemantauan direktori pada platform yang tidak mendukung pemantau direktori rekursif secara native di node, maka akan menggunakan opsi yang berbeda, yang dipilih olehTSC_WATCHDIRECTORY. Perlu dicatat bahwa, platform yang mendukung pemantauan direktori secara rekursif (misalnya Windows), nilai dari variabel environment tersebut akan diabaikan.