Halo Sobat IT!

Pernah mengalami aplikasi yang berjalan normal di laptop, tetapi bermasalah setelah di-deploy? Tombol tidak merespons, login gagal, atau halaman terus memuat tanpa hasil. Anehnya, ketika dicoba kembali di lingkungan lokal, masalah tersebut justru tidak muncul. Kondisi ini membuat debugging lebih sulit karena penyebabnya bisa berasal dari perubahan kondisi halaman, response API, konfigurasi lingkungan, atau skenario tertentu yang sulit direproduksi.

Salah satu cara menelusurinya adalah dengan merekam jalannya pengujian menggunakan Playwright Trace Viewer. Bukan sekadar screenshot, tetapi Rekaman Pengujian Playwright merupakan framework untuk mengotomatisasi pengujian aplikasi web, mulai dari membuka halaman hingga memeriksa hasil interaksi pengguna. Sementara itu, Playwright Trace Viewer membantu developer memeriksa kembali rekaman pengujian yang gagal. Informasi yang tersedia dapat mencakup urutan aksi, snapshot DOM, screenshot, log, dan aktivitas jaringan, bergantung pada konfigurasi perekaman. Tool ini dapat diakses melalui Playwright Trace Viewer.

Apa yang Bisa Diperiksa?

  1. Action Timeline: Menelusuri Urutan Kejadian
    Developer dapat melihat urutan aksi selama pengujian untuk mengetahui langkah yang gagal dan kejadian sebelumnya. Misalnya, pengujian berhasil membuka halaman login dan mengisi formulir, tetapi gagal menampilkan dashboard. Dengan menelusuri kembali urutan aksi, developer dapat mempersempit bagian yang perlu diperiksa.
  2. DOM Snapshot: Memeriksa Kondisi Halaman
    DOM (Document Object Model) merepresentasikan struktur elemen halaman web. Snapshot DOM membantu developer memeriksa kondisi halaman pada waktu tertentu. Contohnya, tombol login gagal ditekan karena dialog sesi kedaluwarsa muncul dan menutupinya. Tanpa memeriksa kondisi halaman, developer mungkin justru memperbaiki kode tombol yang sebenarnya tidak bermasalah.
  3. Network Panel: Menelusuri Request API
    Masalah tidak selalu berasal dari antarmuka. Tombol bisa berfungsi, tetapi request API gagal diproses. Panel Network membantu memeriksa request yang tercatat, seperti metode HTTP, status, durasi, serta detail request atau response yang tersedia. Misalnya, request POST /api/login menghasilkan 401 Unauthorized. Developer perlu memeriksa autentikasi atau kredensial, bukan langsung menyimpulkan bahwa tombol login rusak. Jika request gagal karena koneksi, penyelidikannya tentu berbeda.
  4. Console dan Error Log: Mencari Petunjuk
    Pesan error JavaScript dan log pengujian dapat membantu mempersempit penyebab kegagalan. Ketika halaman tidak menampilkan hasil setelah tombol ditekan, misalnya, error JavaScript yang terekam bisa menjadi petunjuk bahwa proses rendering terhenti. Namun, informasi yang tersedia tetap bergantung pada data yang berhasil direkam.

Cara Mencobanya

  1. Playwright Trace Viewer tidak otomatis merekam aktivitas website hanya dengan memasukkan URL. Developer perlu menjalankan pengujian Playwright dan mengaktifkan perekaman trace.
  2. Siapkan Playwright
    Untuk proyek Node.js, jalankan:
    npm init playwright@latest
    Ikuti petunjuk instalasi yang muncul.
  3. Aktifkan perekaman trace
    Pada playwright.config.ts, gunakan konfigurasi berikut:
    import { defineConfig } from '@playwright/test';
    export default defineConfig({
      retries: 1,
     use: {
    trace: 'on-first-retry',
     },
    });
    Konfigurasi tersebut merekam trace pada percobaan ulang pertama setelah pengujian gagal, sehingga tidak semua pengujian perlu direkam.
  4. Jalankan pengujian
    npx playwright test
    Jika pengujian gagal dan dijalankan ulang, trace dapat dihasilkan sesuai konfigurasi.
  5. Periksa hasilnya
    Jalankan laporan HTML:
    npx playwright show-report
    Buka pengujian yang gagal, lalu pilih trace yang tersedia. Alternatifnya, buka Trace Viewer dan muat berkas trace, biasanya bernama trace.zip.
    Pilih aksi yang gagal, periksa kondisi halaman, lalu cocokkan dengan log dan aktivitas jaringan untuk menemukan petunjuk penyebabnya.

Batasan dan Keamanan

Meskipun membantu proses investigasi, Playwright Trace Viewer memiliki beberapa batasan:

  • Memerlukan rekaman pengujian. Tool ini tidak otomatis mengakses aktivitas pengunjung website atau log internal server.
  • Tidak otomatis menemukan akar masalah. Developer tetap perlu menganalisis bukti yang tersedia.
  • Tidak menggantikan observabilitas backend. Masalah database, server, atau layanan eksternal mungkin membutuhkan log backend, metrik, dan distributed tracing.
  • Tidak selalu menangkap bug production. Jika skenario pemicu masalah tidak tercakup dalam pengujian, trace mungkin tidak merekam kegagalan tersebut.
  • Berpotensi memuat data sensitif. Trace dapat berisi informasi halaman, request, response, atau data pengujian.

Menurut dokumentasi Playwright, Trace Viewer berbasis browser memproses berkas trace secara lokal di browser. Namun, ini tidak berarti isi berkas otomatis aman untuk dibagikan. Gunakan data pengujian yang tidak sensitif dan batasi akses terhadap trace, terutama jika berkaitan dengan sistem internal atau akun perusahaan. Pengujian terhadap website milik pihak lain juga harus dilakukan dengan izin yang sesuai.

Penutup

Bug yang sulit direproduksi tetap bisa ditelusuri jika developer memiliki rekaman pengujian yang relevan. Playwright Trace Viewer membantu memeriksa urutan aksi, kondisi halaman, dan komunikasi jaringan agar proses debugging tidak sekadar mengandalkan tebakan. Namun, hasil terbaik diperoleh dengan menggabungkannya bersama pengujian otomatis dan observabilitas backend. Trace membantu menelusuri perilaku browser, sedangkan log dan metrik server membantu mengungkap masalah di sisi backend.

Semoga artikel ini membantu Sobat IT memahami bahwa debugging bukan sekadar membaca pesan error, tetapi menelusuri bukti untuk menemukan penyebab dan menentukan perbaikan yang tepat.