JavaScript Debug

Kayce Basques

Sofia Emelianova

Tutorial ini mengajarkan alur kerja dasar untuk men-debug masalah JavaScript di DevTools. Baca lanjutan, atau tonton versi video tutorial ini.

Mereproduksi bug

Menemukan serangkaian tindakan yang secara konsisten mereproduksi bug selalu menjadi langkah pertama untuk proses debug.

1. Buka demo ini di tab baru.
2. Masukkan 5 di kotak Nomor 1.
3. Masukkan 1 di kotak Nomor 2.
4. Klik Tambahkan Nomor 1 dan Nomor 2. Label di bawah tombol bertuliskan 5 + 1 = 51. Hasilnya harus 6. Ini adalah bug yang akan Anda perbaiki.

Dalam contoh ini, hasil dari 5 + 1 adalah 51. Seharusnya 6.

Memahami UI panel Sumber

DevTools menyediakan banyak alat yang berbeda untuk berbagai tugas, seperti mengubah CSS, membuat profil performa muat halaman, dan memantau permintaan jaringan. Panel Sumber adalah tempat Anda men-debug JavaScript.

1. Buka DevTools, lalu buka panel Sources.

   

Panel Sumber memiliki tiga bagian:

1. Tab Halaman dengan hierarki file. Setiap file yang diminta halaman tercantum di sini.
2. Bagian Code Editor. Setelah memilih file di tab Halaman, isi file tersebut akan ditampilkan di sini.

3. Bagian Debugger. Berbagai alat untuk memeriksa JavaScript halaman.

   Jika jendela DevTools Anda lebar, secara default, Debugger akan berada di sebelah kanan Code Editor. Dalam hal ini, tab Cakupan dan Pantau bergabung dengan Titik henti sementara, Stack panggilan, dan lainnya sebagai bagian yang dapat diciutkan.

Menjeda kode dengan titik henti sementara

Metode umum untuk men-debug masalah seperti ini adalah dengan menyisipkan banyak pernyataan console.log() ke dalam kode, untuk memeriksa nilai saat skrip dieksekusi. Contoh:

function updateLabel() {
  var addend1 = getNumber1();
  console.log('addend1:', addend1);
  var addend2 = getNumber2();
  console.log('addend2:', addend2);
  var sum = addend1 + addend2;
  console.log('sum:', sum);
  label.textContent = addend1 + ' + ' + addend2 + ' = ' + sum;
}

Metode console.log() dapat menyelesaikan tugas, tetapi breakpoints dapat menyelesaikannya lebih cepat. Titik henti sementara memungkinkan Anda menjeda kode di tengah eksekusi, dan memeriksa semua nilai pada saat itu. Titik henti sementara memiliki beberapa keunggulan dibandingkan metode console.log():

• Dengan console.log(), Anda harus membuka kode sumber secara manual, menemukan kode yang relevan, menyisipkan pernyataan console.log(), lalu memuat ulang halaman untuk melihat pesan di Konsol. Dengan titik henti sementara, Anda dapat menjeda kode yang relevan tanpa mengetahui cara kode tersebut distrukturisasi.
• Dalam pernyataan console.log(), Anda harus menentukan setiap nilai yang ingin Anda periksa secara eksplisit. Dengan titik henti sementara, DevTools akan menampilkan nilai semua variabel pada saat itu. Terkadang ada variabel yang memengaruhi kode Anda tanpa Anda sadari.

Singkatnya, titik henti sementara dapat membantu Anda menemukan dan memperbaiki bug lebih cepat daripada metode console.log().

Jika Anda mundur sejenak dan memikirkan cara kerja aplikasi, Anda dapat membuat tebakan yang tepat bahwa jumlah yang salah (5 + 1 = 51) dihitung di pemroses peristiwa click yang terkait dengan tombol Tambahkan Angka 1 dan Angka 2. Oleh karena itu, sebaiknya Anda menjeda kode sekitar waktu pemroses click dijalankan. Titik Henti Sementara Pemroses Peristiwa memungkinkan Anda melakukan hal tersebut:

1. Di bagian Debugger, klik Event Listener Breakpoints untuk meluaskan bagian tersebut. DevTools menampilkan daftar kategori peristiwa yang dapat diluaskan, seperti Animasi dan Papan klip.
2. Di samping kategori peristiwa Mouse, klik arrow_right Expand. DevTools menampilkan daftar peristiwa mouse, seperti click dan mousedown. Setiap peristiwa memiliki kotak centang di sampingnya.

3. Centang kotak klik. DevTools kini disiapkan untuk otomatis dijeda saat pemroses peristiwa click apa pun dieksekusi.

   

4. Kembali ke demo, klik Tambahkan Nomor 1 dan Nomor 2 lagi. DevTools menjeda demo dan menandai baris kode di panel Sumber. DevTools harus dijeda pada baris kode ini:

   function onClick() {
   

   Jika Anda dijeda di baris kode yang berbeda, tekan lanjutkan Lanjutkan Eksekusi Skrip hingga Anda dijeda di baris yang benar.

   Catatan: Jika Anda menjeda di baris lain, Anda memiliki ekstensi browser yang mendaftarkan pemroses peristiwa click di setiap halaman yang Anda kunjungi. Anda dijeda di pemroses click ekstensi. Jika menggunakan Mode Samaran untuk menjelajah secara rahasia, yang menonaktifkan semua ekstensi, Anda dapat melihat bahwa Anda menjeda di baris kode yang benar setiap saat.

Titik Henti Sementara Pemroses Peristiwa hanyalah salah satu dari banyak jenis titik henti sementara yang tersedia di DevTools. Sebaiknya pelajari semua jenisnya, karena setiap jenis pada akhirnya membantu Anda men-debug berbagai skenario secepat mungkin. Lihat Menjeda Kode dengan Titik Henti Sementara untuk mempelajari kapan dan cara menggunakan setiap jenis.

Melewati kode

Salah satu penyebab umum bug adalah saat skrip dieksekusi dalam urutan yang salah. Dengan menelusuri kode, Anda dapat mempelajari eksekusi kode, satu baris pada satu waktu, dan mengetahui dengan tepat tempat kode dieksekusi dalam urutan yang berbeda dari yang Anda harapkan. Coba sekarang:

1. Di panel Sumber DevTools, klik step_into Masuk ke panggilan fungsi berikutnya untuk melangkah melalui eksekusi fungsi onClick(), satu baris pada satu waktu. DevTools menandai baris kode berikut:

   if (inputsAreEmpty()) {
   

2. Klik step_over Step over next function call.

   DevTools menjalankan inputsAreEmpty() tanpa masuk ke dalamnya. Perhatikan bagaimana DevTools melewati beberapa baris kode. Hal ini karena inputsAreEmpty() dievaluasi menjadi salah, sehingga blok kode pernyataan if tidak dijalankan.

Itulah ide dasar untuk menelusuri kode. Jika melihat kode di get-started.js, Anda dapat melihat bahwa bug mungkin ada di suatu tempat dalam fungsi updateLabel(). Daripada menelusuri setiap baris kode, Anda dapat menggunakan jenis titik henti sementara lain untuk menjeda kode lebih dekat ke kemungkinan lokasi bug.

Menetapkan titik henti sementara baris kode

Titik henti sementara baris kode adalah jenis titik henti sementara yang paling umum. Jika Anda memiliki baris kode tertentu yang ingin dijeda, gunakan titik henti sementara baris kode:

1. Lihat baris kode terakhir di updateLabel():

   label.textContent = addend1 + ' + ' + addend2 + ' = ' + sum;
   

2. Di sebelah kiri kode, Anda dapat melihat nomor baris dari baris kode tertentu ini, yaitu 32. Klik 32. DevTools menempatkan ikon biru di atas 32. Ini berarti ada titik henti sementara baris kode pada baris ini. DevTools kini selalu dijeda sebelum baris kode ini dijalankan.

3. Klik lanjutkan Lanjutkan eksekusi skrip. Skrip akan terus dieksekusi hingga mencapai baris 32. Pada baris 29, 30, dan 31, DevTools menampilkan nilai addend1, addend2, dan sum secara inline di samping deklarasinya.

Dalam contoh ini, DevTools dijeda pada titik henti sementara baris kode di baris 32.

Memeriksa nilai variabel

Nilai addend1, addend2, dan sum terlihat mencurigakan. Nilai ini diapit tanda kutip, yang berarti nilai tersebut adalah string. Ini adalah hipotesis yang baik untuk menjelaskan penyebab bug. Sekarang saatnya mengumpulkan informasi lebih lanjut. DevTools menyediakan banyak alat untuk memeriksa nilai variabel.

Metode 1: Memeriksa Cakupan

Saat Anda menjeda di baris kode, tab Cakupan akan menampilkan variabel lokal dan global yang ditentukan pada tahap eksekusi ini, beserta nilai setiap variabel. Laporan ini juga menampilkan variabel penutupan, jika berlaku. Jika Anda tidak dijeda pada baris kode, tab Cakupan akan kosong.

Klik dua kali nilai variabel untuk mengeditnya.

Catatan: Bergantung pada preferensi tata letak dan lebar jendela DevTools, tab Cakupan dapat muncul sebagai bagian yang dapat diciutkan bersama dengan Titik henti sementara dan Stack panggilan.

Metode 2: Ekspresi watch

Tab Watch memungkinkan Anda memantau nilai variabel dari waktu ke waktu. Watch tidak hanya terbatas pada variabel. Anda dapat menyimpan ekspresi JavaScript yang valid di tab Watch.

Catatan: Bergantung pada preferensi tata letak dan lebar jendela DevTools, tab Watch dapat muncul sebagai bagian yang dapat diciutkan bersama dengan Breakpoints dan Call stack.

Coba sekarang:

1. Klik tab Tonton.
2. Klik tambahkan Tambahkan ekspresi watch.
3. Ketik typeof sum.
4. Tekan Enter. DevTools menampilkan typeof sum: "string". Nilai di sebelah kanan titik dua adalah hasil ekspresi Anda.

Screenshot ini menampilkan tab Watch (kanan bawah) setelah membuat ekspresi watch typeof sum.

Seperti yang diduga, sum dievaluasi sebagai string, padahal seharusnya berupa angka. Sekarang Anda telah mengonfirmasi bahwa ini adalah penyebab bug.

Metode 3: Konsol

Selain melihat pesan console.log(), Anda juga dapat menggunakan Konsol untuk mengevaluasi pernyataan JavaScript arbitrer. Dalam hal proses debug, Anda dapat menggunakan Konsol untuk menguji kemungkinan perbaikan untuk bug. Coba sekarang:

1. Jika panel samping Konsol tidak terbuka, tekan Escape untuk membukanya. Panel ini akan terbuka di bagian bawah jendela DevTools.
2. Di Konsol, ketik parseInt(addend1) + parseInt(addend2). Pernyataan ini berfungsi karena Anda dijeda pada baris kode tempat addend1 dan addend2 berada dalam cakupan.
3. Tekan Enter. DevTools mengevaluasi pernyataan dan mencetak 6, yang merupakan hasil yang Anda harapkan dari demo.

Screenshot ini menampilkan panel samping Konsol setelah mengevaluasi parseInt(addend1) + parseInt(addend2).

Menerapkan perbaikan

Anda telah menemukan perbaikan untuk bug tersebut. Yang tersisa hanyalah mencoba perbaikan Anda dengan mengedit kode dan menjalankan kembali demo. Anda tidak perlu keluar dari DevTools untuk menerapkan perbaikan. Anda dapat mengedit kode JavaScript langsung dalam UI DevTools. Coba sekarang:

1. Klik lanjutkan Lanjutkan eksekusi skrip.
2. Di Editor Kode, ganti baris 31, var sum = addend1 + addend2, dengan var sum = parseInt(addend1) + parseInt(addend2).
3. Tekan Command + S (Mac) atau Control + S (Windows, Linux) untuk menyimpan perubahan.
4. Klik label_off Nonaktifkan titik henti sementara. Warnanya berubah menjadi biru untuk menunjukkan bahwa tombol tersebut aktif. Saat ini ditetapkan, DevTools akan mengabaikan titik henti sementara yang telah Anda tetapkan.
5. Coba demo dengan nilai yang berbeda. Demo sekarang menghitung dengan benar.

Perhatian: Alur kerja ini hanya menerapkan perbaikan pada kode yang berjalan di browser Anda. Tindakan ini tidak akan memperbaiki kode untuk semua pengguna yang mengunjungi halaman Anda. Untuk melakukannya, Anda harus memperbaiki kode yang ada di server. Namun, Anda dapat mengedit file di DevTools dan menyimpannya ke sumber dengan Workspace.

Tips: Mulai Chrome versi 105, Anda dapat Mengedit fungsi yang dijeda secara langsung.

Langkah berikutnya

Berhasil: Selamat! Sekarang Anda tahu cara memaksimalkan Chrome DevTools saat men-debug JavaScript. Alat dan metode yang Anda pelajari dalam tutorial ini dapat menghemat waktu Anda.

Tutorial ini hanya menunjukkan dua cara untuk menetapkan titik henti sementara. DevTools menawarkan banyak cara lain, termasuk:

• Titik henti sementara bersyarat yang hanya dipicu saat kondisi yang Anda berikan bernilai benar.
• Titik henti sementara pada pengecualian yang tertangkap atau tidak tertangkap.
• Titik henti sementara XHR yang dipicu saat URL yang diminta cocok dengan substring yang Anda berikan.

Lihat Menjeda Kode dengan Titik Henti Sementara untuk mempelajari kapan dan cara menggunakan setiap jenis.

Ada beberapa kontrol langkah kode yang tidak dijelaskan dalam tutorial ini. Lihat Lewati baris kode untuk mempelajari lebih lanjut.