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