.d.ts الأساسية؛ export type مقابل export
تعلّم أساسيات ملفات التصريحات: التصريحات المحيطة مقابل تصريحات الوحدات، و export type مقابل export، وضمان تجربة مطوّر صحيحة للمستهلكين.
.d.ts الأساسية؛ export type مقابل export درس مجاني في TypeScript Academy على CoddyKit. هذا هو الدرس 1 من أصل 2. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في TypeScript Academy، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة TypeScript Academy 2 دروس في المجموع.
مقدمة
الهدف: كتابة ملفات .d.ts مفيدة. ستتعلّم الفرق بين التعريفات المحيطة وتعريفات الوحدات، وكيفية تعريف الصادرات، ومتى تستخدم export type مقابل export.
- سياق محيط مقابل سياق الوحدة
- صادرات للأنواع فقط مقابل صادرات للقيم
- أفضل الممارسات
التعريفات المحيطة
استخدم declare global لتوسيع النطاق العام. أضف export {} لوضع علامة على الملف بوصفه وحدة وتجنب التعارضات.
// globals.d.ts
// Ambient declaration: no import/export, augments global scope
declare global {
interface Window {
APP_VERSION: string
}
}
export {} // ensures this file is a moduleتعريفات الوحدات
يصف declare module بنية حزمة خارجية. استخدم الصادرات داخله لمحاكاة ما توفره JavaScript.
// types/index.d.ts
// Declare a module with exports
declare module "mylib" {
export function greet(name: string): string
export const version: string
}export type مقابل export
يُستخدم export type (أو interface) للإنشاءات الخاصة بالأنواع فقط. استخدم export للدوال والثوابت والفئات، أي للعناصر الموجودة في وقت التشغيل.
// shapes.d.ts
export type Point = { x: number; y: number }
export interface User {
id: string
name: string
}
export function distance(a: Point, b: Point): number
export const VERSION: stringتوسيع الوحدات
يمكنك توسيع الوحدات الموجودة بإعادة فتحها في ملف تعريف آخر. ويفيد ذلك في تصحيح حزم الجهات الخارجية.
// augment.d.ts
import "mylib"
declare module "mylib" {
export function extra(): void
}أفضل الممارسات
أفضل الممارسات:
- أبقِ ملفات .d.ts صغيرة، وتجنب العناصر العامة غير الضرورية.
- افصل بوضوح بين صادرات الأنواع وصادرات القيم.
- اختبر ملفات التعريف باستخدام
tsc --noEmitواستخدام نموذجي.
التحقق من export type
تحقق سريع: متى ينبغي استخدام export type؟
خلاصة
خلاصة: تعرّف ملفات .d.ts الأنواع دون تنفيذ. استخدم declare global أو declare module، وافصل بين export type وexport، واتبع أفضل الممارسات.
الأسئلة الشائعة
هل درس «.d.ts الأساسية؛ export type مقابل export» مجاني؟
نعم — نص درس «.d.ts الأساسية؛ export type مقابل export» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة TypeScript Academy، انتقل إلى CoddyKit PRO. تتضمن دورة TypeScript Academy 2 دروس في المجموع.
ماذا ستتعلم في «.d.ts الأساسية؛ export type مقابل export»؟
تعلّم أساسيات ملفات التصريحات: التصريحات المحيطة مقابل تصريحات الوحدات، و export type مقابل export، وضمان تجربة مطوّر صحيحة للمستهلكين. تتمرن على TypeScript Academy مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.
هل أحتاج إلى خبرة سابقة لأبدأ TypeScript Academy؟
لا تُشترط خبرة سابقة. TypeScript Academy على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 1 من أصل 2.
كم من الوقت يستغرق درس «.d.ts الأساسية؛ export type مقابل export»؟
معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.
هل يمكنني كتابة وتشغيل أكواد في درس TypeScript Academy هذا؟
نعم. كل درس في TypeScript Academy يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.
جميع الدروس في هذه الدورة
- .d.ts الأساسية؛ export type مقابل export
- نشر الحزم مع الأنواع