🎭 Patchright

Patchright è una versione patchata e non rilevata del framework di testing e automazione Playwright.
Può essere utilizzato come sostituto diretto di Playwright.

[!NOTE]
Questo repository fornisce il Patchright Driver. Per usare Patchright, consulta il Python Package, il NodeJS Package o il community-driven .Net Package

[!IMPORTANT]
Patchright patcha solo browser basati su CHROMIUM. Firefox e Webkit non sono supportati.

Patch

Leak di Runtime.enable

Questa è la patch più importante che Patchright utilizza. Per evitare il rilevamento tramite questa leak, patchright evita di usare Runtime.enable eseguendo JavaScript in ExecutionContext (isolati).

Patchright corregge questa leak disabilitando del tutto la Console API. Ciò significa che la funzionalità console non funzionerà in Patchright. Se hai davvero bisogno della console, potresti cavartela meglio usando logger JavaScript, anche se anche questi possono essere facilmente rilevati.

Leak dei Flag di Comando

Patchright modifica gli argomenti predefiniti di Playwright per evitare il rilevamento tramite le leak dei flag di comando. Questo (in particolare) riguarda:

--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 driver stealth.
--disable-default-apps (rimosso) per abilitare le app predefinite.
--disable-extensions (rimosso) per abilitare le estensioni

Leak generali

Patchright corregge alcune leak generali nel codebase di Playwright. Questo include principalmente configurazioni scadenti e punti di rilevamento ovvi.

Shadow Root chiusi

Patchright è in grado di interagire con gli elementi all'interno di Closed Shadow Roots. Usa semplicemente i normali locator e Patchright farà il resto.
Patchright ora è anche in grado di usare XPath all'interno di Closed Shadow Roots.

Stealth

Con la giusta configurazione, Patchright è attualmente considerato non rilevabile. Patchright supera:

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

Bug

Anche se abbiamo dedicato molto tempo a rendere Patchright il più stabile possibile, i bug possono ancora verificarsi. Se incontri dei bug, segnalali nelle Issues.

Patchright ora viene testato contro i test di Playwright dopo ogni release. Vedi qui

[!WARNING]
Patchright supera la maggior parte, ma non tutti, i test di Playwright. Alcuni bug sono considerati impossibili da risolvere, altri semplicemente non rilevanti. Vedi l'elenco dei bug e le relative spiegazioni qui.

Sulla base dei test di Playwright, abbiamo concluso che è molto improbabile che tu possa essere colpito da questi bug negli usi abituali.

Stranezze degli Init Script

Spiegazione

Per poter usare InitScripts senza Runtime.enable, Patchright usa le Route di Playwright per iniettare JavaScript nelle richieste HTML.

Bug

Le Route di Playwright possono causare alcuni bug in altre parti del tuo codice. Gli InitScript di Patchright non causeranno bug che non sarebbero causati anche dalle normali Route di Playwright.
Se vuoi che questi bug vengano corretti, dovrai contattare il team di Playwright.

Leak

Gli InitScript di Patchright possono essere rilevati tramite Timing Attack. Tuttavia, attualmente nessun antibot controlla questo tipo di Timing Attack e probabilmente non lo farà per parecchio tempo.
Non li consideriamo un grande rischio di rilevamento.

TODO

Implementare l'opzione per scegliere l'ExecutionContext (Main/Isolated).
Correggere i bug risolvibili.
Implementare l'aggiornatore .patch per mostrare facilmente le patch di Patchright.
Configurare test automatici a ogni nuova release.
Implementare Patchright su .NET.
Implementare Patchright su Java.

Sviluppo

La distribuzione di nuove versioni di Patchright è automatica, ma possono verificarsi bug dovuti a modifiche del 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 o @steve_abcdef su Discord.

Copyright e Licenza

Patchright è concesso in licenza Apache 2.0

Alcune parti del codebase sono ispirate a Driverless. Grazie a Nick Webson per l'idea della documentazione dei file .patch.

Esclusione di responsabilità

Questo repository è fornito solo a scopo educativo.
Non vengono fornite garanzie riguardo accuratezza, completezza o idoneità a qualsiasi scopo. Usalo a tuo rischio—gli autori e i maintainer non si assumono alcuna responsabilità per danni, problemi legali o violazioni di garanzia derivanti da utilizzo, modifica o distribuzione di questo codice.
Qualsiasi uso improprio o violazione legale è di esclusiva responsabilità dell'utente.

Autori

Maintainer attivo: Vinyzu
Co-Maintainer: Kaliiiiiiiiii

patchright v1.62.1

Categorie