browserPath

browserPath 用于配置开发时自动打开浏览器并加载扩展的可执行文件路径。

概述

  • 类型BrowserPathConfig
  • 默认值undefined(使用系统默认路径)
  • 是否必需:否

Chromium 系浏览器

支持以下基于 Chromium 的浏览器:

浏览器配置键默认路径
Google Chromechrome自动检测
Chromiumchromium自动检测
Microsoft Edgeedge自动检测
Bravebrave自动检测
Vivaldivivaldi自动检测
Operaopera自动检测
Arcarc自动检测

配置示例

// addfox.config.ts
export default defineConfig({
  browserPath: {
    chrome: "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
    edge: "/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge",
  },
});

使用 CLI 启动

pnpm
npm
yarn
bun
pnpm dev -- -b chrome
pnpm dev -- -b edge
pnpm dev -- -b brave

Firefox

Firefox 使用 web-ext 工具管理扩展,路径配置方式相同:

export default defineConfig({
  browserPath: {
    firefox: "/Applications/Firefox.app/Contents/MacOS/firefox",
  },
});

启动 Firefox

pnpm
npm
yarn
bun
pnpm dev -- -b firefox
Info

Firefox 开发模式使用 web-ext 工具,扩展重载由 web-ext 处理而非 Addfox 的 WebSocket。

各平台示例

macOS

export default defineConfig({
  browserPath: {
    chrome: "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
    edge: "/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge",
    firefox: "/Applications/Firefox.app/Contents/MacOS/firefox",
  },
});

Windows

export default defineConfig({
  browserPath: {
    chrome: "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe",
    edge: "C:\\Program Files (x86)\\Microsoft\\Edge\\Application\\msedge.exe",
  },
});

Linux

export default defineConfig({
  browserPath: {
    chrome: "/usr/bin/google-chrome",
    chromium: "/usr/bin/chromium-browser",
    firefox: "/usr/bin/firefox",
  },
});

相关配置