Mendebug kode asli Anda, bukan di-deploy dengan peta sumber

Meggin Kearney
Meggin Kearney
Paul Bakaus
Paul Bakaus
Sofia Emelianova
Sofia Emelianova

Buat kode sisi klien tetap dapat dibaca dan di-debug bahkan setelah Anda menggabungkan, meminifikasi, atau mengompilasinya. Gunakan peta sumber untuk memetakan kode sumber ke kode yang dikompilasi di panel Sumber.

Mulai menggunakan praprosesor

Peta sumber dari praprosesor menyebabkan DevTools memuat file asli Anda di samping yang diminifikasi.

Chrome akan menjalankan kode yang diminifikasi, tetapi panel Sumber akan menunjukkan kode yang Anda tulis. Anda bisa menyetel titik henti sementara dan menelusuri kode dalam file sumber dan semua error, log, serta titik henti sementara akan dipetakan secara otomatis.

Ini akan memberi Anda tampilan men-debug kode saat Anda menulisnya, berbeda dengan kode yang disediakan oleh server pengembangan dan dieksekusi oleh browser.

Untuk menggunakan peta sumber di panel Sumber:

  • Hanya gunakan praprosesor yang dapat menghasilkan peta sumber.
  • Verifikasi bahwa server web Anda dapat menyajikan peta sumber.

Menggunakan praprosesor yang didukung

Praprosesor umum yang digunakan bersama dengan peta sumber termasuk, tetapi tidak terbatas pada:

Untuk daftar yang diperluas, lihat Peta sumber: Bahasa, alat, dan info lainnya.

Aktifkan peta sumber di Setelan

Di Setelan. Setelan > Preferensi > Sumber, pastikan untuk mencentang Kotak centang. Aktifkan peta sumber JavaScript.

Periksa apakah peta sumber berhasil dimuat

Lihat Referensi Developer: Melihat dan memuat peta sumber secara manual.

Proses debug dengan peta sumber

Dengan peta sumber siap dan diaktifkan, Anda dapat melakukan hal berikut:

  1. Buka sumber situs Anda di panel Sumber.
  2. Untuk berfokus hanya pada kode yang Anda tulis, kelompokkan file yang ditulis dan di-deploy di hierarki file. Lalu, luaskan bagian Ditulis. Authored dan buka file sumber asli di Editor.

    File asli dibuka di bagian Ditulis.

  3. Tetapkan titik henti sementara seperti biasa. Misalnya, logpoint. Kemudian jalankan kodenya.

    Logpoint yang disetel dalam file yang ditulis.

  4. Perhatikan bahwa Editor menempatkan link ke file yang di-deploy di status bar di bagian bawah. Hal yang sama berlaku untuk file CSS yang di-deploy.

    Link ke file CSS yang di-deploy di status bar.

  5. Buka panel samping Konsol. Dalam contoh ini, di samping pesan logpoint, Console menampilkan link ke file asli, bukan yang di-deploy.

    Pesan Konsol dengan link ke file asli.

  6. Ubah jenis titik henti sementara menjadi jenis titik henti sementara dan jalankan kode lagi. Eksekusi dijeda kali ini.

    Eksekusi dijeda pada titik henti sementara reguler.

    Perhatikan bahwa panel Call Stack menampilkan nama file asli, bukan yang di-deploy.

  7. Pada status bar di bagian bawah Editor, klik link ke file yang di-deploy. Panel Sources mengarahkan Anda ke file yang sesuai.

File yang di-deploy dengan komentar sourceMappingURL.

Saat Anda membuka file yang di-deploy, DevTools akan memberi tahu Anda jika komentar //# sourceMappingURL dan file asli terkait ditemukan.

Perhatikan bahwa Editor secara otomatis mencetak file yang di-deploy. Pada kenyataannya, kode ini berisi semua kode dalam satu baris, kecuali untuk komentar //# sourceMappingURL.

Beri nama panggilan eval() dengan #sourceURL

#sourceURL memungkinkan Anda menyederhanakan proses debug saat menangani panggilan eval(). Helper ini terlihat sangat mirip dengan properti //# sourceMappingURL. Untuk informasi selengkapnya, lihat spesifikasi Source Map V3.

Komentar //# sourceURL=/path/to/source.file memberi tahu browser untuk mencari file sumber saat Anda menggunakan eval(). Hal ini membantu Anda memberi nama evaluasi serta skrip dan gaya inline.

Uji pada halaman demo ini:

  1. Buka DevTools dan buka panel Sources.
  2. Di halaman, masukkan nama file arbitrer ke dalam kolom input Name your code:.
  3. Klik tombol Compile. Notifikasi akan muncul dengan jumlah yang dievaluasi dari sumber CoffeeScript.
  4. Pada hierarki file di panel Halaman, buka file baru dengan nama file kustom yang Anda masukkan. File ini berisi kompilasi kode JavaScript yang memiliki komentar // #sourceURL dengan nama asli file sumber.
  5. Untuk membuka file sumber, klik link di status bar Editor.

Komentar sourceURL dan link ke file sumber di status bar.