Shot-scraper 1.7版本发布：增强HAR捕获功能

项目简介

Shot-scraper是一个基于Playwright的网页截图和自动化工具，它提供了简单易用的命令行界面，让开发者能够轻松地捕获网页截图、生成HAR文件（HTTP存档格式）以及执行网页自动化任务。该项目特别适合用于网页监控、性能分析、自动化测试等场景。

1.7版本核心更新

最新发布的1.7版本主要针对HAR文件捕获功能进行了两项重要改进，使得开发者能够更灵活地控制HAR文件的生成过程，并提供了处理大型HAR文件的解决方案。

HAR捕获功能增强

1.7版本为shot-scraper har命令新增了三个与截图命令相同的选项参数：

1. --wait参数：允许指定等待时间（毫秒），确保页面完全加载后再生成HAR文件。这对于动态加载内容的网页特别有用。

2. --wait-for参数：可以指定等待某个CSS选择器匹配的元素出现后再生成HAR文件。这在需要确保特定内容加载完成的场景下非常实用。

3. --javascript参数：支持在执行HAR捕获前注入并执行自定义JavaScript代码，为高级用户提供了更大的灵活性。

这些新增参数使得HAR捕获过程与截图功能保持了一致的行为模式，降低了用户的学习成本，同时也提高了工具的实用性。

大型HAR文件处理方案

针对大型网站或长时间监控场景下HAR文件可能过大的问题，1.7版本文档明确推荐使用shot-scraper multi --har-zip命令来处理大量HAR文件的生成。

这种方法的优势在于：

• 将多个HAR文件打包为ZIP格式，避免了单个超大JSON文件导致的Playwright崩溃问题
• 更适合批量处理多个页面的监控场景
• 减少了内存占用，提高了工具的稳定性

技术背景与应用场景

HAR文件是记录浏览器与网站之间所有网络交互的标准格式，包含请求头、响应头、时间戳等详细信息。在以下场景中特别有用：

1. 性能分析：通过分析HAR文件中的时间数据，可以识别网页加载性能瓶颈。

2. 调试：重现用户遇到问题时浏览器与服务器的完整通信过程。

3. 监控：定期捕获HAR文件可以监控网站API的变化或性能退化。

4. 安全审计：检查网页加载的所有资源和第三方请求。

1.7版本的改进使得这些应用场景的实现更加可靠和灵活，特别是对于现代动态网页和需要长期监控的大型网站。

最佳实践建议

基于1.7版本的新特性，建议开发者：

1. 对于单页面应用或动态加载内容的网站，使用--wait或--wait-for确保捕获完整的网络活动。

2. 当需要预处理页面时（如登录或执行特定操作），使用--javascript注入必要的脚本。

3. 对于长期监控或批量处理，优先考虑shot-scraper multi --har-zip命令，避免内存问题。

4. 定期检查生成的HAR文件大小，对于持续增长的监控项目，考虑分割监控周期或使用ZIP打包方案。

通过这些改进，Shot-scraper在网页监控和分析领域的实用性和可靠性得到了显著提升，为开发者提供了更加强大的工具支持。