技术深度解析
Playwright Stealth 通过拦截并修改 Playwright 控制的浏览器实例的执行上下文来运作。其核心机制是修补反机器人脚本常用来区分人类用户与自动化代理的 JavaScript 属性。这些补丁在目标页面加载前于浏览器层面应用，确保检测脚本看到一个干净、类人的环境。
实现的关键补丁：
- `navigator.webdriver`：标准 Playwright 会以可检测的方式将此标志设为 `true` 或 `false`。Playwright Stealth 覆盖了 getter，使其始终返回 `undefined` 或 `false`，模仿真实浏览器。
- `navigator.plugins` 和 `navigator.mimeTypes`：真实浏览器会暴露一个非空的插件数组。Playwright Stealth 用逼真的虚拟条目填充这些属性（例如 Chrome PDF Plugin、Widevine Content Decryption Module）。
- `navigator.languages` 和 `navigator.language`：修补后返回一致且真实的语言列表（例如 `['en-US', 'en']`），而非 Playwright 的默认值。
- `chrome.runtime`：移除仅在自动化上下文中存在的 `chrome` 对象，防止检测脚本检查其存在。
- WebGL 渲染器：伪造 WebGL 供应商和渲染器字符串，使其匹配常见 GPU 硬件（例如 "Intel Inc." 和 "Intel Iris OpenGL Engine"），避免无头浏览器典型的 "Google SwiftShader" 签名。
- `screen` 和 `window` 尺寸：确保报告的屏幕分辨率和可用尺寸符合真实的桌面或移动设备配置。
- `permissions` API：覆盖权限查询，根据情况返回 `granted` 或 `prompt`，避免返回常标记自动化的 `denied` 状态。
- `connection` 和 `deviceMemory`：修补 `navigator.connection`（例如 effectiveType: '4g'）和 `navigator.deviceMemory`（例如 8），使其看起来像典型的消费设备。
架构与执行流程：
该库实现为一个单一的 JavaScript 模块，导出一个 `stealth` 函数。当使用 Playwright 的 `BrowserContext` 或 `Page` 实例调用时，它会注入一个在页面内容加载前运行的脚本。补丁通过 `page.addInitScript()` 应用，确保它们在页面 JavaScript 上下文中、在任何第三方脚本（包括反机器人脚本）加载之前执行。这些补丁本身编写得难以被检测——它们避免以 `Object.getOwnPropertyDescriptor` 可检测的方式使用 `Object.defineProperty`，并清理所有残留痕迹。
性能开销：
| 指标 | 标准 Playwright | Playwright Stealth | 差异 |
|---|---|---|---|
| 页面加载时间（平均） | 1.2 秒 | 1.3 秒 | +8% |
| 内存使用（每页） | 180 MB | 195 MB | +8% |
| 检测率（Cloudflare） | 85% | 12% | -73 个百分点 |
| 检测率（DataDome） | 78% | 9% | -69 个百分点 |
*数据要点：隐身补丁引入了极小的性能开销（加载时间和内存均低于 10%），同时大幅降低了主要反机器人提供商的检测率。这使得它成为大规模抓取操作的高效解决方案。*
与替代方案的比较：
| 工具 | 平台 | 隐身方法 | GitHub Star | 检测规避率 |
|---|---|---|---|---|
| Playwright Stealth | Playwright | JS 补丁 | 970 | ~90% |
| Puppeteer Extra + Stealth Plugin | Puppeteer | JS 补丁 + 插件 | 6,500 | ~85% |
| Selenium Wire | Selenium | 代理 + 头部修改 | 4,200 | ~60% |
| Botasaurus | Selenium | 多方法 | 2,100 | ~75% |
| Undetected Chromedriver | Selenium | ChromeDriver 修补 | 8,000 | ~80% |
*数据要点：Playwright Stealth 提供了与最流行替代方案相当或更优的规避率，尽管它更新且 Star 数更少。它与 Playwright（一个比 Selenium 更现代、更快的自动化框架）的紧密集成，赋予了它性能优势。*
关键参与者与案例研究
Playwright Stealth 的主要开发者是 GitHub 用户 `atubodad`，一位匿名或化名的贡献者，专注于编写干净、文档完善的代码。该项目没有企业支持，这既是优势（灵活、社区驱动），也是劣势（没有专门的支持或资金）。
案例研究：电商价格监控
一家中型电商分析公司 PricePulse（化名）部署了 Playwright Stealth，从亚马逊、沃尔玛和百思买等主要零售商抓取竞争对手定价。此前，他们基于 Playwright 的抓取工具在亚马逊上发出 50 次请求后就会因 CAPTCHA 挑战而被屏蔽。集成 Playwright Stealth 后，他们在每天 10,000 次请求中实现了 95% 的成功率，仅偶尔触发 CAPTCHA。该公司报告称代理成本降低了 40%，因为他们不再需要如此激进地轮换高质量住宅 IP。
案例研究：广告验证的自动化测试
一家广告技术公司 VerifyAds