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

​

Firefox 有 firefox://flags 嗎?

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

​

其他瀏覽器的旗標

• brave://flags、opera://flags、vivaldi://flags、yandex://flags:它們都以 Chromium 為基礎,行為與 chrome://flags 完全相同,Extension.js 會以專案為單位管理它們。
• internet://flags 與 browser://flags:這些不是真實存在的瀏覽器 scheme。你要找的多半是 chrome://flags(Chromium)或 about:config(Firefox)。
• edge://flags:Edge 就是 Chromium,所以在 Extension.js 中的表現和 Chrome 一模一樣。

​

範本範例

​

new-browser-flags

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

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

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

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

deno run -A npm:extension@latest create my-extension --template=newtab-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 的預設旗標

​

一律生效的工作階段旗標

--disable-background-timer-throttling
--disable-renderer-backgrounding
--disable-backgrounding-occluded-windows
--disable-features=TranslateUI
--disable-hang-monitor
--disable-prompt-on-repost
--memory-pressure-off
--max_old_space_size=4096
--disable-dev-shm-usage

​

feature 開關的合併

​

環境變數開關

• EXTENSION_BROWSER_FLAGS 會把以空白分隔的旗標附加到每一次啟動。它在設定旗標之後、也在 excludeBrowserFlags 過濾之後才套用,因此 excludeBrowserFlags 無法移除來自這個變數的旗標。
• EXTENSION_HEADLESS=1(或 true)會強制使用 --headless=new,除非設定或環境旗標中已經傳入某種 --headless 變體。可以把它當成自動化工作階段的搶焦點防護。

​

支援的目標與參考

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

​

最佳實務

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

​

後續步驟

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