ثبّت أولاً Playwright CLI لوكيل الترميز ثم تحدّث عن سقالة الاختبار

لمن يناسب

هذه المهارة تناسب من يريد API واحدة لدفع Chromium وFirefox وWebKit. الرسمي يكتبها إطار أتمتة ويب واختبار، تُستخدم للاختبارات والسكربتات وأداة لوكلاء الترميز. تناسب أيضًا من يستخدم أصلًا وكلاء مثل Claude Code أو Copilot ويستعد لتثبيت سطر الأوامر الرسمي. هذان الاسمان من أمثلة النص الأصلي؛ لا تقرأهما كالأدوات المدعومة فقط.

لا تناسب من لم يوافق بعد على تثبيت حزمة عامًا ويريد توليد مشروع اختبار كامل دفعة. الرسمي لديه أيضًا npm init playwright@latest الذي يهيئ مشروع اختبار؛ لا تسلك ذلك المسار أول مرة. إن أردت فقط أن يستخدم الوكيل سطر الأوامر أولاً، فالمسار الرئيس هو التثبيت العام لـ @playwright/cli.

المستودع الرسمي هو https://github.com/microsoft/playwright اعمل بالأوامر المكتوبة أصلًا في تلك الصفحة.

إنهاء المحاولة الأولى في 3 دقائق

اسلك فقط مسار التثبيت هذا الذي تكتبه الصفحة الرسمية لوكلاء الترميز.

شرط مسبق: هذا الجهاز يستطيع تشغيل npm، وأنت توافق بوضوح على تثبيت عام واحد. أكّد أولاً: npm i -g @playwright/cli@latest يثبّت سطر الأوامر عامًا. إن لم ترد بعد تغيير الحزم العامة فلا تنفّذه. في هذه الخطوة لا تهيئ مشروع اختبار ولا تفتح موقعًا حقيقيًا.

موضع التثبيت: في أي طرفية أكّد الآثار أعلاه ثم نفّذ:

npm i -g @playwright/cli@latest

تحقق منخفض المخاطر: بعد التثبيت اجعل الوكيل أولاً يعيد صياغة استخدام هذا CLI من الشرح الرسمي فقط — هو مكتوب كسطر أوامر أتمتة متصفح لوكلاء الترميز، أوفر في token من MCP، والأوامر تتجنب تحميل مخططات أدوات كبيرة وأشجار إتاحة إلى سياق النموذج. لا تشغّل متصفحًا. لا ترسل طلبات إلى موقع خارجي. إن أردت لاحقًا تكامل وكيل أغنى، فالنص الأصلي لديه أيضًا playwright-cli install --skills؛ ذلك يكتب ملفات مهارة، فأكّد مرة أخرى قبل التنفيذ.

إشارة النجاح: انتهى التثبيت العام، ويستطيع الوكيل أن يشير إلى أن الأمر الرئيس هو @playwright/cli، ولم يحوّل إلى مثبّت لم يظهر. إن شغّل npm init playwright@latest مباشرة فالمسار خاطئ؛ توقف.

حالات الاستخدام

الحالة الأولى: ثبّت CLI الرسمي لوكيل ترميز. بجانب Claude Code وCopilot يكتب النص الأصلي npm i -g @playwright/cli@latest، ثم يمكن استخدام playwright-cli install --skills لتثبيت تكامل وكيل أغنى. يناسب من يريد سطر الأوامر أولاً ويقرر لاحقًا إن كان سيكتب ملفات مهارة. الأمر الثاني يغيّر دليل المهارات المحلي؛ أكّد قبل التنفيذ.

الحالة الثانية: أنشئ مشروع اختبار طرف إلى طرف جديد. الأمر الرسمي هو npm init playwright@latest. يناسب من قرر أصلًا أنه يريد سقالة اختبار ويوافق على إنشاء ملفات مشروع. التهيئة تكتب على القرص؛ لا تنفّذها وأنت تريد فقط تجربة سطر الأوامر. إن لم يكتب النص الأصلي مفتاح تنزيل متصفحات فلا تختلق معاملات.

حدود الاستخدام

المسار الرئيس هو npm i -g @playwright/cli@latest. لا تكتب مثبّتًا لم يظهر في المسار الرئيس. playwright-cli install --skills وnpm init playwright@latest أمران آخران في النص الأصلي بأغراض مختلفة؛ لا تدمجهما في واحد.

التغطية هي دفع Chromium وFirefox وWebKit بنفس API، للاختبارات والسكربتات ووكلاء الترميز. لا يثبت أنه يستطيع دفع محرك متصفح غير مسمّى. Claude Code وCopilot قائمة أمثلة فقط.

الصفحة الرسمية هي https://github.com/microsoft/playwright إن لم يكن أول أمر يقترحه الوكيل التثبيت العام لـ @playwright/cli، فتلك الصفحة هي المرجع. في المحاولة الأولى لا تؤتمت موقع إنتاج.