Chrome、Firefox 与 Edge 的浏览器启动 flag

​

Firefox 有 firefox://flags 吗？

• 用 browserFlags 配置 Extension.js 传给浏览器二进制的启动 flag。
• 用 Firefox preferences 配置原本会写在 about:config 中的、可复现的 Gecko 运行时行为。

​

其他浏览器中的 flag

• 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，用于移除默认 flag 或用户自定义的 flag（具体行为取决于目标是 Chromium 还是 Firefox）。

​

flag 能力

​

配置示例

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）
  • 从一组内部默认 flag 出发，然后追加你的 browserFlags。
  • excludeBrowserFlags 会移除匹配的默认 flag 与用户 flag。
  • Extension.js 自己管理 --load-extension=...，并会从用户传入的 flag 中将其过滤掉。
• Firefox/Gecko 家族（firefox、gecko-based / firefox-based）
  • 使用用户传入的 browserFlags（没有像 Chromium 那样的大量默认 flag）。
  • excludeBrowserFlags 会移除匹配的用户 flag，规则与 Chromium 相同。

​

Chromium 默认 flag

​

始终生效的会话 flag

--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 会把以空白分隔的 flag 追加到每一次启动。它在配置 flag 之后、也在 excludeBrowserFlags 过滤之后才应用，因此 excludeBrowserFlags 无法移除来自这个变量的 flag。
• EXTENSION_HEADLESS=1（或 true）会强制使用 --headless=new，除非配置或环境 flag 中已经传入了某种 --headless 变体。可以把它当作自动化会话的抢焦点防护。

​

支持的目标与参考资料

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

​

最佳实践

• 只加必要的 flag：尽量精简 flag 列表，避免不稳定或不可移植的配置。
• 优先使用 excludeBrowserFlags，而不是整体替换默认值：只移除与你的工作流冲突的部分。
• 不要手动传入 --load-extension：Extension.js 会在内部管理扩展加载相关的 flag。
• 按浏览器家族分别验证：在 Chromium 上可用的 flag，在 Firefox 上可能无效或被忽略。

​

下一步

• 进一步了解 浏览器 preferences。
• 进一步了解 浏览器 profile。
• 在 可用浏览器 中选择目标。
• 通过 extension.config.* 串联 flag 配置。
• 第一次接触扩展工具链？先从 快速开始 概览开始。