🎭 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 提供稳定且高性能的代理网络，专为大规模数据操作而设计。

RapidProxy 提供：

• 🌍 9000 万+ 住宅 IP（200+ 个地点）
• 🔄 轮换住宅代理 — 低至 $0.65/GB（流量永不过期）
• 🧩 静态住宅 IP — $5/IP（30 天，无限流量）
• 🎯 精确的地理定位
• ⚡ 提供免费试用 — 无风险测试代理性能
• 专为爬取、自动化及高性能数据处理工作流而构建。
• 🔥 特惠：使用优惠码 RAPID10 享受 10% 折扣

^{快速启动。全球扩展。使用 RapidProxy 保持稳定。}

---

NodeMaven：您可靠的代理提供商，拥有高质量 IP。
是自动化、网页爬取、SEO 研究和社交媒体管理的绝佳解决方案。

为什么选择 NodeMaven？

✅ 99.9% 正常运行时间
🎯 粘性会话最长 7 天
🔍 IP 过滤：代理保证欺诈评分 <97%
🔰 无需 KYC
💸 流量返现 - 消耗 GB 可赚取高达 10% 返还

Patchright 用户专属优惠码：
🔥 PATCHRIGHT35 - 移动端和住宅代理 35% 折扣
🔥 PATCHRIGHT40 - ISP（静态）代理 40% 折扣

^{选择 NodeMaven 的品质与稳定。}

---

ColaProxy：低成本的住宅代理，适用于可扩展的自动化、爬取和全球数据访问

为什么选择 ColaProxy？

• 动态住宅代理，低至 $0.3/GB
• 覆盖 195+ 个国家的大量住宅 IP 池
• 99.9% 正常运行时间，连接稳定且快速
• 支持 HTTP / HTTPS / SOCKS5 协议
• 轮换与粘性会话，实现灵活自动化
• 精确的国家级地理定位
• 全天候专家支持

需要为 Patchright 自动化寻找可靠的代理？ColaProxy 提供经济高效的住宅、ISP 和移动代理解决方案，适用于爬取、测试、账户管理、SEO 监控和全球数据收集。使用优惠码 COLA20 享受订单 20% 折扣。

^{价格实惠、稳定且专为开发者打造。使用 ColaProxy 开始扩展您的 Patchright 项目。}

---

补丁

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 测试进行验证。请参阅这里。