# @benmalka/foxdriver 中文文档 规范地址：https://npmcn.com/package/%40benmalka/foxdriver/ 版本：0\.6\.0 npm 元数据更新时间：2022-04-04T18:23:08.716Z 中文译文更新时间：2026-11-07T22:22:17.185Z 软件包许可：Apache-2\.0 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40benmalka/foxdriver 原文对照：https://npmcn.com/package/%40benmalka/foxdriver/?lang=original 项目主页：https://github.com/benmalka/foxdriver#readme 源码仓库：https://github.com/benmalka/foxdriver ## 关键信息（来自 npm 元数据） - 包体积（解压后）：469 kB，108 个文件 - 模块格式：CommonJS - TypeScript 类型：未声明 - 运行依赖：6 个 - 首次发布：2019-11-30T15:09:16.654Z - 最新版本发布：2021-02-01T21:33:36.754Z - 近 30 天下载量：3467（2026-10-08 至 2026-11-06，npm 官方下载统计） - 已发布版本数：13（近 12 个月 0 个） ## 中文简介 Foxdriver 是一个节点库,提供高级API来控制 Firefox 对远程调试协议的控制 ## 安装 ```sh npm install @benmalka/foxdriver ``` 也可以使用：`pnpm add @benmalka/foxdriver`、`yarn add @benmalka/foxdriver`、`bun add @benmalka/foxdriver` ## README # 脚踏车 > Foxdriver是一个节点库,它提供高级API来控制Firefox对远程调试协议的控制. 0.6.0版本现在支持在启动浏览器之前添加自定义配置文件(即 cert9.db) ## 开始 ### 安装 要在您的工程中使用 Foxdriver, 运行 : ```sh $ npm i @benmalka/foxdriver ``` ### 使用量 Firefox远程调试协议由多个提供不同方法的行为体组成. Foxdriver API允许您启动一个 Firefox 实例并自动连接到协议界面. 从那里你可以使用所有演员的方法. **示例** - 打开页面并获得控制台.logs ```js import Foxdriver from '@benmalka/foxdriver' (async () => { const { browser, tab } = await Foxdriver.launch({ url: 'https://www.mozilla.org/en-US' }); // enable actor await tab.console.startListeners(); // wait until page is loaded await new Promise((resolve) => setTimeout(resolve, 3000)); // receive logs and page errors const logs = await tab.console.getCachedMessages(); console.log(logs); // close browser browser.close(); })() ``` 您也可以连接到已经运行的 Firefox 浏览器中 。 这需要启动浏览器 `-start-debugger-server=` cli 参数和设置如下: - `devtools.chrome.enabled: true` - `devtools.debugger.prompt-connection: false` - `devtools.debugger.remote-enabled: true` 要连接到浏览器, 您需要创建一个正确的端口和主机的 Foxdriver 实例, 并呼叫 `connect()` 方法 : ```js import Foxdriver from '@benmalka/foxdriver' (async () => { const { browser, tab } = await Foxdriver.attach('localhost', 9222); const preferences = await browser.preference.getAllPrefs(); // ... })() ``` ## API 密码 - [脚踏车](https://npmcn.com/package/%40benmalka/foxdriver/#readme-api) - [类: 喷雾器](https://npmcn.com/package/%40benmalka/foxdriver/#readme-foxdriver) - [Foxdriver.attach (选项)](https://npmcn.com/package/%40benmalka/foxdriver/#readme-foxdriverattachhost-port) - [Foxdriver. launch( 选项)](https://npmcn.com/package/%40benmalka/foxdriver/#readme-foxdriverlaunchoptions) - [类: 浏览器](https://npmcn.com/package/%40benmalka/foxdriver/#readme-class-browser) - [浏览器. close ()](https://npmcn.com/package/%40benmalka/foxdriver/#readme-close) - [浏览器. 首选项](https://npmcn.com/docs/api/actors/preference.md) - [浏览器. actor Registry](https://npmcn.com/docs/api/actors/actorRegistry.md) - [浏览器.addons](https://npmcn.com/docs/api/actors/addons.md) - [浏览器.device](https://npmcn.com/docs/api/actors/device.md) - [浏览器.heapSnapshot 文件](https://npmcn.com/docs/api/actors/heapSnapshotFile.md) - [类: 标签](https://npmcn.com/package/%40benmalka/foxdriver/#readme-class-tab) - [选项卡.attach ()](https://npmcn.com/package/%40benmalka/foxdriver/#readme-tabattach) - [选项卡.detach ()](https://npmcn.com/package/%40benmalka/foxdriver/#readme-tabdetach) - [选项卡.reload ()](https://npmcn.com/package/%40benmalka/foxdriver/#readme-tabreload) - [选项卡.cache 残废(残废)](https://npmcn.com/package/%40benmalka/foxdriver/#readme-tabcachedisableddisable) - [选项卡.navigateTo(url)](https://npmcn.com/package/%40benmalka/foxdriver/#readme-tabnavigatetourl) - [选项卡.onTabNavigated(召回)](https://npmcn.com/package/%40benmalka/foxdriver/#readme-tabontabnavigatedcallback) - [选项卡. 控制台](https://npmcn.com/docs/api/actors/console.md) - [选项卡.network](https://npmcn.com/docs/api/actors/network.md) - [选项卡.存储](https://npmcn.com/docs/api/actors/storage.md) - [选项卡.memory](https://npmcn.com/docs/api/actors/memory.md) - [选项卡。性能](https://npmcn.com/docs/api/actors/performance.md) - [选项卡. profile](https://npmcn.com/docs/api/actors/profiler.md) - [选项卡.时间线](https://npmcn.com/docs/api/actors/timeline.md) - [选项卡。样式 Sheets](https://npmcn.com/docs/api/actors/styleSheets.md) - [选项卡.csSUsage](https://npmcn.com/docs/api/actors/cssUsage.md) - [选项卡.css 财产](https://npmcn.com/docs/api/actors/cssProperties.md) - [选项卡模拟](https://npmcn.com/docs/api/actors/emulation.md) - [选项卡。检查器](https://npmcn.com/docs/api/actors/inspector.md) ### 脚踏车 #### Foxdriver.attach (主机, 端口) 将客户端附加到已运行实例中 . - `host` `` 启动 Firefox 实例的主机 - `port` `` 启动 Firefox 实例的端口 - 返回 : `>` - `tab` `<[Tab]>` 打开的标签列表 - `browser` `` 浏览器实例 #### Foxdriver. launch( 选项) 将客户端附加到已运行实例中 . - `options` `` - `port` `` 启动 Firefox 实例的端口 - `bin` `` firefox 二进制路径( 默认: OS 默认路径) - `args` `<[String]>` 转到 `fs.spawn` (默认 : `[]`(中文(简体) ) - `customPrefs` `` 在浏览器启动之前,您可以通过设置预览的密钥值对来设定自己的首选项。 请注意,不可能覆盖所需的预告,即. - `devtools.chrome.enabled: true` - `devtools.debugger.prompt-connection: false` - `devtools.debugger.remote-enabled: true` - `customProfileFiles` `<[String]>` 数组 **绝对** 要复制到随机生成的配置文件文件夹的文件路径。 这在使用Firefox中自签的证书时很有帮助. 看这里 [Firefox 中如何使用自签名证书](https://npmcn.com/docs/general/how-to-use-self-sigend.md) - 返回 : `>` - `tab` `` 打开标签 - `browser` `` 浏览器实例 #### 类: 浏览器 ##### 关闭( c) 从浏览器实例中断开连接, 如果通过 : `launch()` 方法 #### 类: 标签 ##### 选项卡.attach () 附着于此标签 - 返回 : `` 发送请求后完成 ##### 选项卡.detach () 从此标签中删除 - 返回 : `` 发送请求后完成 ##### 选项卡.reload () 重新装入当前页面 URL. - 返回 : `` 发送请求后完成 ##### 选项卡.cache 残废(残废) 禁用缓存 . - `disable` `` 如果是真的, 缓存是断裂的 - 返回 : `` 发送请求后完成 ##### 选项卡.navigateTo(url) 导航到某个 URL - `url` `` 浏览到 - 返回 : `` 发送请求后完成 ##### 选项卡.onTabNavigated(召回) 标签导航端发生事件 - `callback` `` 将被调用为活动 详情请查阅 [API 文件](https://npmcn.com/docs)。 。 。 . ## 常见问题 ### @benmalka/foxdriver 是什么？ Foxdriver 是一个节点库,提供高级API来控制 Firefox 对远程调试协议的控制 ### 如何安装 @benmalka/foxdriver？ 在项目目录运行 npm install @benmalka/foxdriver，或使用 pnpm add / yarn add / bun add。 ### @benmalka/foxdriver 支持 TypeScript 吗？ 该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/benmalka\_\_foxdriver 是否存在。 ### @benmalka/foxdriver 支持 ESM 还是 CommonJS？ 以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。 ### @benmalka/foxdriver 可以商用吗？ @benmalka/foxdriver 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。 ### @benmalka/foxdriver 的下载量有多少？ 根据 npm 官方下载统计，@benmalka/foxdriver 在 2026/10/08 – 2026/11/06 这 30 天内被下载 3,467 次，日均约 116 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @benmalka/foxdriver 还在维护吗？ 最新版本 0\.6\.0 发布于 2021/02/02（5 年前）；至今共发布 13 个版本，其中过去 12 个月发布了 0 个；首次发布于 2019/11/30。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。