🎭 Patchright

Patchright هي نسخة معدلة (Patched) وغير مكتشفة (Undetected) من إطار عمل Playwright للاختبار والأتمتة.
يمكن استخدامها كبديل مباشر لـ Playwright.

[!NOTE]
هذا المستودع يخدم مشغل Patchright (Driver). لاستخدام Patchright، اطّلع على حزمة Python، حزمة NodeJS أو حزمة .Net التي يديرها المجتمع.

[!IMPORTANT]
Patchright يقوم بتعديل (Patch) فقط المتصفحات المبنية على Chromium. لا يدعم Firefox و Webkit.

---

الرعاة

^{هل ترغب في رعاية هذا المشروع؟ تواصل مع @vinyzu على Discord!}

Swiftproxy: بروكسيات سكنية عالية الأداء لجمع البيانات القابلة للتوسع

مبني للمطورين الذين يحتاجون إلى بنية تحتية للبروكسي موثوقة ومضادة للاكتشاف. Swiftproxy يوفر اتصالات مستقرة، معدلات نجاح عالية، وتحكمًا مرنًا لـ التجميع والأتمتة على نطاق واسع.

• 🌍 أكثر من 195 موقعًا مع عناوين IP سكنية من مصادر أخلاقية
• 🔄 جلسات دوارة و ثابتة مع استهداف جغرافي دقيق
• ⚡ محسّن لمكافحة الحظر ونسبة نجاح عالية
• 🔌 دعم HTTP / HTTPS / SOCKS5
• 🧪 إصدار تجريبي مجاني 500 ميجابايت للاختبار
• 💸 رمز خصم خاص لمستخدمي Patchright: PROXY90 - 10%

^{الأفضل لـ: تجميع الويب، الأتمتة، إدارة الحسابات المتعددة، واستخراج البيانات على نطاق واسع}

---

يوفر شبكة بروكسي مستقرة وعالية الأداء مبنية لعمليات البيانات واسعة النطاق.

---

التصحيحات (Patches)

تسرب Runtime.enable

هذا هو أكبر تصحيح يستخدمه Patchright. لتجنب الكشف عن طريق هذا التسرب، يتجنب Patchright استخدام Runtime.enable عن طريق تنفيذ JavaScript في سياقات تنفيذ (ExecutionContexts) (معزولة).

تسرب Console.enable

يقوم Patchright بتصحيح هذا التسرب عن طريق تعطيل واجهة برمجة تطبيقات Console بالكامل. هذا يعني أن وظائف الكونسول لن تعمل في Patchright. إذا كنت حقاً بحاجة إلى الكونسول، قد يكون من الأفضل استخدام مسجلات JavaScript، على الرغم من أنه يمكن اكتشافها بسهولة أيضاً.

تسرب أعلام الأوامر (Command Flags Leaks)

يقوم Patchright بتعديل الوسائط الافتراضية لـ Playwright لتجنب الكشف عن طريق تسرب أعلام الأوامر. هذا يؤثر (الأهم) على:

• --disable-blink-features=AutomationControlled (تمت الإضافة) لتجنب اكتشاف navigator.webdriver.
• --enable-automation (تمت الإزالة) لتجنب اكتشاف navigator.webdriver.
• --disable-popup-blocking (تمت الإزالة) لتجنب تعطل النوافذ المنبثقة.
• --disable-component-update (تمت الإزالة) لتجنب الكشف كمشغل متخفي (Stealth Driver).
• --disable-default-apps (تمت الإزالة) لتمكين التطبيقات الافتراضية.
• --disable-extensions (تمت الإزالة) لتمكين الإضافات

تسربات عامة

يقوم Patchright بتصحيح بعض التسربات العامة في قاعدة كود Playwright. يشمل ذلك بشكل أساسي الإعدادات الضعيفة ونقاط الكشف الواضحة.

الظلال المغلقة (Closed Shadow Roots)

يستطيع Patchright التفاعل مع العناصر داخل الظلال المغلقة (Closed Shadow Roots). ما عليك سوى استخدام المعرفات العادية (locators) وسيتولى Patchright الباقي.
أصبح Patchright الآن قادراً أيضاً على استخدام XPaths في الظلال المغلقة.

---

التخفي (Stealth)

مع الإعداد الصحيح، يعتبر Patchright حالياً غير قابل للاكتشاف. يجتاز Patchright:

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

---

الأخطاء

على الرغم من أننا أمضينا الكثير من الوقت لجعل Patchright بأقصى قدر من الاستقرار، إلا أن الأخطاء قد تظهر. إذا واجهت أي أخطاء، يرجى الإبلاغ عنها في المشكلات (Issues).

يتم الآن اختبار Patchright مقابل اختبارات Playwright بعد كل إصدار. انظر هنا

[!WARNING]
يجتاز Patchright معظم اختبارات Playwright، ولكن ليس كلها. بعض الأخطاء تعتبر من المستحيل حلها، والبعض الآخر غير مهم. انظر قائمة الأخطاء وشرحها هنا.

بناءً على اختبارات Playwright، استنتجنا أنه من غير المرجح أن تتأثر بهذه الأخطاء في حالات الاستخدام العادية.

مشاكل النصوص التهيئية (Init Script Shenanigans)

شرح

لتتمكن من استخدام النصوص التهيئية (InitScripts) دون Runtime.enable، يستخدم Patchright مسارات Playwright (Routes) لحقن JavaScript في طلبات HTML.

أخطاء

قد تسبب مسارات Playwright بعض الأخطاء في أجزاء أخرى من الكود الخاص بك. لن تسبب النصوص التهيئية لـ Patchright أي أخطاء لا تسببها مسارات Playwright العادية.
إذا كنت ترغب في إصلاح أي من هذه الأخطاء، ستحتاج إلى الاتصال بفريق Playwright.

تسربات

يمكن اكتشاف النصوص التهيئية لـ Patchright عن طريق هجمات التوقيت (Timing Attacks). ومع ذلك، لا يفحص أي نظام حالي لمكافحة البوتات هذا النوع من هجوم التوقيت، ومن المحتمل ألا يفعل ذلك لفترة طويلة.
نحن نعتبرها ليست خطراً كبيراً للاكتشاف.

---

المهام المتبقية (TODO)

• تنفيذ خيار اختيار سياق التنفيذ (الرئيسي/المعزول).
• إصلاح الأخطاء القابلة للإصلاح.
• تنفيذ مُحدّث .patch لعرض تصحيحات Patchright بسهولة.
• إعداد اختبارات آلية عند الإصدار الجديد.
• تنفيذ Patchright على .NET.
• تنفيذ Patchright على Java.

---

التطوير

نشر إصدارات Patchright الجديدة يتم تلقائياً، ولكن قد تحدث أخطاء بسبب التغييرات في قاعدة كود Playwright. قد يستغرق إصلاح هذه الأخطاء بضعة أيام ليتم إصدارها.

---

ادعم عملنا

إذا اخترت دعم عملنا، يرجى الاتصال بـ @vinyzu أو @steve_abcdef على Discord.

---

حقوق النشر والترخيص

© Vinyzu

Patchright مرخصة بموجب Apache 2.0

بعض الأجزاء من قاعدة الكود مستوحاة من Driverless. شكر لـ Nick Webson على فكرة توثيق ملفات .patch.

---

إخلاء المسؤولية

هذا المستودع مقدم لأغراض تعليمية فقط.
لا يتم تقديم أي ضمانات فيما يتعلق بالدقة أو الاكتمال أو الملاءمة لأي غرض. استخدمه على مسؤوليتك الخاصة—المؤلفون والمشرفون لا يتحملون أي مسؤولية عن أي أضرار، مشكلات قانونية، أو انتهاكات الضمان الناتجة عن استخدام أو تعديل أو توزيع هذا الكود.
أي استخدام خاطئ أو انتهاكات قانونية هي المسؤولية الوحيدة للمستخدم.

---

المؤلفون

المشرف النشط: Vinyzu
المشرف المشارك: Kaliiiiiiiiii