🎭 Patchright

Patchright 是 Playwright 测试与自动化框架的一个修补且无法被检测的版本。
它可以作为 Playwright 的直接替代品使用。

[!NOTE]
该仓库提供 Patchright 驱动。要使用 Patchright，请查看 Python 包、NodeJS 包 或社区驱动的 .Net 包。

[!IMPORTANT]
Patchright 仅修补基于 Chromium 的浏览器。不支持 Firefox 和 Webkit。

---

赞助商

^{想要赞助本项目？在 Discord 上联系 @vinyzu！}

Swiftproxy：用于可扩展数据收集的高性能住宅代理

专为需要可靠、反检测代理基础设施的开发者打造。Swiftproxy 提供稳定的连接、高成功率以及灵活的控制，适用于大规模爬取和自动化。

• 🌍 195+ 个地点，拥有合规来源的住宅 IP
• 🔄 轮换与粘性会话，支持精确定位
• ⚡ 针对反封禁与高成功率进行优化
• 🔌 支持 HTTP / HTTPS / SOCKS5
• 🧪 免费 500MB 试用，供测试使用
• 💸 Patchright 用户专属折扣码：PROXY90 - 10%

^{适用于：网页爬取、自动化、多账户管理及大规模数据提取}

---

RapidProxy 提供稳定且高性能的代理网络，专为大规模数据操作而设计。

---

补丁

Runtime.enable 泄漏

这是 Patchright 使用的最重要的补丁。为避免被此泄漏检测到，Patchright 通过避免使用 Runtime.enable，而是在（隔离的）ExecutionContext 中执行 JavaScript。

Console.enable 泄漏

Patchright 通过完全禁用 Console API 来修补此泄漏。这意味着控制台功能在 Patchright 中无法正常工作。如果您确实需要控制台，可能更合适使用 JavaScript 记录器，尽管它们也容易被检测。

命令行标志泄漏

Patchright 调整了 Playwright 默认参数，以避免被命令行标志泄漏检测到。这（最重要的是）影响了：

• --disable-blink-features=AutomationControlled（已添加）以避免 navigator.webdriver 检测。
• --enable-automation（已移除）以避免 navigator.webdriver 检测。
• --disable-popup-blocking（已移除）以避免弹出窗口崩溃。
• --disable-component-update（已移除）以避免被检测为隐身驱动。
• --disable-default-apps（已移除）以启用默认应用程序。
• --disable-extensions（已移除）以启用扩展。

通用泄漏

Patchright 修补了 Playwright 代码库中的一些通用泄漏。主要包括不完善的设置和明显的检测点。

封闭影子根

Patchright 能够与封闭影子根中的元素进行交互。只需使用普通的定位器，Patchright 会处理其余部分。
Patchright 现在还可以在封闭影子根中使用 XPath。

---

隐身性

通过正确的设置，Patchright 目前被认为是不可检测的。 Patchright 通过了：

• Brotector ✅（配合 CDP 补丁）
• Cloudflare ✅
• Kasada ✅
• Akamai ✅
• Shape/F5 ✅
• Bet365 ✅
• Datadome ✅
• Fingerprint.com ✅
• CreepJS ✅
• Sannysoft ✅
• Incolumitas ✅
• IPHey ✅
• Browserscan ✅
• Pixelscan ✅

---

缺陷

尽管我们花费了大量时间使 Patchright 尽可能稳定，但仍可能出现缺陷。如果您遇到任何缺陷，请在 Issues 中报告。

Patchright 现在每次发布后都会针对 Playwright 测试进行验证。请参阅这里。

[!WARNING]
Patchright 通过了大多数（但并非全部）Playwright 测试。某些缺陷被认为无法解决，有些则无关紧要。请参阅缺陷列表及其说明这里。

基于 Playwright 测试，我们认为在常规使用场景下，您受到这些缺陷影响的可能性极低。

初始化脚本问题

说明

为了能够在没有 Runtime.enable 的情况下使用 InitScript，Patchright 利用 Playwright 路由将 JavaScript 注入 HTML 请求。

缺陷

Playwright 路由可能会在代码的其他部分引起一些缺陷。Patchright InitScript 不会引起任何普通 Playwright 路由不会引起的缺陷。
如果您希望修复这些缺陷中的任何一个，您需要联系 Playwright 团队。

泄漏

Patchright InitScript 可以通过时间攻击被检测到。然而，目前没有任何反爬虫工具检查此类时间攻击，并且它们可能在一段时间内不会。
我们认为其检测风险不高。

---

待办事项

• 实现选择执行上下文（主/隔离）的选项。
• 修复可修复的缺陷。
• 实现 .patch 更新器，以便轻松显示 Patchright 的补丁。
• 在新版本发布时设置自动测试。
• 在 .NET 上实现 Patchright。
• 在 Java 上实现 Patchright。

---

开发

新版本 Patchright 的部署是自动的，但由于 Playwright 代码库变更导致的缺陷仍然可能发生。这些缺陷的修复可能需要几天时间才能发布。

---

支持我们的工作

如果您选择支持我们的工作，请在 Discord 上联系 @vinyzu 或 @steve_abcdef。

---

版权与许可

© Vinyzu

Patchright 采用 Apache 2.0 许可。

代码库的某些部分 受到 Driverless 的启发。 感谢 Nick Webson 提供 .patch 文件文档的想法。

---

免责声明

本仓库仅供教育目的提供。
对于内容的准确性、完整性或适用性不作任何保证。使用风险自负——作者和维护者不对因使用、修改或分发本代码而导致的任何损害、法律问题或违反保证承担任何责任。
任何滥用或违法行为均由用户自行承担责任。

---

作者

活跃维护者：Vinyzu
共同维护者：Kaliiiiiiiiii