تجهيز Playwright MCP مع Claude Code

دليل مختصر لربط Playwright مع بروتوكول سياق النموذج بحيث يمكن لمساعدتك الذكي أن ينفذ اختبارات المتصفح.

المتطلبات الأساسية

• نودي.js 18 أو أحدث، وgit، ومدير مُعالج حديث.
• مساعد ذكي يدعم Claude Code أو بروتوكول سياق النموذج (MCP).
• المتصفحات مثبتة عن طريق تنفيذ الأمر npx playwright install.

بدء سريع

1. أنشئ مساحة عمل وقم بتركيب Playwright: npm init -y npm install -D @playwright/test npx playwright install
2. أضف مدخلًا لخادم MCP يشير إلى مسار مخزنك (انظر claude_code_config.json).
3. عرض أوامر آمنة مثل npx playwright test و node scripts/seed.js.

كتابة اختبار أولي

import { test, expect } from '@playwright/test';

test('يُحمّل الصفحة الرئيسية', async ({ page }) => {
  await page.goto('http://localhost:30-00');
  await expect(page.getByRole('heading', { name: /home/i })).toBeVisible();
});

قم بتشغيله باستخدام npx playwright test واحتفظ بملفات التصوير والمسارات للإشراف.

الممارسات المثلى

• اجعل إصدار نودي وPlaywright ثابتًا لتجنب التغير.
• أوامر بذل أقل سلطة: اجعل فقط ما يحتاجه المساعد.
• استخدم عنوان URL للتجريب وبيانات التمهيد؛ تجنب الوصول إلى حسابات الإنتاج.
• احتفظ بالبيانات السرية خارج التكوين أو اجعلها مُocked أثناء الاختبارات.

النتيجة: مع بروتوكول MCP، يمكن لمساعدتك الذكي أن يعرض الصفحات، ينفذ اختبارات، ويشارك الأدلة دون الحاجة إلى النقر اليدوي.