kaliiiiiiiiii-vinyzu/patchrightNicht erkannte Version der Playwright-Test- und Automatisierungsbibliothek.
<h1 align="center">
🎭 Patchright
</h1>
<p align="center">
<a href="https://github.com/Kaliiiiiiiiii-Vinyzu/patchright/blob/main/LICENSE">
<img src="https://img.shields.io/badge/License-Apache%202.0-green">
</a>
<a>
<img src="https://img.shields.io/badge/Based%20on-Playwright-goldenrod">
</a>
<a>
<img src="https://img.shields.io/badge/Driver-Patched-blue">
</a>
<a href="https://github.com/Kaliiiiiiiiii-Vinyzu/patchright/releases/latest">
<img alt="Patchright Version" src="https://img.shields.io/github/v/release/Kaliiiiiiiiii-Vinyzu/patchright?display_name=release&label=Version">
</a>
<br/>
<a href="https://github.com/Kaliiiiiiiiii-Vinyzu/patchright-python">
<img src="https://img.shields.io/badge/Package-Python-seagreen">
</a>
<a href="https://github.com/Kaliiiiiiiiii-Vinyzu/patchright-python/releases">
<img alt="Python Downloads" src="https://img.shields.io/pepy/dt/patchright?color=red&label=Python%20Downloads">
</a>
<a href="https://github.com/Kaliiiiiiiiii-Vinyzu/patchright-nodejs">
<img src="https://img.shields.io/badge/Package-NodeJS-seagreen">
</a>
<a href="https://github.com/Kaliiiiiiiiii-Vinyzu/patchright-nodejs/releases">
<img alt="NodeJS Downloads" src="https://img.shields.io/npm/d18m/patchright?color=red&label=NodeJS%20Downloads">
</a>
<a href="https://github.com/DevEnterpriseSoftware/patchright-dotnet">
<img src="https://img.shields.io/badge/Package-.Net-seagreen">
</a>
<a href="https://github.com/Kaliiiiiiiiii-Vinyzu/patchright-nodejs/releases">
<img alt=".Net Downloads" src="https://img.shields.io/nuget/dt/Patchright?label=.Net%20Downloads">
</a>
<br/>
<img src="https://img.shields.io/github/actions/workflow/status/Kaliiiiiiiiii-Vinyzu/patchright/patchright_tests.yml?label=Patchright%20Driver%20Tests">
<img src="https://img.shields.io/github/actions/workflow/status/Kaliiiiiiiiii-Vinyzu/patchright-python/patchright_tests.yml?label=Patchright%20Python%20Tests">
<img src="https://img.shields.io/github/actions/workflow/status/DevEnterpriseSoftware/patchright-dotnet/patchright_test.yml?label=Patchright%20.Net%20Tests">
</p>
#### Patchright ist eine gepatchte und nicht erkennbare Version des Playwright Testing and Automation Framework. </br> Sie kann als direkter Ersatz für Playwright verwendet werden.
> [!NOTE]
> Dieses Repository stellt den Patchright Driver bereit. Um Patchright zu verwenden, sieh dir das [Python Package](https://github.com/Kaliiiiiiiiii-Vinyzu/patchright-python), das [NodeJS Package](https://github.com/Kaliiiiiiiiii-Vinyzu/patchright-nodejs) oder das _community-getriebene_ [.Net Package](https://github.com/DevEnterpriseSoftware/patchright-dotnet/) an.
> [!IMPORTANT]
> Patchright patcht nur CHROMIUM-basierte Browser. Firefox und Webkit werden nicht unterstützt.
---
<details open id="sponsors">
<summary><h3>Sponsoren</h1></summary>
<sup>Möchtest du dieses Projekt sponsern? Kontaktiere [@vinyzu](https://discordapp.com/users/935224495126487150) auf Discord!</sup>
[<img width="60%" alt="NodeMaven Banner" src="https://assets.kitploit.com/production/public/readmes/41476/8409e9fd4ecade7fa018f576c77d6f51fb342f311f9e8e2b49984de007b5a605/fc71d82e04f5dc303d21f905310e811885d8a6a57ddffe892b4164bf12547371-display-v1.webp" />](https://go.nodemaven.com/Vinyzuoctober)
</br>
#### [NodeMaven](https://go.nodemaven.com/Vinyzuoctober): Dein effizienter Proxy-Anbieter für Web Scraping und Automatisierung mit hochwertigen IPs.
Warum [NodeMaven](https://go.nodemaven.com/Vinyzuoctober)?
🎯 ZIP-Targeting
</br>
✅ 99,9 % Uptime
</br>
🔍 IP-Filterung: Proxies haben garantiert einen Fraud Score <97 %
</br>
🔰 Kein KYC erforderlich
</br>
🎉 Einzigartige kostenlose Tools: Proxy Bandwidth Checker, Meta Tag Checker, IP Lookup und weitere!
**Spezielle Codes** für Patchright-Nutzer:
</br>
🔥 **PATCHRIGHT35** – **35 % Rabatt** auf Mobile- und Residential-Proxies
</br>
🔥 **PATCHRIGHT40** – **40 % Rabatt** auf ISP-(Static-)Proxies
<sup>Wählen Sie Qualität und Stabilität mit [NodeMaven](https://go.nodemaven.com/Vinyzuoctober).</sup>
</br>
<sup>Besuchen Sie das neue GitHub von Nodemaven für weitere Web-Scraping- und Automatisierungslösungen - https://github.com/nodemaven</sup>
---
[<img height="100" alt="swiftproxy banner" src="https://assets.kitploit.com/production/public/readmes/41476/71326e65aa66112fe5c3cd5a61951b775d58850b93eaaf166fd77930681f5174.png" />](https://www.swiftproxy.net/?ref=Vinyzu)
#### [Swiftproxy](https://www.swiftproxy.net/?ref=Vinyzu): Hochleistungs-Residential-Proxies für skalierbare Datenerfassung
Entwickelt für Entwickler, die **zuverlässige** Proxy-Infrastruktur mit Anti-Detection benötigen. [Swiftproxy](https://www.swiftproxy.net/?ref=Vinyzu) liefert **stabile Verbindungen**, **hohe Erfolgsraten** und flexible Kontrolle für **groß angelegtes Scraping und Automatisierung**.
- 🌍 195+ Standorte mit ethisch bezogenen Residential-IPs
- 🔄 **Rotierende** & **Sticky-Sessions** mit präzisem Geo-Targeting
- ⚡ Optimiert für **Anti-Ban** & **hohe Erfolgsrate**
- 🔌 HTTP / HTTPS / SOCKS5-Unterstützung
- 🧪 **Kostenlose 500MB-Testversion** zum Ausprobieren
- 💸 **Spezieller Rabattcode** für Patchright-Nutzer: **PROXY90 - 10%**
<sup> Am besten für: Web-Scraping, Automatisierung, Multi-Accounting und groß angelegte Datenextraktion </sup>
---
[<img height="90" alt="rapidproxy banner" src="https://assets.kitploit.com/production/public/readmes/41476/2c138417cf7695cb48943327f3d6d9036986882c2a4ffe5e9172f07386a9f229.png" />](https://www.rapidproxy.io/?ref=Vinyzu)
#### [RapidProxy](https://www.rapidproxy.io/?ref=Vinyzu) bietet ein stabiles und leistungsstarkes Proxy-Netzwerk für groß angelegte Datenoperationen.
[RapidProxy](https://www.rapidproxy.io/?ref=Vinyzu) liefert:
- 🌍 90M+ Residential-IPs (200+ Standorte)
- 🔄 **Rotierende Residential-Proxies** — ab **$0,65/GB** (nicht ablaufender Traffic)
- 🧩 **Statische Residential-IPs** — **$5/IP** (30 Tage, unbegrenzter Traffic)
- 🎯 Präzises Geo-Targeting
- ⚡ **Kostenlose Testversion verfügbar** — testen Sie die Proxy-Leistung risikofrei
- Entwickelt für Scraping, Automatisierung und leistungsstarke Daten-Workflows.
- 🔥 Sonderangebot: Verwenden Sie den Code **RAPID10** für **10% Rabatt**
<sup> Schnell starten. Global skalieren. Stabil bleiben mit [RapidProxy](https://www.rapidproxy.io/?ref=Vinyzu). </sup>
---
<div align="center">
<img src="https://assets.kitploit.com/production/public/readmes/41476/f3ac5dd3dd1ac541342eeda194f605fe1e28f9b044c0a90867b6db914c4a1b48/ad967b2ca510d337e9c8e72d654869c8fc75b08b088e358e074a6bbb003e6639-display-v1.webp" width="56" alt="Scrappey">
### Gesponsert von [Scrappey](https://scrappey.com?utm_source=patchright&utm_medium=github&utm_campaign=repo_readme)
</div>
Den Browser an der Erkennung vorbeizubringen, ist das eine Problem. Proxies rotierend zu halten, Fingerprints aktuell und Sessions über einige Millionen Anfragen hinweg am Leben zu halten, ist ein anderes. **Scrappey** übernimmt das zweite Problem: ein Endpoint, gelöste Seiten zurück.
- **Clearcote** — unser eigener gepatchter Chromium, intern gepflegt, kein Standard-Build
- **Mehrere Engines hinter einem Endpoint** — auf einem Stack blockiert, auf einen anderen umgeleitet
- **Klicken, Tippen, Warten und Scrollen** über die API — eine echte Session, kein Fetch-Proxy
- **Residential- und Datacenter-Proxies** inklusive, oder bringen Sie Ihre eigenen mit
- **Pro Anfrage**, kein monatliches Minimum
```bash
curl -X POST "https://publisher.scrappey.com/api/v1?key=YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"cmd": "request.get", "url": "https://example.com"}'
```
Erhalte 10 % Rabatt mit dem Code `PATCHRIGHT`
[Dokumentation](https://scrappey.com/docs?utm_source=patchright&utm_medium=github&utm_campaign=repo_readme) · [Discord](https://scrappey.com/discord?utm_source=patchright&utm_medium=github&utm_campaign=repo_readme) · [API-Schlüssel erhalten](https://scrappey.com?utm_source=patchright&utm_medium=github&utm_campaign=repo_readme)
---
[<img height="120" alt="ProxyLane Banner" src="https://assets.kitploit.com/production/public/readmes/41476/ed95563a028e0c1cefb4f5dccc8f7b69653f4c3fb7d5c4b5099b4cd5718714b7/7afb4fb03926a17d778280ff8bc7b2f62f5206d212d2b7525ea6ee90ae8ed0d3-display-v1.webp" />](https://proxylane.dev/?utm_source=patchright&utm_medium=partnership&utm_campaign=patchright_sponsor_202610&utm_content=readme)
</br>
#### [ProxyLane](https://proxylane.dev/?utm_source=patchright&utm_medium=partnership&utm_campaign=patchright_sponsor_202610&utm_content=readme): Residential-Proxies, die jedes Patchright-Profil konsistent halten.
Um die gemeldete Zeitzone an deinen Proxy anzupassen, gib jedem Profil eine eigene, an eine Stadt gebundene Sticky-IP und lege dieselbe Zeitzone fest:
```py
context = playwright.chromium.launch_persistent_context(
user_data_dir="...", channel="chrome", headless=False, no_viewport=True,
proxy={"server": "http://us.gw.proxylane.dev:10000",
"username": "USER_c_US_city_Chicago_s_profile1", # one sticky IP per profile
"password": "PASS"},
timezone_id="America/Chicago", locale="en-US", # match the proxy city
)
```
<sup>Tipp: Setze `--webrtc-ip-handling-policy=disable_non_proxied_udp`, da sonst [WebRTC deine echte IP preisgibt](https://github.com/Kaliiiiiiiiii-Vinyzu/patchright-python/issues/47).</sup>
:earth_africa: 28 Mio. Residential-IPs in 195 Ländern, Targeting nach Stadt, PLZ und ASN
</br>
:stopwatch: Sticky Sessions bis zu 72 h, HTTP und SOCKS5
</br>
:money_with_wings: Ab 2 $/GB, Traffic läuft nie ab
:fire: **PATCHLANE35** – **35 % Rabatt** für Patchright-Nutzer
<sup>Füge den Snippet ein, ergänze deine Zugangsdaten und starte deine nächste Patchright-Session über eine echte Residential-IP mit [ProxyLane](https://proxylane.dev/?utm_source=patchright&utm_medium=partnership&utm_campaign=patchright_sponsor_202610&utm_content=readme_caption).</sup>
</details>
---
## Patches
### [Runtime.enable](https://vanilla.aslushnikov.com/?Runtime.enable)-Leak
Dies ist der größte Patch, den Patchright verwendet. Um eine Erkennung durch dieses Leak zu vermeiden, verzichtet Patchright auf die Verwendung von [Runtime.enable](https://vanilla.aslushnikov.com/?Runtime.enable), indem JavaScript in (isolierten) ExecutionContexts ausgeführt wird.
### [Console.enable](https://vanilla.aslushnikov.com/?Console.enable)-Leak
Patchright behebt dieses Leak, indem die Console-API vollständig deaktiviert wird. Das bedeutet, dass die Konsolenfunktionalität in Patchright nicht funktioniert. Wenn du die Konsole wirklich benötigst, solltest du besser JavaScript-Logger verwenden, obwohl auch diese leicht erkannt werden können.
### Leaks durch Command Flags
Patchright passt die Playwright-Standardargumente an, um eine Erkennung durch Command-Flag-Leaks zu vermeiden. Dies betrifft (am wichtigsten):
- `--disable-blink-features=AutomationControlled` (hinzugefügt), um die Erkennung von navigator.webdriver zu vermeiden.
- `--enable-automation` (entfernt), um die Erkennung von navigator.webdriver zu vermeiden.
- `--disable-popup-blocking` (entfernt), um Popup-Abstürze zu vermeiden.
- `--disable-component-update` (entfernt), um eine Erkennung als Stealth Driver zu vermeiden.
- `--disable-default-apps` (entfernt), um Standard-Apps zu aktivieren.
- `--disable-extensions` (entfernt), um Erweiterungen zu aktivieren
### Allgemeine Leaks
Patchright behebt einige allgemeine Leaks in der Playwright-Codebasis. Dazu gehören hauptsächlich schlechte Setups und offensichtliche Erkennungspunkte.
### Geschlossene Shadow Roots
Patchright kann mit Elementen in geschlossenen Shadow Roots interagieren. Verwende einfach normale Locators, und Patchright erledigt den Rest.
<br/>
Patchright kann jetzt auch XPaths in geschlossenen Shadow Roots verwenden.
---
## Stealth
Mit dem richtigen Setup gilt Patchright derzeit als nicht erkennbar.
Patchright besteht:
- [Brotector](https://kaliiiiiiiiii.github.io/brotector/) ✅ (mit [CDP-Patches](https://github.com/Kaliiiiiiiiii-Vinyzu/CDP-Patches/))
- [Cloudflare](https://cloudflare.com/) ✅
- [Kasada](https://www.kasada.io/) ✅
- [Akamai](https://www.akamai.com/products/bot-manager/) ✅
- [Shape/F5](https://www.f5.com/) ✅
- [Bet365](https://bet365.com/) ✅
- [Datadome](https://datadome.co/products/bot-protection/) ✅
- [Fingerprint.com](https://fingerprint.com/products/bot-detection/) ✅
- [CreepJS](https://abrahamjuliot.github.io/creepjs/) ✅
- [Sannysoft](https://bot.sannysoft.com/) ✅
- [Incolumitas](https://bot.incolumitas.com/) ✅
- [IPHey](https://iphey.com/) ✅
- [Browserscan](https://browserscan.net/) ✅
- [Pixelscan](https://pixelscan.net/) ✅
---
## Bugs
#### Obwohl wir viel Zeit investiert haben, um Patchright so stabil wie möglich zu machen, können dennoch Bugs auftreten. Wenn du auf Bugs stößt, melde sie bitte in den [Issues](https://github.com/Kaliiiiiiiiii-Vinyzu/patchright/issues).
#### Patchright wird jetzt nach jedem Release gegen die Playwright-Tests getestet. Siehe [hier](https://github.com/Kaliiiiiiiiii-Vinyzu/patchright-python/actions/workflows/patchright_tests.yml)
> [!WARNING]
> Patchright besteht die meisten, aber nicht alle Playwright-Tests. Einige Bugs gelten als unlösbar, andere sind einfach nicht relevant. Siehe die Liste der Bugs und ihre Erklärung [hier](https://github.com/Kaliiiiiiiiii-Vinyzu/patchright/issues/30).
#### Basierend auf den Playwright-Tests kamen wir zu dem Schluss, dass es höchst unwahrscheinlich ist, dass du in regulären Anwendungsfällen von diesen Bugs betroffen bist.
<details>
<summary><b>Init-Script-Tricks</b></summary>
### Erklärung
Um InitScripts ohne [Runtime.enable](https://vanilla.aslushnikov.com/?Runtime.enable) verwenden zu können, nutzt Patchright Playwright Routes, um JavaScript in HTML-Anfragen einzuschleusen.
### Fehler
Playwright Routes können einige Fehler in anderen Teilen deines Codes verursachen. Patchright InitScripts verursachen keine Fehler, die nicht auch durch normale Playwright Routes verursacht würden. </br> Wenn du möchtest, dass einer dieser Fehler behoben wird, musst du dich an das Playwright-Team wenden.
### Leaks
Patchright InitScripts können durch Timing-Angriffe erkannt werden. Allerdings prüft derzeit kein Antibot auf diese Art von Timing-Angriff, und das wird wahrscheinlich noch geraume Zeit so bleiben. </br> Wir betrachten sie nicht als großes Erkennungsrisiko.
</details>
---
### TODO
- [x] Option zur Auswahl des Ausführungskontexts (Main/Isolated) implementieren.
- [x] Behebbare Fehler beheben.
- [x] .patch-Updater implementieren, um Patchrights Patches einfach anzuzeigen.
- [x] Automatisiertes Testen bei neuen Releases einrichten.
- [x] Patchright auf .NET implementieren.
- [ ] Patchright auf Java implementieren.
---
## Entwicklung
Die Bereitstellung neuer Patchright-Versionen erfolgt automatisch, aber aufgrund von Änderungen an der Playwright-Codebasis können Fehler auftreten. Korrekturen für diese Fehler können einige Tage bis zur Veröffentlichung dauern.
---
## Unterstütze unsere Arbeit
Wenn du unsere Arbeit unterstützen möchtest, kontaktiere bitte [@vinyzu](https://discord.com/users/935224495126487150) oder [@steve_abcdef](https://discord.com/users/936292409426477066) auf Discord.
---
## Copyright und Lizenz
© [Vinyzu](https://github.com/Vinyzu/)
Patchright ist unter [Apache 2.0](https://choosealicense.com/licenses/apache-2.0/) lizenziert.
[Einige Teile](https://github.com/Kaliiiiiiiiii-Vinyzu/patchright/blob/10c5a090e9a1dcd2107c253d65b3d8b27d0670a9/driver_patches/framesPatch.ts#L156-L171) der Codebasis sind von [Driverless](https://github.com/kaliiiiiiiiii/Selenium-Driverless) inspiriert.
Danke an [Nick Webson](https://github.com/rebrowser/rebrowser-patches) für die Idee der .patch-Dateidokumentation.
---
## Haftungsausschluss
Dieses Repository wird **ausschließlich zu Bildungszwecken** bereitgestellt. \
Es werden keine Gewährleistungen hinsichtlich Genauigkeit, Vollständigkeit oder Eignung für einen bestimmten Zweck übernommen. **Die Nutzung erfolgt auf eigenes Risiko** – die Autoren und Maintainer übernehmen **keine Haftung** für **jegliche Schäden**, **rechtliche Probleme** oder **Garantieverletzungen**, die aus der Nutzung, Änderung oder Verbreitung dieses Codes resultieren.\
**Jeglicher Missbrauch oder jegliche Rechtsverstöße liegen allein in der Verantwortung des Nutzers.**
---
## Autoren
#### Aktiver Maintainer: [Vinyzu](https://github.com/Vinyzu/) </br> Co-Maintainer: [Kaliiiiiiiiii](https://github.com/kaliiiiiiiiii/)