0Pricing
TypeScript Academy · درس

صياغة وحدات ES: ‏import وexport

استخدموا التصديرات المُسمّاة والافتراضية في ملفات TypeScript

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

مرحبًا

يدعم TypeScript صياغة وحدات ES لتنظيم الشيفرة في ملفات منفصلة. يغطي هذا الدرس عمليات التصدير المسماة والتصدير الافتراضي والاستيراد.

التصديرات المسماة

استخدم `export` لجعل تصريح ما متاحًا للملفات الأخرى.
// math.ts
export function add(a: number, b: number): number { return a + b; }
export const PI = 3.14159;
export interface Config { host: string; }

الاستيرادات المسماة

استورد التصديرات المسماة المحددة باستخدام الأقواس المعقوفة.
// app.ts
import { add, PI } from './math';
console.log(add(1, 2)); // 3
console.log(PI);        // 3.14159

التصديرات الافتراضية

يمكن أن تحتوي الوحدة على تصدير افتراضي واحد. استورده دون أقواس معقوفة وبأي اسم.
// greeter.ts
export default function greet(name: string): string {
  return 'Hello, ' + name;
}

// app.ts
import greet from './greeter';
console.log(greet('Alice'));

الأسماء المستعارة للاستيراد

استخدم `as` لإعادة تسمية استيراد وتجنب تعارضات الأسماء.
import { log as consoleLog } from './logger';
import { User as UserModel } from './models';

استيرادات مساحة الأسماء

استورد جميع التصديرات في كائن مساحة أسماء.
import * as math from './math';
console.log(math.add(1, 2));
console.log(math.PI);

إعادة التصدير

أعد التصدير من وحدة أخرى لإنشاء واجهة API عامة.
// index.ts
export { add, PI } from './math';
export { greet } from './greeter';
export * from './utils';

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

صدّر الأنواع دون تضمين شيفرة وقت التشغيل باستخدام `export type`.
// types.ts
export type { User, Product };
export type UserId = string;

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

يضمن `import type` عدم تضمين شيفرة وقت التشغيل الخاصة بالاستيراد. ويفيد ذلك عند استيراد الواجهات والأسماء المستعارة للأنواع.
import type { User } from './models';
// Only the type is imported — no JavaScript
function greet(user: User): string { return user.name; }

حل الوحدات

يحل TypeScript الاستيرادات استنادًا إلى إعداد `moduleResolution` في tsconfig. ويُوصى باستخدام `bundler` أو `node16` في المشاريع الحديثة.

استيراد JSON

فعّل `resolveJsonModule: true` في tsconfig لاستيراد ملفات JSON مع استنتاج النوع.
// tsconfig.json: "resolveJsonModule": true
import config from './config.json';
console.log(config.host); // typed based on JSON structure

فحص سريع

ما صياغة الاستيراد التي تضمن ألا ينتج الاستيراد أي مخرجات JavaScript، أي يكون خاصًا بالنوع فقط؟

مراجعة

استخدم التصديرات والاستيرادات المسماة للعناصر المتعددة، والتصديرات الافتراضية للعنصر الرئيسي في الوحدة، وimport type للأنواع. تنشئ إعادة التصديرات في index.ts واجهات API عامة ومنظمة.

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

هل درس «صياغة وحدات ES: ‏import وexport» مجاني؟

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

ماذا ستتعلم في «صياغة وحدات ES: ‏import وexport»؟

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

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

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

كم من الوقت يستغرق درس «صياغة وحدات ES: ‏import وexport»؟

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

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

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

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

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