Chrome、Firefox 與 Edge 的瀏覽器啟動旗標

​

Firefox 有 firefox://flags 嗎?

• 使用 browserFlags 來傳遞 Extension.js 啟動瀏覽器執行檔時所用的啟動旗標。
• 使用 Firefox 偏好設定 來設定原本會放在 about:config 中、可重複套用的 Gecko 執行階段行為。

​

範本範例

​

new-browser-flags

npx extension@latest create my-extension --template=new-browser-flags

pnpx extension@latest create my-extension --template=new-browser-flags

yarn dlx extension@latest create my-extension --template=new-browser-flags

bunx extension@latest create my-extension --template=new-browser-flags

bunx extension@latest create my-extension --template=new-browser-flags

​

運作方式

• browser.<target>.browserFlags
• commands.dev|start|preview.browserFlags
• 可選的 excludeBrowserFlags,可移除預設旗標或使用者旗標(行為會因目標是 Chromium 或 Firefox 而不同)。

​

旗標功能

​

設定範例

export default {
  browser: {
    chrome: {
      browserFlags: ["--disable-web-security", "--auto-open-devtools-for-tabs"],
      excludeBrowserFlags: ["--mute-audio"],
    },
    firefox: {
      browserFlags: ["--devtools", "--new-instance"],
      excludeBrowserFlags: ["--devtools"],
    },
  },
};

​

Chromium 與 Firefox 的行為差異

• Chromium 系列(chrome、edge、chromium、chromium-based)
  • 從內建的預設旗標集開始,接著附加你的 browserFlags。
  • excludeBrowserFlags 會移除符合的預設旗標(完全相符的過濾)。
  • Extension.js 自行管理 --load-extension=...,並會從使用者提供的旗標中過濾掉它。
• Firefox/Gecko 系列(firefox、gecko-based / firefox-based)
  • 使用使用者提供的 browserFlags(沒有 Chromium 那種龐大的預設旗標組)。
  • excludeBrowserFlags 會以前綴比對的方式移除使用者旗標。

​

Chromium 的預設旗標

​

支援的目標與參考

• --chromium-binary=...
• --gecko-binary=...

​

最佳實務

• 只加入必要的旗標:減少冗長的旗標清單,降低不穩定或不可攜的設定。
• 優先使用 excludeBrowserFlags,而不是整個取代預設:只移除會與你工作流程衝突的部分。
• 不要手動傳 --load-extension:Extension.js 會在內部管理擴充功能載入相關旗標。
• 針對每個瀏覽器家族驗證:在 Chromium 上有效的旗標,在 Firefox 上可能無效或被忽略。

​

後續步驟

• 進一步了解 瀏覽器偏好設定。
• 進一步了解 瀏覽器設定檔。
• 在 可用的瀏覽器 中選擇目標。
• 透過 extension.config.* 串接旗標。
• 第一次接觸擴充功能工具鏈?先從 瀏覽器擴充功能框架 總覽開始。