kaliiiiiiiiii-vinyzu/patchrightVersione non rilevabile della libreria di test e automazione Playwright.
<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 è una versione patchata e non rilevata del framework di testing e automazione Playwright. </br> Può essere utilizzato come sostituto diretto di Playwright.
> [!NOTE]
> Questo repository ospita il Driver di Patchright. Per utilizzare Patchright, consulta il [Pacchetto Python](https://github.com/Kaliiiiiiiiii-Vinyzu/patchright-python), il [Pacchetto NodeJS](https://github.com/Kaliiiiiiiiii-Vinyzu/patchright-nodejs) o il [Pacchetto .Net](https://github.com/DevEnterpriseSoftware/patchright-dotnet) _gestito dalla community_
> [!IMPORTANT]
> Patchright applica patch solo ai browser basati su CHROMIUM. Firefox e Webkit non sono supportati.
---
<details open id="sponsors">
<summary><h3>Sponsor</h1></summary>
<sup>Vuoi sponsorizzare questo progetto? Contatta [@vinyzu](https://discordapp.com/users/935224495126487150) su 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): il tuo provider di proxy efficiente per Web Scraping e Automazione con IP di alta qualità.
Perché [NodeMaven](https://go.nodemaven.com/Vinyzuoctober)?
🎯 Targeting per ZIP
</br>
✅ Uptime del 99,9%
</br>
🔍 Filtro IP: i proxy hanno garanzia di fraud score <97%
</br>
🔰 Nessun KYC richiesto
</br>
🎉 Strumenti gratuiti esclusivi: Proxy Bandwidth Checker, Meta Tag Checker, IP Lookup e altri!
**Codici speciali** per gli utenti di Patchright:
</br>
🔥 **PATCHRIGHT35** - **35% di sconto** sui proxy Mobile e Residenziali
</br>
🔥 **PATCHRIGHT40** - **40% di sconto** sui proxy ISP (Statici)
<sup>Scegli qualità e stabilità con [NodeMaven](https://go.nodemaven.com/Vinyzuoctober).</sup>
</br>
<sup>Dai un'occhiata al nuovo GitHub di Nodemaven per ulteriori soluzioni di web scraping e automazione - 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): proxy residenziali ad alte prestazioni per una raccolta dati scalabile
Progettato per gli sviluppatori che necessitano di un'infrastruttura proxy **affidabile** e anti-rilevamento. [Swiftproxy](https://www.swiftproxy.net/?ref=Vinyzu) offre **connessioni stabili**, **alti tassi di successo** e un controllo flessibile per **scraping e automazione su larga scala**.
- 🌍 Oltre 195 località con IP residenziali di provenienza etica
- 🔄 Sessioni **rotanti** e **sticky** con geo-targeting preciso
- ⚡ Ottimizzato per **l'anti-ban** e **un alto tasso di successo**
- 🔌 Supporto HTTP / HTTPS / SOCKS5
- 🧪 **Prova gratuita da 500MB** per testare
- 💸 Codice **sconto speciale** per gli utenti di Patchright: **PROXY90 - 10%**
<sup> Ideale per: web scraping, automazione, multi-accounting ed estrazione dati su larga scala </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) offre una rete proxy stabile e ad alte prestazioni pensata per operazioni dati su larga scala.
[RapidProxy](https://www.rapidproxy.io/?ref=Vinyzu) offre:
- 🌍 Oltre 90M di IP residenziali (oltre 200 località)
- 🔄 **Proxy residenziali rotanti** — a partire da **$0,65/GB** (traffico senza scadenza)
- 🧩 **IP residenziali statici** — **$5/IP** (30 giorni, traffico illimitato)
- 🎯 Geo-targeting preciso
- ⚡ **Prova gratuita disponibile** — testa le prestazioni dei proxy senza rischi
- Pensato per scraping, automazione e flussi di lavoro dati ad alte prestazioni.
- 🔥 Offerta speciale: usa il codice **RAPID10** per ottenere il **10% di sconto**
<sup> Inizia velocemente. Scala globalmente. Rimani stabile con [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">
### Sponsorizzato da [Scrappey](https://scrappey.com?utm_source=patchright&utm_medium=github&utm_campaign=repo_readme)
</div>
Far superare il rilevamento al browser è un problema. Mantenere i proxy in rotazione, le fingerprint
aggiornate e le sessioni attive attraverso qualche milione di richieste è un problema diverso. **Scrappey**
si occupa del secondo: un unico endpoint, pagine risolte in risposta.
- **Clearcote** — il nostro Chromium con patch, mantenuto internamente, non una build standard
- **Diversi motori dietro un unico endpoint** — bloccato su uno stack, reindirizzato a un altro
- **Click, digitazione, attesa e scroll** tramite l'API — una sessione reale, non un proxy di fetch
- **Proxy residenziali e datacenter** inclusi, oppure porta i tuoi
- **A richiesta**, nessun minimo mensile
```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"}'
```
Ottieni il 10% di sconto con il codice `PATCHRIGHT`
[Documentazione](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) · [Ottieni una chiave API](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): proxy residenziali che mantengono coerente ogni profilo Patchright.
Per far corrispondere il fuso orario dichiarato al tuo proxy, assegna a ogni profilo il proprio IP sticky associato a una città e imposta lo stesso fuso orario:
```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>Suggerimento: imposta `--webrtc-ip-handling-policy=disable_non_proxied_udp`, altrimenti [WebRTC espone il tuo IP reale](https://github.com/Kaliiiiiiiiii-Vinyzu/patchright-python/issues/47).</sup>
:earth_africa: 28M di IP residenziali in 195 paesi, targeting per città, CAP e ASN
</br>
:stopwatch: Sessioni sticky fino a 72h, HTTP e SOCKS5
</br>
:money_with_wings: A partire da $2/GB, il traffico non scade mai
:fire: **PATCHLANE35** - **35% di sconto** per gli utenti di Patchright
<sup>Incolla lo snippet, aggiungi le tue credenziali ed esegui la tua prossima sessione Patchright su un vero IP residenziale con [ProxyLane](https://proxylane.dev/?utm_source=patchright&utm_medium=partnership&utm_campaign=patchright_sponsor_202610&utm_content=readme_caption).</sup>
</details>
---
## Patch
### Leak di [Runtime.enable](https://vanilla.aslushnikov.com/?Runtime.enable)
Questa è la più grande patch utilizzata da Patchright. Per evitare il rilevamento tramite questo leak, patchright evita di usare [Runtime.enable](https://vanilla.aslushnikov.com/?Runtime.enable) eseguendo Javascript in ExecutionContext (isolati).
### Leak di [Console.enable](https://vanilla.aslushnikov.com/?Console.enable)
Patchright corregge questo leak disabilitando completamente l'API Console. Ciò significa che la funzionalità della console non funzionerà in Patchright. Se hai davvero bisogno della console, potresti fare meglio a usare logger Javascript, anche se anch'essi possono essere facilmente rilevati.
### Leak dei Command Flag
Patchright modifica i Default Args di Playwright per evitare il rilevamento tramite i Command Flag Leak. Questo (soprattutto) influisce su:
- `--disable-blink-features=AutomationControlled` (aggiunto) per evitare il rilevamento di navigator.webdriver.
- `--enable-automation` (rimosso) per evitare il rilevamento di navigator.webdriver.
- `--disable-popup-blocking` (rimosso) per evitare il crash dei popup.
- `--disable-component-update` (rimosso) per evitare il rilevamento come Stealth Driver.
- `--disable-default-apps` (rimosso) per abilitare le app predefinite.
- `--disable-extensions` (rimosso) per abilitare le estensioni
### Leak generali
Patchright corregge alcuni leak generali nel codebase di Playwright. Questo include principalmente configurazioni scadenti e ovvi punti di rilevamento.
### Closed Shadow Roots
Patchright è in grado di interagire con gli elementi nei Closed Shadow Roots. Basta usare i normali locator e Patchright farà il resto.
<br/>
Patchright ora è anche in grado di usare gli XPath nei Closed Shadow Roots.
---
## Stealth
Con la giusta configurazione, Patchright è attualmente considerato non rilevabile.
Patchright supera:
- [Brotector](https://kaliiiiiiiiii.github.io/brotector/) ✅ (con [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/) ✅
---
## Bug
#### Nonostante abbiamo dedicato molto tempo a rendere Patchright il più stabile possibile, possono comunque verificarsi dei bug. Se incontri dei bug, segnalali nelle [Issues](https://github.com/Kaliiiiiiiiii-Vinyzu/patchright/issues).
#### Patchright viene ora testato rispetto ai Playwright Tests dopo ogni release. Vedi [qui](https://github.com/Kaliiiiiiiiii-Vinyzu/patchright-python/actions/workflows/patchright_tests.yml)
> [!WARNING]
> Patchright supera la maggior parte, ma non tutti, i Playwright tests. Alcuni bug sono considerati impossibili da risolvere, altri semplicemente non sono rilevanti. Vedi l'elenco dei bug e la loro spiegazione [qui](https://github.com/Kaliiiiiiiiii-Vinyzu/patchright/issues/30).
#### Sulla base dei Playwright Tests, abbiamo concluso che è altamente improbabile che tu sia interessato da questi bug nei casi d'uso regolari.
<details>
<summary><b>Stranezze degli Init Script</b></summary>
### Spiegazione
Per poter utilizzare gli InitScripts senza [Runtime.enable](https://vanilla.aslushnikov.com/?Runtime.enable), Patchright utilizza le Playwright Routes per iniettare JavaScript nelle richieste HTML.
### Bug
Le Playwright Routes possono causare alcuni bug in altre parti del tuo codice. Gli InitScripts di Patchright non causeranno alcun bug che non sarebbe causato dalle normali Playwright Routes. </br> Se desideri che uno di questi bug venga risolto, dovrai contattare il team di Playwright.
### Perdite
Gli InitScripts di Patchright possono essere rilevati tramite Timing Attacks. Tuttavia, attualmente nessun antibot verifica questo tipo di Timing Attack e probabilmente non lo farà per molto tempo. </br> Li consideriamo un rischio di rilevamento non significativo.
</details>
---
### TODO
- [x] Implementare l'opzione per scegliere l'Execution Context (Main/Isolated).
- [x] Correggere i bug correggibili.
- [x] Implementare l'aggiornamento .patch per mostrare facilmente le patch di Patchright.
- [x] Configurare i test automatizzati sulle nuove Release.
- [x] Implementare Patchright su .NET.
- [ ] Implementare Patchright su Java.
---
## Sviluppo
Il rilascio delle nuove versioni di Patchright è automatico, ma possono verificarsi bug dovuti a modifiche al codebase di Playwright. Le correzioni per questi bug potrebbero richiedere alcuni giorni prima di essere rilasciate.
---
## Supporta il nostro lavoro
Se scegli di supportare il nostro lavoro, contatta [@vinyzu](https://discord.com/users/935224495126487150) o [@steve_abcdef](https://discord.com/users/936292409426477066) su Discord.
---
## Copyright e Licenza
© [Vinyzu](https://github.com/Vinyzu/)
Patchright è distribuito con licenza [Apache 2.0](https://choosealicense.com/licenses/apache-2.0/)
[Alcune parti](https://github.com/Kaliiiiiiiiii-Vinyzu/patchright/blob/10c5a090e9a1dcd2107c253d65b3d8b27d0670a9/driver_patches/framesPatch.ts#L156-L171) del codebase sono ispirate a [Driverless](https://github.com/kaliiiiiiiiii/Selenium-Driverless).
Grazie a [Nick Webson](https://github.com/rebrowser/rebrowser-patches) per l'idea della documentazione tramite file .patch.
---
## Disclaimer
Questo repository è fornito **esclusivamente a scopo educativo**. \
Non vengono fornite garanzie in merito a accuratezza, completezza o idoneità per qualsiasi scopo. **Utilizzare a proprio rischio**—gli autori e i manutentori non si assumono **alcuna responsabilità** per **eventuali danni**, **problemi legali** o **violazioni di garanzia** derivanti dall'uso, dalla modifica o dalla distribuzione di questo codice.\
**Qualsiasi uso improprio o violazione legale è esclusivamente responsabilità dell'utente**.
---
## Autori
#### Maintainer attivo: [Vinyzu](https://github.com/Vinyzu/) </br> Co-Maintainer: [Kaliiiiiiiiii](https://github.com/kaliiiiiiiiii/)