الاختبار وتصحيح الأخطاء

يساعدك Verdent for VS Code على كتابة اختبارات شاملة وتصحيح المشكلات من خلال دورات متعددة المراحل من التوليد والتشغيل والإصلاح، وتحليل الأخطاء، وتحسينات تلقائية لتغطية الاختبار. يمكنه توليد اختبارات وحدة واختبارات تكامل واختبارات شاملة من طرف إلى طرف تتوافق مع إطار وأسلوب الاختبار المستخدم في مشروعك.

ما ستتعلمه

• توليد اختبارات وحدة تغطي الحالات الحدية والسلوك المتوقع
• العمل مع جميع أطر الاختبار الرئيسية (Jest وPytest وJUnit وغيرها)
• إنشاء اختبارات تكامل تتحقق من سير عمل يشمل عدة مكونات
• تحسين تغطية الاختبار عبر تحديد واختبار مسارات الكود غير المغطاة
• تصحيح المشكلات باستخدام تحليل رسائل الأخطاء وتتبع التنفيذ
• تشخيص الأخطاء من تتبعات المكدس وسجلات الأخطاء والسلوك غير المتوقع

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

قبل الاختبار وتصحيح الأخطاء باستخدام Verdent:

• Visual Studio Code مع تثبيت إضافة Verdent
• قاعدة كود أو مساحة عمل مفتوحة في VS Code
• خطة اشتراك فعّالة في Verdent مع أرصدة متاحة
• إطار اختبار مهيأ في مشروعك (اختياري لتوليد الاختبارات)

كتابة اختبارات الوحدة

يولّد Verdent اختبارات وحدة تتوافق مع إطار وأسلوب الاختبار المستخدم في مشروعك. فهو يحلل الاختبارات الحالية لفهم أنماطك، ثم يولّد اختبارات مع الإعداد والتأكيدات والمحاكاة المناسبة.

مثال:

Write unit tests for the calculateDiscount function

سيقوم Verdent بما يلي:

• فحص تنفيذ الدالة calculateDiscount
• تحديد معاملات الإدخال وقيم الإرجاع
• تحليل الاختبارات الحالية لمطابقة قواعدك (بنية الاختبار، أسلوب التأكيدات، أنماط التسمية)
• توليد اختبارات تغطي:
  • المسار السليم: مدخلات صالحة مع مخرجات متوقعة
  • الحالات الحدية: القيم الحدية، الصفر، الأرقام السالبة، القيم القصوى
  • المدخلات غير الصالحة: null، undefined، أنواع خاطئة
  • السلوك المتوقع: التحقق من منطق العمل

بنية الاختبار المولّدة:

ينشئ Verdent اختبارات تتبع أنماط مشروعك:

• تنظيم مجموعة الاختبارات: كتل describe، فئات الاختبار، أو بنية الوحدات
• الإعداد والتنظيف: خطافات before/after مطابقة لاختباراتك الحالية
• التأكيدات: باستخدام مكتبة التأكيد الخاصة بمشروعك (expect وassert وshould وغيرها)
• المحاكاة: مطابقة أنماط المحاكاة لديك (jest.mock وsinon وunittest.mock)
• قواعد التسمية: أسماء اختبارات تتبع أسلوبك المعتمد

دورات التوليد والتشغيل والإصلاح متعددة المراحل:

من أجل اختبار شامل، يستخدم Verdent دورات متعددة المراحل:

1. التوليد: إنشاء مجموعة اختبارات أولية
2. التشغيل: تنفيذ الاختبارات للتحقق من عملها
3. الإصلاح: إصلاح الاختبارات الفاشلة أو تحسين التغطية
4. التكرار: التكرار حتى تنجح الاختبارات وتصبح التغطية كافية

يضمن هذا أن الاختبارات لا تُكتب فقط، بل تعمل فعلًا بشكل صحيح مع قاعدة الكود لديك.

أطر الاختبار المدعومة

يدعم Verdent جميع أطر الاختبار الرئيسية عبر لغات برمجة ومجموعات تقنية مختلفة دون الحاجة إلى إعدادات إضافية.

test('sum returns correct result', () => {
  expect(sum(2, 3)).toBe(5);
});

const assert = require('assert');

describe('sum', () => {
  it('returns correct result', () => {
    assert.strictEqual(sum(2, 3), 5);
  });
});

import { describe, it, expect } from 'vitest';

it('sum returns correct result', () => {
  expect(sum(2, 3)).toBe(5);
});

describe('sum', () => {
  it('returns correct result', () => {
    expect(sum(2, 3)).toEqual(5);
  });
});

يتعرف Verdent على إطار الاختبار الخاص بك من إعدادات مشروعك واختباراتك الحالية، ويولّد تلقائيًا اختبارات تتوافق مع إعدادك.

توليد اختبارات التكامل

يولّد Verdent اختبارات تكامل تتحقق من كيفية عمل عدة مكونات أو خدمات أو وحدات معًا. فهو ينشئ اختبارات تحاكي سير العمل الحقيقي بما في ذلك تفاعلات API، وعمليات قاعدة البيانات، وتدفقات المصادقة، ورحلات المستخدم متعددة الخطوات.

مثال:

Write integration tests for the user registration flow

يولّد Verdent اختبارات تتحقق من التدفق الكامل:

1. إرسال النموذج: يرسل المستخدم نموذج التسجيل ببيانات صالحة
2. التحقق: يتحقق الخادم من تنسيق البريد الإلكتروني، وقوة كلمة المرور، واكتمال البيانات
3. الإدراج في قاعدة البيانات: يُنشأ سجل المستخدم في قاعدة البيانات
4. إرسال البريد الإلكتروني: يُرسل بريد التأكيد (محاكى أو فعلي)
5. تسجيل الدخول الناجح: يمكن للمستخدم الجديد تسجيل الدخول فورًا ببيانات اعتماده

بنية اختبار التكامل:

ينشئ Verdent اختبارات تكامل تتضمن:

• إعداد الاختبار: تزويد قاعدة البيانات بالبيانات، وتهيئة الخدمات، وإنشاء بيانات اختبار
• محاكاة سير العمل: عمليات متعددة الخطوات بالتسلسل
• التحقق من الحالة: فحص حالة قاعدة البيانات، واستجابات API، والآثار الجانبية
• محاكاة الخدمات الخارجية: خدمات البريد الإلكتروني، بوابات الدفع API، والتكاملات مع أطراف ثالثة
• تنظيف بعد الاختبار: تنظيف بيانات الاختبار، التراجع عن قاعدة البيانات، إيقاف الخدمات

أمثلة على سيناريوهات الاختبار:

Write integration tests for the checkout and payment process

يختبر Verdent:

• إضافة عناصر إلى سلة التسوق
• تطبيق رموز الخصم
• حساب الإجماليات مع الضريبة والشحن
• معالجة الدفع (مع بوابة دفع محاكاة)
• إنشاء سجل طلب في قاعدة البيانات
• إرسال بريد تأكيد
• تحديث المخزون

عزل الاختبارات:

يضمن Verdent عزل اختبارات التكامل بشكل صحيح:

• تبدأ كل اختبار بحالة قاعدة بيانات نظيفة
• تُحاكى استدعاءات الخدمات الخارجية لمنع الآثار الجانبية
• يمكن تشغيل الاختبارات بأي ترتيب دون اعتماديات
• يحدث التنظيف حتى في حال فشل الاختبارات

تحسين تغطية الاختبار

يحلل Verdent قاعدة الكود لديك لتحديد الدوال والفروع والحالات الحدية غير المختبرة، ثم يولّد اختبارات لتحسين التغطية. فهو يفحص مجموعة اختباراتك الحالية ويحدد الثغرات حيث لا تُختبر مسارات الكود.

مثال:

Analyze test coverage and write tests for uncovered code paths in the payment module

سيقوم Verdent بما يلي:

1. تحليل الاختبارات الحالية: فحص ما يُختبر حاليًا
2. تحديد ثغرات التغطية: العثور على دوال محددة، وفروع شرطية، ومسارات معالجة الأخطاء، وحالات حدية تفتقر إلى اختبارات
3. توليد الاختبارات الناقصة: إنشاء اختبارات تستهدف الكود غير المغطى
4. التحقق من تحسّن التغطية: تشغيل الاختبارات للتأكد من زيادة التغطية

ما يحدده Verdent:

• الدوال غير المختبرة: دوال بلا أي تغطية اختبارية على الإطلاق
• الفروع الشرطية: عبارات if/else حيث لا يُختبر أحد الفرعين
• مسارات معالجة الأخطاء: كتل try/catch أو ردود نداء الأخطاء دون اختبارات فشل
• الحالات الحدية: القيم الحدية، معالجة null/undefined، وتحويل الأنواع
• نقاط التكامل: استدعاءات API، وعمليات قاعدة البيانات، وتفاعلات الخدمات الخارجية

مثال على تحسين التغطية:

Improve test coverage for the UserService class

يحدد Verdent:

• لدى getUserById اختبارات للمعرّفات الصالحة لكن ليس للمعرّفات غير الصالحة
• updateUser ينقصها اختبارات لفشل التحقق
• deleteUser ينقصها اختبارات لفحوصات التفويض
• مسارات معالجة الأخطاء في createUser غير مختبرة

ثم يولّد اختبارات تستهدف هذه الثغرات تحديدًا، مما يرفع التغطية من 65% إلى 95%.

مقاييس التغطية:

يساعدك Verdent على الوصول إلى نسب تغطية أعلى واكتشاف أخطاء محتملة في الكود غير المختبر سابقًا:

• تغطية الأسطر: نسبة أسطر الكود التي نفّذتها الاختبارات
• تغطية الفروع: نسبة الفروع الشرطية التي جرى اختبارها
• تغطية الدوال: نسبة الدوال التي لديها اختبار واحد على الأقل
• تغطية العبارات: نسبة العبارات التي نُفّذت

التصحيح باستخدام Verdent

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

This function returns undefined instead of the user object. Debug it.

The login form redirects to the home page even when credentials are invalid

The product search is slow when the database has 10,000+ products

Why does this API endpoint return a 500 error when the email parameter is missing?

التشخيص من رسائل الأخطاء والسجلات

الصق رسائل الأخطاء أو تتبعات المكدس أو ملفات السجل مباشرة في المحادثة. يحلل Verdent الخطأ، ويحدد ملف المصدر ورقم السطر، ويشرح السبب، ويقترح إصلاحًا.

TypeError: Cannot read property 'name' of undefined
    at UserProfile.render (UserProfile.jsx:45)
    at processComponent (react-dom.js:2103)

I'm getting this error: [paste stack trace]

Analyze these logs and tell me why the API requests are failing:
[paste 50 lines of log output]

The shopping cart total is sometimes incorrect. Here are the error logs: [paste logs]

أفضل الممارسات

طالع أيضًا