🎭 Patchright

Patchright é uma versão corrigida e não detectada do Playwright Testing and Automation Framework.
Pode ser usado como um substituto direto (drop-in) do Playwright.

[!NOTE]
Este repositório fornece o Patchright Driver. Para usar o Patchright, confira o Pacote Python, o Pacote NodeJS ou o Pacote .Net mantido pela comunidade

[!IMPORTANT]
O Patchright só aplica patches em navegadores baseados em CHROMIUM. Firefox e Webkit não são suportados.

---

Patrocinadores

^{Quer patrocinar este projeto? Contate @vinyzu no Discord!}

Swiftproxy: Proxies Residenciais de Alta Performance para Coleta de Dados em Escala

Construído para desenvolvedores que precisam de infraestrutura de proxy confiável e com anti-detecção. O Swiftproxy oferece conexões estáveis, altas taxas de sucesso e controle flexível para raspagem e automação em grande escala.

• 🌍 Mais de 195 locais com IPs residenciais de origem ética
• 🔄 Sessões rotativas e fixas (sticky) com geo-direcionamento preciso
• ⚡ Otimizado para anti-ban e alta taxa de sucesso
• 🔌 Suporte a HTTP / HTTPS / SOCKS5
• 🧪 Teste gratuito de 500MB para avaliação
• 💸 Código de desconto especial para usuários do Patchright: PROXY90 - 10%

^{Ideal para: Web scraping, automação, múltiplas contas e extração de dados em grande escala}

---

---

Patches

Vazamento do Runtime.enable

Este é o maior patch que o Patchright utiliza. Para evitar a detecção por esse vazamento, o Patchright evita usar o Runtime.enable executando JavaScript em ExecutionContexts (isolados).

Vazamento do Console.enable

O Patchright corrige esse vazamento desabilitando completamente a API Console. Isso significa que a funcionalidade de console não funcionará no Patchright. Se você realmente precisar do console, é melhor usar loggers JavaScript, embora eles também possam ser facilmente detectados.

Vazamentos de Flags de Comando

O Patchright ajusta os Argumentos Padrão do Playwright para evitar a detecção por vazamentos de flags de comando. Isso (principalmente) afeta:

• --disable-blink-features=AutomationControlled (adicionado) para evitar a detecção do navigator.webdriver.
• --enable-automation (removido) para evitar a detecção do navigator.webdriver.
• --disable-popup-blocking (removido) para evitar que pop-ups falhem.
• --disable-component-update (removido) para evitar a detecção como Stealth Driver.
• --disable-default-apps (removido) para permitir os aplicativos padrão.
• --disable-extensions (removido) para permitir extensões

Vazamentos Gerais

O Patchright corrige alguns vazamentos gerais na base de código do Playwright. Isso inclui principalmente configurações inadequadas e pontos de detecção óbvios.

Shadow Roots Fechados

O Patchright é capaz de interagir com elementos em Shadow Roots fechados. Basta usar os localizadores normais e o Patchright fará o resto.
O Patchright agora também é capaz de usar XPaths em Shadow Roots fechados.

---

Stealth

Com a configuração adequada, o Patchright atualmente é considerado indetectável. O Patchright passa em:

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

---

Bugs

Embora tenhamos dedicado muito tempo para tornar o Patchright o mais estável possível, bugs ainda podem ocorrer. Se você encontrar qualquer bug, por favor, reporte-o nas Issues.

O Patchright agora é testado contra os testes do Playwright após cada lançamento. Veja aqui

[!WARNING]
O Patchright passa na maioria, mas não em todos os testes do Playwright. Alguns bugs são considerados impossíveis de resolver, outros simplesmente não são relevantes. Veja a lista de bugs e suas explicações aqui.

Com base nos testes do Playwright, concluímos que é altamente improvável que você seja afetado por esses bugs em casos de uso comuns.

Artimanhas do Init Script

Explicação

Para poder usar InitScripts sem o Runtime.enable, o Patchright usa Playwright Routes para injetar JavaScript em requisições HTML.

Bugs

Playwright Routes podem causar alguns bugs em outras partes do seu código. Os InitScripts do Patchright não causarão nenhum bug que não seria causado por Playwright Routes normais.
Se você quiser que algum desses bugs seja corrigido, precisará entrar em contato com a equipe do Playwright.

Vazamentos

Os InitScripts do Patchright podem ser detectados por Timing Attacks. No entanto, nenhum antibot verifica atualmente esse tipo de Timing Attack e provavelmente não o fará por um bom tempo.
Não os consideramos um grande risco de detecção.

---

TODO

• Implementar opção para escolher o Execution Context (Main/Isolated).
• Corrigir bugs corrigíveis.
• Implementar atualizador .patch para exibir facilmente os patches do Patchright.
• Configurar testes automatizados em novos lançamentos.
• Implementar o Patchright no .NET.
• Implementar o Patchright no Java.

---

Desenvolvimento

A implantação de novas versões do Patchright é automática, mas bugs devido a mudanças na base de código do Playwright podem ocorrer. As correções para esses bugs podem levar alguns dias para serem lançadas.

---

Apoie nosso trabalho

Se você quiser apoiar nosso trabalho, entre em contato com @vinyzu ou @steve_abcdef no Discord.

---

Copyright e Licença

© Vinyzu

O Patchright é licenciado sob Apache 2.0

Algumas partes da base de código são inspiradas no Driverless. Agradecimentos ao Nick Webson pela ideia da documentação em arquivos .patch.

---

Aviso Legal

Este repositório é fornecido apenas para fins educacionais.
Não são fornecidas garantias quanto à precisão, integridade ou adequação a qualquer finalidade. Use por sua conta e risco — os autores e mantenedores não assumem nenhuma responsabilidade por quaisquer danos, problemas legais ou violações de garantia resultantes do uso, modificação ou distribuição deste código.
Qualquer uso indevido ou violação legal é de responsabilidade exclusiva do usuário.

---

Autores

Mantenedor Ativo: Vinyzu
Co-Mantenedor: Kaliiiiiiiiii