drift-node-sdk

تمكّن حزمة Tusk Drift SDK الخاصة بـ Node.js من إجراء اختبارات API سريعة وحتمية من خلال التقاط وإعادة تشغيل استدعاءات API الواردة/الصادرة من خدمتك. سجّل استدعاءات API الحقيقية تلقائيًا، ثم أعد تشغيلها كاختبارات باستخدام Tusk CLI لاكتشاف الانحدارات. أثناء إعادة التشغيل، يتم اعتراض جميع الطلبات الصادرة باستخدام البيانات المسجّلة لضمان سلوك متسق دون آثار جانبية.

التوثيق

للحصول على أدلة شاملة ومرجع API، تفضل بزيارة التوثيق الكامل.

أدلة SDK

• دليل التهيئة - إعداد الحزمة في تطبيق Node.js الخاص بك
• متغيرات البيئة - مرجع متغيرات البيئة
• دليل البدء السريع - سجّل وأعد تشغيل أول تتبّع (trace) لك
• دليل استكشاف الأخطاء وإصلاحها - المشكلات الشائعة والحلول

المتطلبات

يدعم Tusk Drift حاليًا الحزم والإصدارات التالية:

• HTTP/HTTPS: جميع الإصدارات (مدمجة في Node.js)
• GRPC: @grpc/[email protected] (الطلبات الصادرة فقط)
• PG: [email protected], [email protected]
• Firestore: @google-cloud/[email protected]
• Postgres: [email protected]
• MySQL: [email protected], [email protected]
• MongoDB: [email protected]
• Redis: [email protected] (@redis/[email protected],5.x)
• IORedis: [email protected]
• Upstash Redis: @upstash/[email protected]

إذا كنت تستخدم حزمًا أو إصدارات غير مذكورة أعلاه، فيرجى إنشاء issue مع ذكر الحزمة + الإصدار الذي ترغب في إضافة دعم تتبّع (instrumentation) له.

التثبيت

الخطوة 1: تثبيت CLI

أولاً، قم بتثبيت وتهيئة Tusk Drift CLI باتباع دليل تثبيت CLI. يساعدك CLI في إعداد ملف تكوين Tusk وإعادة تشغيل الاختبارات.

سيوجهك المعالج في النهاية إلى هنا عندما يحين وقت إعداد الحزمة.

الخطوة 2: تثبيت الحزمة

بعد إكمال معالج CLI، قم بتثبيت الحزمة:

npm install @use-tusk/drift-node-sdk

الخطوة 3: تهيئة الحزمة لخدمتك

راجع دليل التهيئة الخاص بنا لإعداد الحزمة لخدمتك.

الخطوة 4: تشغيل أول اختبار لك

اتبع دليل البدء السريع الخاص بنا لتسجيل وإعادة تشغيل أول اختبار لك!

استكشاف الأخطاء وإصلاحها

تواجه مشكلات؟

• اقرأ وثيقة استكشاف الأخطاء وإصلاحها
• أنشئ issue أو تواصل معنا على [email protected].

المجتمع

انضم إلى مجتمعنا مفتوح المصدر على Slack.

المساهمة

نقدّر ملاحظاتكم ومساهماتكم. راجع CONTRIBUTING.md.

الترخيص

هذا المشروع مرخّص بموجب رخصة Apache License 2.0 - راجع ملف LICENSE للتفاصيل.