Browserless项目中blockAds参数的正确使用方法

Browserless是一个基于Puppeteer的无头浏览器服务，在2.2版本中对参数传递方式进行了调整。本文将详细介绍blockAds参数的正确使用方式，帮助开发者避免常见错误。

blockAds参数的作用

blockAds参数用于在浏览器会话中自动屏蔽推广内容。启用该功能后，Browserless会拦截常见的推广网络请求，提升页面加载速度并减少带宽消耗。

版本2.2中的变更

在Browserless 2.2版本中，blockAds参数从启动选项(launch options)移动到了顶层查询参数(top-level query parameter)。这一变更意味着：

1. 不再支持通过launch.blockAds方式传递该参数
2. 必须直接在WebSocket连接URL的查询字符串中指定

正确使用方法

正确的blockAds参数使用方式如下：

const browser = await puppeteer.connect({
  browserWSEndpoint: `ws://your-browserless-server:3000?blockAds`,
});

常见错误与解决方案

开发者可能会遇到"launch.blockAds is not allowed"错误，这是因为错误地将blockAds参数放在了启动选项中。解决方法很简单：只需将参数移动到连接URL的查询字符串中即可。

获取最新文档

Browserless提供了实时更新的本地文档服务。启动Browserless后，访问其HTTP端口(默认3000)的/docs路径，即可查看完整的API文档和参数说明。

总结

Browserless 2.2版本对参数传递方式进行了优化，blockAds作为常用功能被提升为顶层参数。开发者应注意这一变更，按照新的规范调整代码，以确保内容过滤功能正常工作。