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

Meggin Kearney
Meggin Kearney
Sofia Emelianova
Sofia Emelianova

Pastikan kode sisi klien Anda dapat dibaca dan di-debug meskipun setelah Anda menggabungkan, meminifikasi, atau mengompilasi kode tersebut. Gunakan peta sumber untuk memetakan kode sumber ke kode yang dikompilasi di panel Sumber.

Mulai menggunakan preprocessor

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

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

Hal ini memberi Anda tampilan proses debug kode saat Anda menulisnya, bukan kode yang ditayangkan oleh server pengembangan dan dijalankan oleh browser.

Untuk menggunakan peta sumber di panel Sumber:

  • Hanya gunakan preprocessor yang dapat menghasilkan peta sumber.
  • Pastikan server web Anda dapat menayangkan peta sumber.

Menggunakan preprocessor yang didukung

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

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

Mengaktifkan peta sumber di Setelan

Di Setelan. Setelan > Preferensi > Sumber, pastikan untuk memeriksa Kotak centang. Peta sumber JavaScript.

Memeriksa apakah peta sumber berhasil dimuat

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

Melakukan proses debug dengan peta sumber

Dengan peta sumber yang 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 dalam hierarki file. Kemudian, luaskan bagian Authored Ditulis oleh. dan buka file sumber asli Anda di Editor.

    File asli akan terbuka di bagian Dibuat oleh.

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

    Titik log yang ditetapkan dalam file yang dibuat.

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

    Pesan Konsol dengan link ke file asli.

  6. Ubah jenis titik henti sementara menjadi jenis biasa 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 file yang di-deploy.

  7. Di 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 menemukan komentar //# sourceMappingURL dan file asli terkait.

Perhatikan bahwa Editor otomatis mencetak file yang di-deploy dengan rapi. Pada kenyataannya, file ini berisi semua kode dalam satu baris, kecuali 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 mengetahui 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 di halaman demo ini:

  1. Buka DevTools, lalu buka panel Sources.
  2. Di halaman, masukkan nama file arbitrer ke kolom input Name your code:.
  3. Klik tombol Compile. Notifikasi akan muncul dengan jumlah yang dievaluasi dari sumber CoffeeScript.
  4. Di hierarki file pada panel Halaman, buka file baru dengan nama file kustom yang Anda masukkan. File ini berisi kode JavaScript yang dikompilasi dan 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.