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

Meggin Kearney
Meggin Kearney
Sofia Emelianova
Sofia Emelianova

Pastikan kode sisi klien Anda tetap dapat dibaca dan di-debug, bahkan setelah Anda menggabungkan, mengecilkan, atau mengompilasinya. Gunakan peta sumber untuk memetakan kode sumber ke kompilasi kode di panel Sumber.

Memulai praprosesor

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

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

Hal ini memberi Anda tampilan untuk men-debug kode saat Anda menulisnya, bukan kode yang disajikan oleh server pengembangan Anda dan dieksekusi oleh browser.

Untuk menggunakan peta sumber di panel Sumber:

  • Hanya gunakan praprosesor yang dapat menghasilkan peta sumber.
  • Memverifikasi bahwa server web Anda dapat menayangkan peta sumber.

Menggunakan praprosesor yang didukung

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

Untuk melihat 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

Setelah peta sumber siap dan diaktifkan, Anda dapat melakukan hal-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. Kemudian, luaskan bagian Ditulis. Authored dan buka file sumber asli Anda di Editor.

    File asli dibuka di bagian Ditulis.

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

    Logpoint yang ditetapkan dalam file yang ditulis.

  4. Perhatikan bahwa Editor menempatkan link ke file yang di-deploy pada status bar di bagian bawah. Demikian pula, hal ini 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 akan menampilkan link ke file asli, bukan ke file yang di-deploy.

    Pesan Konsol dengan link ke file asli.

  6. Ubah jenis titik henti sementara menjadi jenis titik henti sementara, lalu jalankan kode lagi. Eksekusi akan dijeda kali ini.

    Eksekusi dijeda pada titik henti sementara biasa.

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

  7. Pada status bar di bagian bawah Editor, klik link ke file yang di-deploy. Panel Sumber akan 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, kolom 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 Peta Sumber 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 di halaman demo ini:

  1. Buka DevTools lalu buka panel Sources.
  2. Di halaman tersebut, 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.