🎭 Patchright

Patchright es una versión parcheada y no detectada del marco de pruebas y automatización Playwright.
Se puede usar como un reemplazo directo de Playwright.

[!NOTE]
Este repositorio sirve el controlador Patchright. Para usar Patchright, consulta el Paquete Python, el Paquete NodeJS o el paquete impulsado por la comunidad .Net Package

[!IMPORTANT]
Patchright solo parchea navegadores basados en CHROMIUM. Firefox y Webkit no son compatibles.

---

Patrocinadores

^{¿Quieres patrocinar este proyecto? Contacta @vinyzu en Discord!}

Swiftproxy: Proxies Residenciales de Alto Rendimiento para Recolección de Datos Escalable

Construido para desarrolladores que necesitan infraestructura de proxies confiable y antidetección. Swiftproxy ofrece conexiones estables, altas tasas de éxito y control flexible para scraping y automatización a gran escala.

• 🌍 Más de 195 ubicaciones con IPs residenciales de origen ético
• 🔄 Sesiones rotativas y sticky con geolocalización precisa
• ⚡ Optimizado para antiban y alta tasa de éxito
• 🔌 Soporte HTTP / HTTPS / SOCKS5
• 🧪 Prueba gratuita de 500MB para testear
• 💸 Código de descuento especial para usuarios de Patchright: PROXY90 - 10%

^{Mejor para: Web scraping, automatización, multi-cuentas y extracción de datos a gran escala}

---

---

Parches

Fuga de Runtime.enable

Este es el parche más grande que utiliza Patchright. Para evitar la detección por esta fuga, Patchright evita usar Runtime.enable ejecutando JavaScript en ExecutionContexts (aislados).

Fuga de Console.enable

Patchright parchea esta fuga deshabilitando la API de Console por completo. Esto significa que la funcionalidad de la consola no funcionará en Patchright. Si realmente necesitas la consola, quizás sea mejor que utilices registradores de JavaScript, aunque también pueden ser detectados fácilmente.

Fugas de Banderas de Comandos

Patchright ajusta los Argumentos Predeterminados de Playwright para evitar la detección por Fugas de Banderas de Comandos. Esto (principalmente) afecta a:

• --disable-blink-features=AutomationControlled (añadido) para evitar la detección de navigator.webdriver.
• --enable-automation (eliminado) para evitar la detección de navigator.webdriver.
• --disable-popup-blocking (eliminado) para evitar el bloqueo de ventanas emergentes.
• --disable-component-update (eliminado) para evitar ser detectado como un Stealth Driver.
• --disable-default-apps (eliminado) para habilitar las aplicaciones predeterminadas.
• --disable-extensions (eliminado) para habilitar las extensiones.

Fugas Generales

Patchright parchea algunas fugas generales en el código base de Playwright. Esto incluye principalmente configuraciones deficientes y puntos de detección obvios.

Sombras Cerradas

Patchright puede interactuar con elementos en Shadow Roots cerradas. Simplemente usa localizadores normales y Patchright hará el resto.
Patchright ahora también puede usar XPaths en Shadow Roots cerradas.

---

Sigilo

Con la configuración adecuada, Patchright actualmente se considera indetectable. Patchright pasa:

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

---

Errores

Aunque hemos dedicado mucho tiempo para hacer Patchright lo más estable posible, aún pueden ocurrir errores. Si encuentras algún error, repórtalo en Issues.

Patchright ahora se prueba con las pruebas de Playwright después de cada lanzamiento. Ver aquí

[!WARNING]
Patchright pasa la mayoría, pero no todas las pruebas de Playwright. Algunos errores se consideran imposibles de resolver, otros simplemente no son relevantes. Consulta la lista de errores y su explicación aquí.

Basándonos en las pruebas de Playwright, concluimos que es muy poco probable que estos errores te afecten en casos de uso normales.

Artimañas de Scripts de Inicio

Explicación

Para poder usar Scripts de Inicio sin Runtime.enable, Patchright utiliza Rutas de Playwright para inyectar JavaScript en las solicitudes HTML.

Errores

Las Rutas de Playwright pueden causar algunos errores en otras partes de tu código. Los Scripts de Inicio de Patchright no causarán errores que no causarían las Rutas normales de Playwright.
Si deseas que alguno de estos errores se solucione, tendrás que contactar al equipo de Playwright.

Fugas

Los Scripts de Inicio de Patchright pueden ser detectados mediante Ataques de Tiempo. Sin embargo, ningún antibot actualmente verifica este tipo de Ataque de Tiempo y probablemente no lo harán durante un buen tiempo.
Consideramos que no representan un gran riesgo de detección.

---

PENDIENTE

• Implementar opción para elegir Contexto de Ejecución (Principal/Aislado).
• Arreglar errores solucionables (Fix Fixable Bugs).
• Implementar actualizador .patch para mostrar fácilmente los parches de Patchright.
• Configurar pruebas automatizadas en cada nuevo lanzamiento.
• Implementar Patchright en .NET.
• Implementar Patchright en Java.

---

Desarrollo

El despliegue de nuevas versiones de Patchright es automático, pero pueden ocurrir errores debido a cambios en la base de código de Playwright. Las correcciones de estos errores pueden tardar unos días en publicarse.

---

Apoya nuestro trabajo

Si decides apoyar nuestro trabajo, por favor contacta a @vinyzu o @steve_abcdef en Discord.

---

Copyright y Licencia

© Vinyzu

Patchright está licenciado bajo Apache 2.0

Algunas partes del código están inspiradas en Driverless. Gracias a Nick Webson por la idea de la documentación en archivos .patch.

---

Descargo de responsabilidad

Este repositorio se proporciona únicamente con fines educativos.
No se ofrecen garantías sobre la precisión, integridad o idoneidad para ningún propósito. Úsalo bajo tu propio riesgo: los autores y mantenedores no asumen ninguna responsabilidad por daños, problemas legales o incumplimientos de garantía derivados del uso, modificación o distribución de este código.
Cualquier mal uso o violación legal es responsabilidad exclusiva del usuario.

---

Autores

Mantenedor activo: Vinyzu
Co-mantenedor: Kaliiiiiiiiii