追蹤遷移進度
以下檢查清單可協助您追蹤遷移作業。這些工作會定義必須完成的任務,並提供操作說明連結。如「遷移摘要」所述,遷移工作大致可分為五類。
更新資訊清單
Manifest V3 的 manifest.json 檔案格式與 Manifest V2 略有不同。本頁說明只會影響 manifest.json 檔案的變更。但許多指令碼和網頁變更也需要變更資訊清單。這些變更會納入需要變更的遷移作業。
遷移至 Service Worker
Service Worker 會取代擴充功能的背景或事件頁面,確保背景程式碼不會占用主執行緒。這樣一來,擴充功能只會在需要時執行,節省資源。
開始之前,請先瞭解背景指令碼與擴充功能服務工作人員的差異。
- 更新資訊清單中的「background」欄位
- 將 DOM 和視窗呼叫移至螢幕外文件
- 將 localStorage 轉換為 chrome.storage.local
- 同步註冊接聽程式
- 以全域
fetch()取代對XMLHttpRequest()的呼叫。 - 保存狀態
- 將計時器轉換為鬧鐘
- 讓 Service Worker 保持運作 (特殊情況)
更新 API 呼叫
部分功能必須替換為 Manifest V3 對等功能。其他使用者則必須完全移除。
- 將
tabs.executeScript()替換為scripting.executeScript()。 - 將
tabs.insertCSS()和tabs.removeCSS()替換為scripting.insertCSS()和scripting.removeCSS()。 - 以動作取代瀏覽器動作和頁面動作
- 取代預期 Manifest V2 背景內容的函式。
- 以 Promise 取代回呼
- 取代不支援的 API
取代封鎖網頁要求事件監聽器
擴充功能會指定規則,說明符合特定條件時要執行的動作,而不是以程式輔助方式讀取及變更網路要求 (如 Manifest V2)。
完成上述項目後,建議您查看幾個常見用途:
提升擴充功能安全性
為提升擴充功能的安全性,請進行變更。包括移除不再支援的遠端代管程式碼。
發布 Manifest V3 擴充功能
轉換為 Manifest V3 後,即可在 Chrome 線上應用程式商店發布擴充功能。視變更內容而定,建議逐步推出。這樣就能先確保擴充功能可正常運作,再向所有使用者發布。