capture-website-cli 使用教程

项目介绍

capture-website-cli 是一个用于从命令行捕获网站截图的开源工具。它基于 Node.js 开发，提供了丰富的选项来定制截图的尺寸、格式、质量等。该项目由 Sindre Sorhus 维护，遵循 MIT 许可证。

项目快速启动

安装

首先，确保你已经安装了 Node.js 和 npm。然后，通过以下命令全局安装 capture-website-cli：

npm install --global capture-website-cli

基本使用

以下是一个简单的示例，展示如何捕获一个网站的截图并保存为 PNG 文件：

capture-website https://sindresorhus.com --output=screenshot.png

常用选项

• --output: 指定输出文件路径。
• --width: 设置页面宽度，默认值为 1280。
• --height: 设置页面高度，默认值为 800。
• --type: 设置图像类型，支持 png、jpeg 和 webp，默认值为 png。
• --quality: 设置图像质量（仅对 JPEG 和 WebP 有效），取值范围为 0 到 1。

应用案例和最佳实践

案例一：捕获全页面截图

有时你需要捕获整个可滚动页面的截图，而不仅仅是视口内的内容。可以使用 --full-page 选项：

capture-website https://example.com --output=fullpage.png --full-page

案例二：模拟设备

你可以模拟特定的设备来捕获截图，例如 iPhone X：

capture-website https://example.com --output=iphonex.png --emulate-device="iPhone X"

最佳实践

• 使用配置文件：对于复杂的设置，可以将命令保存到配置文件中，然后通过脚本运行。
• 并发捕获：结合其他工具（如 parallel），可以并发捕获多个网站的截图，提高效率。

典型生态项目

pageres

pageres 是 capture-website-cli 的姊妹项目，提供了类似的截图功能，但更侧重于程序化 API 的使用。如果你需要更灵活的截图控制，可以考虑使用 pageres。

puppeteer

puppeteer 是一个强大的无头浏览器工具，广泛用于自动化测试和截图。虽然 capture-website-cli 提供了简化的命令行接口，但 puppeteer 提供了更底层、更灵活的控制。

通过这些工具的结合使用，你可以构建出强大的自动化截图和测试流程。