0Pricing
TypeScript Academy · درس

الاستيرادات والتصديرات الخاصة بالأنواع فقط

استخدموا import type لتجنّب التكلفة الإضافية وقت التشغيل

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

مرحبًا

قُدّمت الاستيرادات والتصديرات الخاصة بالأنواع فقط (import type / export type) في TypeScript 3.8 لمنح المطورين تحكمًا صريحًا فيما إذا كانت التبعية تبعية وقت تشغيل أو نوعًا فقط.

أهمية الأنواع فقط

قد تتضمن الاستيرادات العادية شيفرة وقت التشغيل. وإذا كنت تحتاج إلى النوع فقط، فيمكن حذف الاستيراد بالكامل من المخرجات المترجمة.
import { User } from './models'; // includes runtime binding
import type { User } from './models'; // compile-time only, erased

صياغة import type

ضع `type` بعد الكلمة المفتاحية `import`. ولا يمكنك استخدام الاسم المستورد كقيمة.
import type { ApiResponse } from './api-types';

function handleResponse(res: ApiResponse<User>): void {
  // ApiResponse used as type annotation only
}

صياغة export type

استخدم `export type` لتحديد التصديرات الخاصة بالأنواع فقط صراحةً.
// user.types.ts
export type UserId = string;
export type { User, UserRole };

استيراد نوع مضمن

يسمح TypeScript 4.5 والإصدارات الأحدث بتحديد الاستيرادات الفردية على أنها خاصة بالأنواع فقط ضمن عبارة استيراد عادية.
import { type User, createUser } from './user';
// User is type-only, createUser is a runtime value

حل التبعيات الدائرية

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

verbatimModuleSyntax

قدّم TypeScript 5.0 الخيار `verbatimModuleSyntax`. وعند تفعيله، يجب استخدام `import type` للاستيرادات الخاصة بالأنواع فقط لمنع حدوث التباس لدى أداة التجميع.
// tsconfig.json
{ "compilerOptions": { "verbatimModuleSyntax": true } }

importsNotUsedAsValues

يتحكم خيار المترجم `importsNotUsedAsValues`، الذي حلّ محله verbatimModuleSyntax، في كيفية تعامل TypeScript مع استيرادات القيم غير المستخدمة.

الفوائد في أدوات التجميع

تستخدم أدوات التجميع مثل Vite وesbuild علامات `import type` لتخطي معالجة استيرادات الأنواع، مما يحسن سرعة البناء.

إعادة التصدير الخاصة بالأنواع فقط

أعد تصدير الأنواع دون تضمين وحدتها الخاصة بوقت التشغيل.
// public-api.ts
export type { User, UserRole } from './internal-user';
export { createUser } from './internal-user'; // runtime

خطأ: لا يمكن استخدام import type كقيمة

يؤدي استخدام استيراد خاص بالأنواع فقط كقيمة وقت تشغيل إلى خطأ أثناء الترجمة.
import type { User } from './user';
// const u = new User(); // Error — User was imported as type-only

فحص سريع

متى ينبغي استخدام `import type` بدلًا من `import` عادي؟

مراجعة

استخدم `import type` و`export type` للاستيرادات والتصديرات الخاصة بالأنواع فقط. وتُحذف هذه العناصر أثناء الترجمة، وتمنع إنشاء تبعية وقت تشغيل على ملفات الأنواع، ويصبح استخدامها مطلوبًا عند تفعيل verbatimModuleSyntax.

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

هل درس «الاستيرادات والتصديرات الخاصة بالأنواع فقط» مجاني؟

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

ماذا ستتعلم في «الاستيرادات والتصديرات الخاصة بالأنواع فقط»؟

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

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

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

كم من الوقت يستغرق درس «الاستيرادات والتصديرات الخاصة بالأنواع فقط»؟

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

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

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

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

  1. صياغة وحدات ES: ‏import وexport
  2. إعادة التصدير وملفات Barrel
  3. الاستيرادات والتصديرات الخاصة بالأنواع فقط
  4. مساحات الأسماء أم الوحدات: الاستخدام الحديث
← العودة إلى TypeScript Academy