示例与参考

快速示例目录

playwright-basic.ts

• 创建一个普通浏览器会话
• 通过 Playwright 的 CDP 方式连接
• 访问 https://example.com
• 输出页面标题

session-management.ts

• 创建 normal 和 light 两种会话
• 查询当前活跃会话
• 输出分页信息与会话元数据

context-basic.ts

• 创建持久化 context
• 将它挂载到 session
• 演示跨运行复用同一个 context

context-list-get.ts

• 列出可用 contexts
• 按 ID 获取单个 context
• 查看 metadata 与锁定状态

context-modes.ts

• 演示 readWrite 与 readOnly 两种访问模式
• 展示 SDK 如何标准化 context mode 参数

context-lock-handling.ts

• 演示如何处理 ContextLockedError
• 查看 activeSessionId 与 retryAfter 等重试信息

extension-basic.ts

• 上传扩展 zip 压缩包
• 查询已上传扩展
• 使用 extensionIds 创建浏览器会话

proxy-session.ts

• 通过上游代理配置创建浏览器会话
• 验证远程浏览器能够使用带认证的代理设置

session-downloads.ts

• 将 Browser.setDownloadBehavior 配置到 /config/Downloads
• 在远程浏览器中触发文件下载
• 通过 SDK 查询下载元数据
• 获取单个下载文件或归档全部下载

运行示例

# 1. 安装 SDK 依赖并构建
npm install
npm run build

# 2. 在仓库根目录配置环境变量
cp .env.example .env
# 填入实际 API Key 和 Project ID

# 3. 安装 examples 依赖
cd examples
npm install

# 4. 运行脚本
npm run playwright-basic
npm run session-management
npm run context-basic
npm run context-list-get
npm run context-modes
npm run context-lock-handling
npm run extension-basic
npm run proxy-session
npm run session-downloads

示例依赖的环境变量

LEXMOUNT_API_KEY=your-api-key
LEXMOUNT_PROJECT_ID=your-project-id
LEXMOUNT_BASE_URL=https://api.lexmount.cn
LEXMOUNT_EXTENSION_PATH=/absolute/path/to/extension.zip
LEXMOUNT_PROXY_SERVER=http://host:port
LEXMOUNT_PROXY_USERNAME=optional
LEXMOUNT_PROXY_PASSWORD=optional

示例源码文件

• examples/playwright-basic.ts 展示最小远程浏览器连接流程。
• examples/session-management.ts 展示会话创建与分页查询。
• examples/context-basic.ts 展示持久化 context 挂载。
• examples/context-list-get.ts 展示 context 列表与详情查询。
• examples/context-modes.ts 展示读写与只读访问模式。
• examples/context-lock-handling.ts 展示锁冲突处理。
• examples/extension-basic.ts 展示扩展上传与挂载。
• examples/proxy-session.ts 展示上游代理配置。
• examples/session-downloads.ts 展示远程下载文件获取流程。