Node.js SDK
Node.js 示例
按浏览器任务选择可运行的 Node.js quickstart 脚本。
持续维护的脚本位于 Node.js quickstart 仓库。需要运行示例时请 clone 该仓库；本页只提供导航，不再复制每个脚本的实现。
准备环境
git clone https://github.com/lexmount/lexmount-js-sdk-quickstart.git
cd lexmount-js-sdk-quickstart
npm install
cp .env.example .env填写 LEXMOUNT_API_KEY 和 LEXMOUNT_PROJECT_ID，然后从下面的命令开始：
npm run demoBrowser Agent
使用 SDK 0.7.0，并选择已启用 Browser Agent 的项目。配置、幂等键和结果处理见 Browser Agent 指南。
| 命令 | 用途 |
|---|---|
npm run browser-agent | 基础 Run |
npm run browser-agent-advanced | 已保存 Agent 与结构化输出 |
npm run browser-agent-recovery | 恢复已有请求 |
保存 Run ID 和幂等键；恢复查询无需创建替代 Run。
浏览器创建与连接
| 命令 | 演示内容 |
|---|---|
npm run demo | 创建 Chromium、用 Playwright 连接、访问页面并截图 |
npm run light-demo | 创建 Moli（browserMode: 'light'）并提取链接 |
npm run catalog-info | 查看区域目录和实际选择的 endpoint |
npm run connection-demo | 通过直接 /connection endpoint 连接 |
npm run custom-image-demo | 使用 customImageId 启动 session |
npm run window-size-demo | 设置并验证 ACE 窗口尺寸 |
npm run inspect-url-demo | 输出控制台 View URL |
npm run session-list | 查询 session 状态和元数据 |
npm run session-targets | 从 /json 查询页面/target 元数据 |
npm run session-downloads | 触发下载并保存存储下载压缩包 |
持久化 Context
| 命令 | 演示内容 |
|---|---|
npm run context-basic | 创建 context 并以读写模式挂载 |
npm run context-list-get | 查询 context 列表和单条详情 |
npm run context-fork -- <context_id> | 复制 available 状态的离线 context |
npm run context-modes | 对比读写和只读访问 |
npm run context-lock-handling | 处理锁冲突和重试信息 |
扩展与代理
| 命令 | 演示内容 |
|---|---|
npm run extension-basic | 上传扩展压缩包并挂载到 session |
npm run extension-list-get | 查询已上传扩展列表和详情 |
npm run proxy-demo | 使用带鉴权的自定义上游代理 |
npm run official-proxy-demo | 使用 Lexmount 官方代理池 |
部分脚本需要 .env.example 中说明的额外值，例如扩展路径、自定义镜像 ID 或代理凭据。具体能力是否可用取决于项目套餐。
清理资源
示例会在 finally 中关闭浏览器连接、session 和 SDK client。进程意外中断时，请先在控制台检查 active session，再重新运行。
本地网络代理示例
安装上面的示例仓库后，在能访问目标站点的电脑上运行：
npm run local-proxy-demo -- --url 'https://your-internal-site.example/'使用 --region 或 .env 的 LEXMOUNT_REGION 指定区域；导航后按任意键退出并清理。先确认项目有 custom_proxy 权限。SDK 版本、隧道与会话配置见 本地代理指南。