التصريحات وخرائط المصدر وتصدير الأنواع
أنشئ ملفات التصريحات، وفعّل خرائط المصدر لتصحيح الأخطاء، وتعلّم استراتيجيات تصدير الأنواع.
التصريحات وخرائط المصدر وتصدير الأنواع درس مجاني في TypeScript Academy على CoddyKit. هذا هو الدرس 3 من أصل 3. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في TypeScript Academy، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة TypeScript Academy 3 دروس في المجموع.
مقدمة
الهدف: تعلّم كيفية إنتاج ملفات التصريحات، وتمكين خرائط المصدر، وتصدير الأنواع بوضوح.
التصريحات
فعّل declaration: true لإنشاء ملفات .d.ts إلى جانب مخرجات JS.
// tsconfig.json
{
"compilerOptions": {
"declaration": true,
"outDir": "dist"
}
}emitDeclarationOnly
استخدم emitDeclarationOnly لإنتاج تصريحات الأنواع فقط (من دون JS) للمكتبات.
// tsconfig.json
{
"compilerOptions": {
"emitDeclarationOnly": true,
"outDir": "types"
}
}خرائط المصدر
تتيح لك خرائط المصدر تصحيح أخطاء TS في المتصفحات أو Node، من خلال ربط JS مجددًا بكود TS.
// tsconfig.json
{
"compilerOptions": {
"sourceMap": true
}
}types في package.json
استخدم الحقل types أو typings في package.json للإشارة إلى ملفات التصريحات الأساسية.
// package.json
{
"types": "dist/index.d.ts"
}إعادة التصدير
أعد تصدير الأنواع لتوضيح واجهة API العامة. واجمع ذلك مع declaration لفائدة المستهلكين.
// src/index.ts
export type { User, Config } from "./models";
export { createClient } from "./client";سؤال
تحقق سريع: أي خيار في المترجم يفعّل إنشاء ملفات .d.ts؟
مراجعة
مراجعة: ينشئ declaration ملفات .d.ts، ويُخرج emitDeclarationOnly الأنواع فقط، وتساعد sourceMap في تصحيح الأخطاء، بينما تشكّل عمليات إعادة التصدير واجهة API العامة.
الأسئلة الشائعة
هل درس «التصريحات وخرائط المصدر وتصدير الأنواع» مجاني؟
نعم — نص درس «التصريحات وخرائط المصدر وتصدير الأنواع» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة TypeScript Academy، انتقل إلى CoddyKit PRO. تتضمن دورة TypeScript Academy 3 دروس في المجموع.
ماذا ستتعلم في «التصريحات وخرائط المصدر وتصدير الأنواع»؟
أنشئ ملفات التصريحات، وفعّل خرائط المصدر لتصحيح الأخطاء، وتعلّم استراتيجيات تصدير الأنواع. تتمرن على TypeScript Academy مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.
هل أحتاج إلى خبرة سابقة لأبدأ TypeScript Academy؟
لا تُشترط خبرة سابقة. TypeScript Academy على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 3 من أصل 3.
كم من الوقت يستغرق درس «التصريحات وخرائط المصدر وتصدير الأنواع»؟
معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.
هل يمكنني كتابة وتشغيل أكواد في درس TypeScript Academy هذا؟
نعم. كل درس في TypeScript Academy يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.
جميع الدروس في هذه الدورة
- إخراج tsc مقابل noEmit وأدوات التجميع
- أساسيات Vite و esbuild و SWC و Rollup
- التصريحات وخرائط المصدر وتصدير الأنواع