@browserless/cli:CLI与无浏览器能力交互.
见 CLI 节 我们的网站有更多信息.
安装
使用 npm :
npm install @browserless/cli -g
关于
此软件包提供了 命令行接口 用于直接从终端与无浏览器能力互动。 它揭露了 browserless 二进制将核心浏览器无API包成易用贝壳命令.
这个软件包做什么
这个 @browserless/cli 软件包允许您 :
- 抓取截图 从具有梯度背景的 URL,浏览器覆盖,以及设备仿真
- 记录抓取 视频/音频
tabCapture扩展流量 - 生成 PDF 从网页
- 摘录内容 作为 HTML 或纯文本
- 运行灯塔审计 用于业绩分析
- 分析页面重量 (网络请求、转移规模、资源规模)
- 检查 URL 状态 和反应信息(方向、标题、状态代码)
可用命令
| 命令 | 说明 |
|---|---|
capture <url> | 记录一页并返回视频缓冲( 使用) --path 要保存文件) |
screenshot <url> | 抓取带有可选覆盖和背景的截图 |
pdf <url> | 从网页生成 PDF 文档 |
html <url> | 将页面内容序列化为 HTML |
text <url> | 从页面中提取纯文本内容 |
lighthouse <url> | 运行 Google 灯塔审计并输出 JSON 报告 |
page-weight <url> | 分析网络请求、资源大小和基本负载时间 |
ping <url> | 获取响应信息: 状态代码、 方向、 信头 |
status <url> | 获取 HTTP 状态代码 |
goto <url> | 导航到一个 URL并返回页面/ 回复信息 |
exec <file> | 在新页面上运行脚本文件并打印它返回的内容 |
执行示例
exec 取一个文件而不是 URL。 文件导出一个函数( CommonJS)
module.exports 或ES模块 export default) (中文(简体) ). CLI打开一页并呼叫
函数 { page, browserless, opts }数字 :
page:在新浏览器上下文中的新Puppeter页面.browserless: 无浏览器上下文,用于browserless.goto(page, { url })还有其他的API.opts: 命令行旗,加上 CLI 默认值codeScheme。 。 。 .--headless财务报告和审定财务报表--verbose被CLI消耗,没有通过.--timeout并设置浏览器超时.
// title.js
module.exports = async ({ page, browserless, opts }) => {
await browserless.goto(page, { url: opts.url })
return { title: await page.title() }
}
browserless exec title.js --url=https://example.com
文件路径从当前目录中解析 。 已打印返回的字符串
就像JSON那样 还有其他价值. undefined 和 二进制值
(buffers和打出数组,例如: page.screenshot()) 打印
没有, 所以从脚本中将二进制输出写入文件 。 检查文件
在浏览器启动前。 抛出的错误是
打印并使用代码 1 的流程退出 .
抓取实例
# mp4 (default)
browserless capture https://example.com --path=./capture.mp4
# webm output type
browserless capture https://example.com --type=webm --path=./capture.webm
说明: 这个
lighthouse命令需要额外安装.请通过运行确保安装独立的软件包 :
npm 安装 -g @ 无浏览器/ 灯塔
如何适合在单体
此软件包取决于 :
| 依赖性 | 目的 |
|---|---|
| @ 浏览/ 抓取 | 基于扩展的 CLI 视频记录标签抓取 |
| 无浏览器 | 所有浏览器自动化操作的核心 API |
| @ 无眉/ 灯塔 | 灯塔审计一体化(由灯塔指挥部使用) |
CLI充当了薄薄的包装器来解析命令行参数,初始化一个无浏览器实例,并向适当的命令处理器代表.
许可证
@ 浏览器无/ cli © 微链接,在 麻省理工学院 执照.
作者和维护者 微链接 由来自 捐助者。 。 。 .
微链接.io • GitHub 软件 微链克 • X @microlinkhq (英语)