🎭 Patchright

Patchright — это пропатченная и необнаруживаемая версия фреймворка для тестирования и автоматизации Playwright.
Его можно использовать в качестве готовой замены Playwright.

[!NOTE]
Этот репозиторий содержит Patchright Driver. Чтобы использовать Patchright, ознакомьтесь с Python-пакетом, NodeJS-пакетом или создаваемым сообществом .Net-пакетом

[!IMPORTANT]
Patchright вносит патчи только в браузеры на основе Chromium. Firefox и Webkit не поддерживаются.

---

Спонсоры

^{Хотите спонсировать этот проект? Свяжитесь с @vinyzu в Discord!}

Swiftproxy: высокопроизводительные резидентные прокси для масштабируемого сбора данных

Создано для разработчиков, которым нужна надёжная прокси-инфраструктура с защитой от обнаружения. Swiftproxy обеспечивает стабильные соединения, высокий процент успешных запросов и гибкий контроль для крупномасштабного скрапинга и автоматизации.

• 🌍 195+ локаций с этично полученными резидентными IP
• 🔄 Ротационные и липкие сессии с точным геотаргетингом
• ⚡ Оптимизировано для анти-бана и высокого процента успешных запросов
• 🔌 Поддержка HTTP / HTTPS / SOCKS5
• 🧪 Бесплатный пробный доступ 500 МБ для тестирования
• 💸 Специальный промокод для пользователей Patchright: PROXY90 — скидка 10%

^{Лучше всего подходит для: веб-скрапинга, автоматизации, мультиаккаунтинга и крупномасштабного извлечения данных}

---

---

Патчи

Утечка Runtime.enable

Это самый серьёзный патч, используемый Patchright. Чтобы избежать обнаружения через эту утечку, Patchright не использует Runtime.enable, выполняя 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 (удалён), чтобы избежать обнаружения в качестве Stealth-драйвера.
• --disable-default-apps (удалён), чтобы включить стандартные приложения.
• --disable-extensions (удалён), чтобы включить расширения.

Общие утечки

Patchright исправляет некоторые общие утечки в кодовой базе Playwright. В основном это неудачные настройки и очевидные точки обнаружения.

Закрытые Shadow Root

Patchright может взаимодействовать с элементами в закрытых Shadow Root. Просто используйте обычные локаторы, а Patchright сделает остальное.
Patchright теперь также может использовать XPath в закрытых Shadow Root.

---

Стелс

При правильной настройке Patchright в настоящее время считается необнаруживаемым. Patchright проходит:

• Brotector ✅ (с CDP-Patches)
• Cloudflare ✅
• Kasada ✅
• Akamai ✅
• Shape/F5 ✅
• Bet365 ✅
• Datadome ✅
• Fingerprint.com ✅
• CreepJS ✅
• Sannysoft ✅
• Incolumitas ✅
• IPHey ✅
• Browserscan ✅
• Pixelscan ✅

---

Баги

Несмотря на то, что мы потратили много времени, чтобы сделать Patchright максимально стабильным, баги всё ещё могут возникать. Если вы столкнулись с какими-либо багами, пожалуйста, сообщите о них в Issues.

После каждого релиза Patchright проходит тесты Playwright. См. здесь

[!WARNING]
Patchright проходит большинство, но не все тесты Playwright. Некоторые баги считаются неразрешимыми, некоторые просто неактуальны. Список багов и их пояснения см. здесь.

Основываясь на тестах Playwright, мы пришли к выводу, что в обычных сценариях использования вы вряд ли столкнётесь с этими багами.

Проделки Init Script

Пояснение

Чтобы иметь возможность использовать InitScripts без Runtime.enable, Patchright использует Playwright Routes для внедрения JavaScript в HTML-запросы.

Баги

Playwright Routes могут вызывать некоторые баги в других частях вашего кода. InitScripts в Patchright не вызовут багов, которые не могли бы быть вызваны обычными Playwright Routes.
Если вы хотите, чтобы какие-либо из этих багов были исправлены, вам придётся связаться с командой Playwright.

Утечки

InitScripts в Patchright могут быть обнаружены с помощью Timing Attacks. Однако в настоящее время ни один антибот не проверяет подобные Timing Attacks, и, скорее всего, ещё долгое время не будет.
Мы считаем, что они не несут большого риска обнаружения.

---

TODO

• Реализовать опцию выбора контекста выполнения (Main/Isolated).
• Устранить устранимые баги.
• Реализовать .patch Updater для удобного отображения патчей Patchright.
• Настроить автоматическое тестирование при новом релизе.
• Реализовать Patchright на .NET.
• Реализовать Patchright на Java.

---

Разработка

Развёртывание новых версий Patchright происходит автоматически, но из-за изменений в кодовой базе Playwright могут возникать баги. Исправления этих багов могут выйти через несколько дней.

---

Поддержите нашу работу

Если вы хотите поддержать нашу работу, свяжитесь с @vinyzu или @steve_abcdef в Discord.

---

Авторские права и лицензия

© Vinyzu

Patchright распространяется по лицензии Apache 2.0

Некоторые части кодовой базы вдохновлены Driverless. Спасибо Nick Webson за идею документирования .patch-файлов.

---

Отказ от ответственности

Этот репозиторий предоставляется только в образовательных целях.
Никаких гарантий относительно точности, полноты или пригодности для каких-либо целей не предоставляется. Используйте на свой страх и риск — авторы и сопровождающие не несут никакой ответственности за любой ущерб, юридические проблемы или нарушения гарантий, возникшие в результате использования, изменения или распространения этого кода.
Любое неправомерное использование или нарушение закона является исключительной ответственностью пользователя.

---

Авторы

Активный мейнтейнер: Vinyzu
Со-мейнтейнер: Kaliiiiiiiiii