0Pricing
TypeScript Academy · درس

اختبار الأنواع باستخدام expectTypeOf وtsd

تحققوا من صحة الأنواع إلى جانب سلوك وقت التشغيل

اختبار الأنواع باستخدام expectTypeOf وtsd درس مجاني في TypeScript Academy على CoddyKit. هذا هو الدرس 4 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في TypeScript Academy، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة TypeScript Academy 4 دروس في المجموع.

مرحبًا

يضمن اختبار الأنواع نفسها — وليس سلوك وقت التشغيل فقط — عمل أدوات TypeScript وأنواعها العامة بشكل صحيح.

لماذا نختبر الأنواع؟

قد تحتوي الأدوات العامة والأنواع الشرطية على أخطاء لا تؤثر إلا في بعض معاملات الأنواع. وتكشف اختبارات الأنواع هذه الأخطاء.

expectTypeOf من Vitest

يوفّر Vitest الدالة expectTypeOf لإجراء تأكيدات الأنواع أثناء الترجمة.
import { expectTypeOf } from 'vitest';
expectTypeOf(42).toBeNumber();
expectTypeOf('hello').toBeString();

التأكيد على الأنواع المُعادة

أكّد على النوع الذي تُعيده الدالة.
import { identity } from '../src/utils';
expectTypeOf(identity(42)).toEqualTypeOf<number>();
expectTypeOf(identity('hi')).toEqualTypeOf<string>();

مكتبة tsd

tsd هي أداة CLI لاختبار الأنواع في ملفات تصريحات TypeScript.
npm install --save-dev tsd

تأكيدات tsd

اكتب ملفات .test-d.ts باستخدام تأكيدات tsd.
import { expectType, expectError } from 'tsd';
import { add } from '../src';
expectType<number>(add(1, 2));
expectError(add('a', 'b'));

مكتبة expect-type

توفّر مكتبة expect-type تأكيدات للأنواع متوافقة مع Jest.
import { expectTypeOf } from 'expect-type';
expectTypeOf<User>().toHaveProperty('name').toBeString();

اختبار الأنواع الشرطية

تحقق من أن الأنواع الشرطية تنتج المخرجات الصحيحة لمُدخلات متنوعة.
type IsArray<T> = T extends any[] ? true : false;
expectTypeOf<IsArray<string[]>>().toEqualTypeOf<true>();
expectTypeOf<IsArray<string>>().toEqualTypeOf<false>();

اختبار الأنواع المُحوّلة

تأكد من أن أدوات الأنواع المُحوّلة تنتج البنى الصحيحة.
type Mutable = { -readonly [K in keyof ReadonlyUser]: ReadonlyUser[K] };
expectTypeOf<Mutable['name']>().toBeString();
expectTypeOf<Mutable>().not.toMatchTypeOf<Readonly<Mutable>>();

تشغيل tsd في CI

أضف tsd إلى مسار CI لديك لاكتشاف تراجعات الأنواع.
// package.json
{ "scripts": { "test:types": "tsd" } }

اختبارات الأنواع مقابل اختبارات وقت التشغيل

تُشغّل اختبارات الأنواع أثناء الترجمة، من دون تكلفة وقت تشغيل. وتتحقق اختبارات وقت التشغيل من السلوك. وكلاهما ضروري.

تحقق سريع

ماذا يتحقق `expectTypeOf(add(1, 2)).toEqualTypeOf()` منه؟

مراجعة

اختبار الأنواع باستخدام expectTypeOf وtsd: أتقنت المفاهيم والأنماط الأساسية.

الأسئلة الشائعة

هل درس «اختبار الأنواع باستخدام expectTypeOf وtsd» مجاني؟

نعم — نص درس «اختبار الأنواع باستخدام expectTypeOf وtsd» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة TypeScript Academy، انتقل إلى CoddyKit PRO. تتضمن دورة TypeScript Academy 4 دروس في المجموع.

ماذا ستتعلم في «اختبار الأنواع باستخدام expectTypeOf وtsd»؟

تحققوا من صحة الأنواع إلى جانب سلوك وقت التشغيل تتمرن على TypeScript Academy مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.

هل أحتاج إلى خبرة سابقة لأبدأ TypeScript Academy؟

لا تُشترط خبرة سابقة. TypeScript Academy على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 4 من أصل 4.

كم من الوقت يستغرق درس «اختبار الأنواع باستخدام expectTypeOf وtsd»؟

معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.

هل يمكنني كتابة وتشغيل أكواد في درس TypeScript Academy هذا؟

نعم. كل درس في TypeScript Academy يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.

جميع الدروس في هذه الدورة

  1. إعداد Jest لـ TypeScript باستخدام ts-jest
  2. كتابة اختبارات وحدات آمنة من ناحية الأنواع
  3. محاكاة الوحدات والدوال في TypeScript
  4. اختبار الأنواع باستخدام expectTypeOf وtsd
← العودة إلى TypeScript Academy