Menghentikan penggunaan peristiwa penghapusan muatan

Demián Renzulli

Barry Pollard

Dipublikasikan: 10 Agustus 2023, Terakhir diperbarui: 29 Juni 2026

Peristiwa unload akan dihentikan penggunaannya secara bertahap dengan mengubah default secara bertahap sehingga pengendali unload berhenti diaktifkan di halaman, kecuali jika halaman secara eksplisit memilih untuk mengaktifkannya kembali.

Linimasa penghentian

Kami mencatat bahwa perilaku pelepasan muatan kemungkinan akan mengalami perubahan paling cepat pada Januari 2019, saat kami mengumumkan niat kami untuk menerapkan back/forward cache. Secara paralel dengan pekerjaan penerapan, kami melakukan sosialisasi besar-besaran yang menghasilkan penurunan signifikan dalam penggunaan penghapusan muatan. Untuk melengkapi penjangkauan ini, kami juga mulai menawarkan cara untuk menguji efek penghentian penggunaan penghapusan muatan dari Chrome 115:

• Pengujian di lapangan menggunakan Permission-Policy API untuk pelepasan di Chrome 115 (Juli 2023)
• Pengujian lokal dengan mengaktifkan flag di Chrome 117 (September 2023)

Sepanjang tahun 2024, kami mengatasi beberapa masalah yang menghalangi dimulainya peluncuran dan sepanjang tahun 2025, kami meluncurkan penghentian penggunaan ini ke 50 situs teratas:

Pada tahun 2026, kami mulai meluncurkan fitur ini ke semua origin, melalui lebih dari 8 tonggak pencapaian (atau sekitar 32 minggu), seperti yang dijelaskan dalam tabel berikut.

Peluncuran penuh didasarkan pada pemuatan halaman (dengan konsistensi dari waktu ke waktu), bukan pengguna atau situs individual untuk menghindari dampak yang lebih besar pada pengguna atau situs tertentu seperti yang dijelaskan dalam Niat untuk Menghentikan Penggunaan.

Perhatikan bahwa kami juga menawarkan menu opsi penonaktifan jika linimasa penghentian ini tidak memberikan waktu yang cukup untuk bermigrasi dari peristiwa pelepasan.

Latar belakang

unload dirancang untuk diaktifkan saat dokumen sedang dibatalkan pemuatannya. Secara teori, ini dapat digunakan untuk menjalankan kode setiap kali pengguna keluar dari halaman, atau sebagai callback akhir sesi.

Skenario saat peristiwa ini paling umum digunakan meliputi:

• Menyimpan data pengguna: Simpan data sebelum meninggalkan halaman.
• Melakukan tugas pembersihan: Menutup resource yang terbuka sebelum meninggalkan halaman.
• Mengirim analisis: Mengirim data terkait interaksi pengguna di akhir sesi.

Namun, peristiwa unload sangat tidak dapat diandalkan.

Di Chrome dan Firefox versi desktop, unload cukup andal, tetapi memiliki dampak negatif pada performa situs dengan mencegah penggunaan bfcache (back/forward cache).

Di browser seluler, unload sering kali tidak berjalan karena tab sering kali dipindahkan ke latar belakang lalu dihentikan. Oleh karena itu, browser memilih untuk memprioritaskan bfcache di perangkat seluler daripada unload, sehingga bfcache menjadi lebih tidak dapat diandalkan. Safari juga menggunakan perilaku ini di desktop.

Tim Chrome yakin bahwa penggunaan model seluler untuk memprioritaskan bfcache daripada unload di desktop akan mengganggu karena membuatnya menjadi kurang andal juga, padahal sebelumnya hal ini cukup andal di Chrome (dan Firefox). Sebagai gantinya, Chrome bertujuan untuk menghapus peristiwa unload sepenuhnya. Hingga saat itu, aplikasi akan tetap andal di desktop pada Chrome bagi pengguna yang secara eksplisit memilih untuk tidak menggunakan fitur yang tidak digunakan lagi.

Mengapa peristiwa unload dihentikan penggunaannya?

Penghentian penggunaan unload adalah langkah penting dalam pengakuan yang jauh lebih besar terhadap web tempat kita tinggal saat ini. Peristiwa unload memberikan kesan kontrol yang salah atas siklus proses aplikasi yang semakin tidak sesuai dengan cara kita menjelajahi web di dunia komputasi modern.

Sistem operasi seluler sering membekukan atau membatalkan pemuatan halaman web untuk menghemat memori dan browser desktop juga semakin sering melakukan hal ini karena alasan yang sama. Bahkan tanpa intervensi sistem operasi, pengguna sendiri sering beralih tab dan menutup tab lama tanpa secara resmi "meninggalkan halaman".

Menghapus peristiwa unload yang sudah tidak berlaku adalah pengakuan bahwa kita sebagai developer web perlu memastikan paradigma kita cocok dengan dunia nyata dan tidak bergantung pada konsep usang yang tidak lagi berlaku—jika pernah berlaku.

Alternatif untuk acara unload

Sebaiknya gunakan:unload

• visibilitychange: Untuk menentukan kapan visibilitas halaman berubah. Peristiwa ini terjadi saat pengguna beralih tab, meminimalkan jendela browser, atau membuka halaman baru. Pertimbangkan hidden state sebagai waktu terakhir yang dapat diandalkan untuk menyimpan data aplikasi dan pengguna.
• pagehide: Untuk menentukan kapan pengguna keluar dari halaman. Peristiwa ini terjadi saat pengguna keluar dari halaman, memuat ulang halaman, atau menutup jendela browser. Peristiwa pagehide tidak diaktifkan saat halaman diminimalkan atau dialihkan ke tab lain. Perhatikan bahwa, karena pagehide tidak membuat halaman tidak memenuhi syarat untuk back/forward cache, halaman dapat dipulihkan setelah peristiwa ini diaktifkan. Jika Anda membersihkan resource apa pun dalam peristiwa ini, resource tersebut mungkin harus dipulihkan saat pemulihan halaman.

Peristiwa beforeunload memiliki kasus penggunaan yang sedikit berbeda dengan unload karena merupakan peristiwa yang dapat dibatalkan. Dialog ini sering digunakan untuk memperingatkan pengguna tentang perubahan yang belum disimpan saat keluar dari halaman. Peristiwa ini juga tidak dapat diandalkan karena tidak akan dipicu jika tab latar belakang ditutup. Sebaiknya batasi penggunaan beforeunload dan tambahkan hanya secara kondisional. Sebagai gantinya, gunakan peristiwa yang disebutkan sebelumnya untuk sebagian besar penggantian unload.

Untuk mengetahui detail selengkapnya, lihat saran ini tentang tidak pernah menggunakan handler unload.

Mendeteksi penggunaan unload

Ada berbagai alat untuk membantu Anda menemukan kemunculan peristiwa unload di halaman. Hal ini memungkinkan situs menemukan apakah mereka menggunakan peristiwa ini—baik dalam kode mereka sendiri, atau menggunakan library—dan oleh karena itu mungkin terpengaruh oleh penghentian penggunaan yang akan datang.

Chrome DevTools

Chrome DevTools menyertakan audit back-forward-cache untuk membantu Anda mengidentifikasi masalah yang dapat membuat halaman Anda tidak memenuhi syarat untuk back-forward cache, termasuk penggunaan handler unload.

Untuk menguji back-forward cache, ikuti langkah-langkah berikut:

1. Di halaman Anda, buka DevTools, lalu buka Application > Background services > Back/forward cache.

2. Klik Uji back-forward cache. Chrome akan otomatis mengarahkan Anda ke chrome://terms/ dan kembali ke halaman Anda. Atau, Anda dapat mengklik tombol kembali dan maju browser.

Jika halaman Anda tidak memenuhi syarat untuk back-forward cache, tab Back-forward cache akan menampilkan daftar masalah. Di bagian Dapat ditindaklanjuti, Anda dapat melihat apakah Anda menggunakan unload:

Reporting API

Reporting API dapat digunakan bersama dengan Kebijakan Izin hanya baca untuk mendeteksi penggunaan unload dari pengguna situs Anda.

Untuk mengetahui detail selengkapnya, lihat Menggunakan Reporting API untuk menemukan pelepasan

Bfcache notRestoredReasons API

Properti notRestoredReasons—yang ditambahkan ke class PerformanceNavigationTiming—melaporkan informasi tentang apakah dokumen diblokir agar tidak menggunakan bfcache pada navigasi, dan alasannya. Berikut adalah contoh tampilan peringatan objek respons dari pemroses unload yang ada:

{
   children: [],
   id: null,
   name: null,
   reasons: [
     {"reason", "unload-listener"}
   ],
   src: null,
   url: "https://www.example.com/page/"
}

Mengontrol akses ke unload

Chrome menghentikan penggunaan peristiwa unload secara bertahap. Sementara itu, Anda dapat menggunakan berbagai alat untuk mengontrol perilaku ini dan bersiap untuk penghentian penggunaan yang akan datang. Perlu diingat bahwa Anda tidak boleh mengandalkan teknik ini dalam jangka panjang, dan Anda harus berencana untuk bermigrasi ke alternatifnya sesegera mungkin.

Opsi berikut memungkinkan Anda mengaktifkan atau menonaktifkan handler unload untuk menguji cara kerja situs Anda tanpa handler tersebut sehingga Anda dapat bersiap untuk penghentian penggunaan yang akan datang. Ada berbagai jenis kebijakan:

• Permissions Policy: Ini adalah API platform bagi pemilik situs untuk mengontrol akses ke fitur, di tingkat situs atau halaman individual, menggunakan header HTTP.
• Kebijakan Enterprise: Alat bagi admin IT untuk mengonfigurasi Chrome bagi organisasi atau bisnis mereka. Kebijakan ini dapat dikonfigurasi menggunakan panel administrator, seperti Konsol Google Admin.
• Tanda Chrome: Hal ini memungkinkan developer perorangan mengubah setelan penghentian penggunaan unload untuk menguji dampaknya pada berbagai situs.

Kebijakan Izin

Kebijakan Izin ditambahkan mulai Chrome 115 untuk memungkinkan situs memilih tidak menggunakan handler unload dan langsung memanfaatkan bfcache untuk meningkatkan performa situs. Lihat contoh cara menyetelnya untuk situs Anda. Hal ini memungkinkan situs mengatasi penghentian penggunaan unload.

Diperpanjang di Chrome 117 untuk memungkinkan situs melakukan hal sebaliknya, dan memilih untuk terus mencoba memicu handler unload seperti yang mereka lakukan sekarang, karena Chrome mengubah default untuk handler ini agar tidak dipicu pada masa mendatang. Lihat contoh ini tentang cara terus mengizinkan handler pelepasan untuk diaktifkan di situs Anda. Meskipun kami mendorong pemilik situs untuk berhenti menggunakan pengendali unload karena tidak dapat diandalkan, kami berencana untuk mendukung penonaktifan ini dalam waktu yang cukup lama untuk situs yang perlu menggunakannya. Perhatikan bahwa mengaktifkan kembali tidak membuat handler unload menjadi lebih andal di perangkat seluler—tindakan ini hanya memulihkan status quo saat ini.

Kebijakan perusahaan

Perusahaan yang memiliki software yang bergantung pada peristiwa unload agar berfungsi dengan benar dapat menggunakan kebijakan ForcePermissionPolicyUnloadDefaultEnabled untuk mencegah penghentian bertahap untuk perangkat di bawah kontrol mereka. Dengan mengaktifkan kebijakan ini, unload akan terus diaktifkan secara default untuk semua asal. Halaman masih dapat menetapkan kebijakan yang lebih ketat jika diinginkan. Seperti penonaktifan Permissions Policy, ini adalah alat untuk memitigasi potensi perubahan yang merusak. Sekali lagi, kami mendorong pemilik situs untuk berhenti bergantung pada handler unload, tetapi Chrome berencana mendukung penonaktifan untuk perusahaan ini dalam waktu yang cukup lama bagi situs yang perlu menggunakannya.

Tanda Chrome dan switch command line

Selain kebijakan Enterprise, Anda dapat menonaktifkan penghentian penggunaan untuk setiap pengguna menggunakan penggantian command line dan flag Chrome:

Menetapkan chrome://flags/#deprecate-unload ini ke enabled akan memajukan default penghentian penggunaan dan mencegah pemicuan handler unload. Kebijakan ini masih dapat diganti berdasarkan per situs menggunakan Kebijakan Izin, tetapi akan terus diaktifkan secara default.

Setelan ini juga dapat dikontrol oleh pengalihan command line.

Perbandingan opsi

Tabel berikut merangkum berbagai penggunaan opsi yang dibahas sebelumnya:

Kesimpulan

Handler unload tidak digunakan lagi. API ini sudah lama tidak dapat diandalkan dan tidak dijamin akan diaktifkan dalam semua kasus saat dokumen dihancurkan. Selain itu, handler unload tidak kompatibel dengan bfcache.

Situs yang menggunakan handler unload harus bersiap untuk penghentian penggunaan yang akan datang ini dengan menguji handler unload yang ada, menghapus atau memigrasikannya, atau, sebagai upaya terakhir, menunda penghentian penggunaan jika diperlukan lebih banyak waktu.

Ucapan terima kasih

Terima kasih kepada Kenji Baheux, Fergal Daly, Adriana Jara, dan Jeremy Wagner atas masukan ulasan yang bermanfaat.

Gambar utama oleh Anja Bauermann di Unsplash