Skip to main content

DOMContentLoaded, load, beforeunload, unload 觸發時機

一個網頁從開啟到關閉，會有它完整的生命週期，這篇筆記就來介紹幾個網頁的生命週期 API :

DOMContentLoaded​

document.readyState 對應 "interactive"

當 HTML 載入並完全解析完畢後，也就是 DOM Tree 建立完成，就會觸發 DOMContentLoaded 事件，但外部資源 ( 例如 : 圖片 <img>、樣式表 stylesheets ) 可能還沒有完成載入。

使用方法​

document.addEventListener('DOMContentLoaded', (event) => {
  // DOM fully loaded and parsed !
})

load​

document.readyState 對應 "complete"

當 HTML 載入並完全解析完畢後，並且所有外部資源 ( 例如圖片 <img>、樣式表 stylesheets ) 也載入完畢後，才會觸發 load 事件。

使用方法​

window.addEventListener('load', (event) => {
  // All resources finished loading !
})
// or
window.onload = (event) => {
  // All resources finished loading !
}

beforeunload​

在使用者離開這個頁面 ( 例如 : 轉導頁、上一頁、下一頁、關閉頁面 ) 之前，會觸發 beforeunload 事件。

使用方法​

window.addEventListener('beforeunload', () => {
  // When all resources about to be unloaded !
})
// or
window.onbeforeunload = function () {
  // When all resources about to be unloaded !
}

另外，有些網站在離開頁面時會彈出 confirm 視窗詢問是否要重新載入網站 :

beforeunload-1.png

當在事件方法 onbeforeunload 中使用以下方法，都會觸發這個確認視窗 :

// return 不為 undefined 或 null 皆會觸發確認視窗
window.onbeforeunload = function () { return false }
// or
// event.returnValue 賦予任何值，包括 undefined、null 皆會觸發確認視窗
window.onbeforeunload = function () { event.returnValue = '' }

unload​

在使用者離開這個頁面 ( 例如 : 轉導頁、上一頁、下一頁、關閉頁面 ) 之後，會觸發 unload 事件，unload 會在 beforeunload、pagehide 事件之後觸發。

使用方法​

window.addEventListener('unload', (event) => {
  // All resources unloaded !
})
// or
window.onunload = (event) => {
  // All resources unloaded !
}
caution

MDN 有提及應避免使用此 API，原因為下 :

  • 移動設備無法可靠觸發 unload 事件。
  • 有些瀏覽器若具有 unload 監聽事件，則不會將頁面放入 BFCache，不利於網頁效能。

可以使用 visibilitychange、pagehide 事件代替，但仍須注意 pagehide 雖然支援 BFCache，但在移動設備上仍然不可靠。


延伸閱讀​

Chrome Developers 這篇 Page Lifecycle API 有更詳細的說明，這邊也附上文中事件對應圖 :

web-lifecycle-api.png

點我看大圖


Reference​