Skip to main content
在你撰寫真實擴充功能功能時,理解最重要的幾項合約。理解 manifest.json 控制什麼,以及 Extension.js 會改寫哪些進入點。然後判斷哪些行為可以放心交給自動化處理,哪些限制依然存在。

依需求開始

本章節涵蓋什麼

  • 光看 CLI 文件容易遺漏的撰寫合約。
  • 由你的原始碼驅動、會影響擴充功能載入與重新載入方式的執行階段行為。
  • 即使在打包之後仍然重要的瀏覽器擴充功能架構議題,例如權限、messaging、storage,以及 background、content script 與頁面情境之間的隔離。
  • 無論你是手動開發還是搭配 AI 編碼代理人,都實用的指引。

重要的心智模型

Extension.js 在編譯、路徑標準化、manifest 改寫與開發體驗上幫上忙。它不會消除底層的瀏覽器擴充功能邊界:
  • Content script 仍受頁面情境限制。
  • Background service worker 仍有生命週期限制。
  • Web-accessible resources 仍需要明確開放。
  • 權限仍決定擴充功能能做什麼。
  • Messaging 與 storage 仍需要明確設計。

為新功能設定的好閱讀順序

  1. manifest.json 開始,了解你正在宣告的擴充功能介面。
  2. 閱讀對應功能頁面,例如 content scriptbackground
  3. 加入支援元素:權限messagingstorageweb-accessible resources
  4. 可預期的路徑解析中驗證路徑假設。
  5. 在進入 watch mode 變更進入點之前,先閱讀 dev 更新行為

後續步驟