@agent-infra/browser

中文文档
0.2.2发布于 2026/01/30TypeScriptESM + CJS构建来源已验证近 30 天下载 2152

代理搜索浏览器

中文使用文档
文档目录5 节
  1. 安装
  2. 快速开始
  3. 完整文档
  4. 许可证
  5. 致谢
简体中文 | English

@agent-infra/browser

@agent-infra/browser 是一个基于 puppeteer 的 SDK,专门设计用于为浏览器代理提供基础功能。它提供了标签页管理、对话框处理、热键支持等方面的高级抽象,同时保持了简单直观的 API。

安装

npm install @agent-infra/browser

快速开始

这是一个简单的使用示例。Browser 会找到您计算机上安装的 Chrome 或 Edge 浏览器,启动一个受控的浏览器实例,然后通过 CDP 控制执行一些操作。

import { Browser } from '@agent-infra/browser';

// 创建浏览器实例
const browser = await Browser.create();

// 设置 User-Agent(可选)
browser.setUserAgent({
  userAgent:
    'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36',
});

// 获取当前活动标签页
const activeTab = browser.getActiveTab();

// 导航到指定网页
await activeTab.goto('https://example.com');

// 截图
const screenshot = await activeTab.screenshot();

// 关闭浏览器
await browser.close();

完整文档

有关详细的 API 文档和高级使用示例,请参考我们的完整文档。

许可证

Apache License 2.0。

致谢

特别感谢启发此工具包的开源项目:

版本与发布记录

@agent-infra/browser 共发布 18 个版本,首次发布于 2025/04/01;过去 12 个月发布了 3 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.2.2latest2026/01/309 个月前
0.2.12025/11/1011 个月前
0.2.02025/11/1011 个月前
0.2.0-alpha.5beta2025/11/061 年前
0.2.0-alpha.42025/11/061 年前
0.2.0-alpha.32025/11/061 年前

关于 @agent-infra/browser 的常见问题

@agent-infra/browser 是什么?

代理搜索浏览器

如何安装 @agent-infra/browser?

在项目目录运行 npm install @agent-infra/browser,或使用 pnpm add / yarn add / bun add。

@agent-infra/browser 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@agent-infra/browser 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@agent-infra/browser 可以商用吗?

@agent-infra/browser 使用 未声明 许可。package.json 没有声明许可证。没有许可证的代码默认保留全部权利,商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括,不构成法律意见,请以许可原文为准。

@agent-infra/browser 的下载量有多少?

根据 npm 官方下载统计,@agent-infra/browser 在 2026/10/05 – 2026/11/03 这 30 天内被下载 2,152 次,日均约 72 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@agent-infra/browser 还在维护吗?

最新版本 0.2.2 发布于 2026/01/30(9 个月前);至今共发布 18 个版本,其中过去 12 个月发布了 3 个;首次发布于 2025/04/01。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。