التصريحات المحيطة (.d.ts) وكتابات الجهات الخارجية
اكتب تصريحات محيطة في ملفات .d.ts لوصف المتغيرات العامة والوحدات، وثبّت كتابات الجهات الخارجية واستخدمها بأمان.
التصريحات المحيطة (.d.ts) وكتابات الجهات الخارجية درس مجاني في TypeScript Academy على CoddyKit. هذا هو الدرس 2 من أصل 3. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في TypeScript Academy، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة TypeScript Academy 3 دروس في المجموع.
مقدمة
الهدف: وصف JavaScript الخارجي باستخدام التصريحات المحيطة في ملفات .d.ts، واستخدام تعريفات الأنواع التابعة لجهات خارجية للمكتبات التي لا توفر أنواعًا.
التصريحات العامة
globals.d.ts: صرّح بالمتغيرات العامة ووسّع الواجهات المحيطة (مثل Window) من دون إصدار JavaScript.
// file: globals.d.ts
// Declare global variables and interfaces
declare const VERSION: string;
declare interface Window {
appReady?: boolean;
}أساسيات Lambda مع receiver
- Receiver = مثيل builder المستخدم داخل lambda.
- استدعاءات أنظف: item("Tea") بدلًا من builder.item.
- أبقِ الأسماء قصيرة والأفعال واضحة.
تصريحات الوحدات
يصف declare module حزمةً لا توفر أنواعًا. والآن يتحقق TypeScript من import { coolify } من ناحية الأنواع بشكل صحيح.
// file: cool-lib.d.ts
// Provide types for an untyped JS module
declare module "cool-lib" {
export function coolify(s: string): string;
export const version: string;
}توسعة الوحدات
تعمل توسعة الوحدات على توسيع تعريفات الأنواع المثبتة، مثل إضافة خاصية مخصصة إلى واجهة موجودة.
// file: react-augment.d.ts
// Extend an existing module (augmentation)
declare module "react" {
interface HTMLAttributes<T> {
dataTestId?: string;
}
}تعريفات الأنواع التابعة لجهات خارجية
فضّل حزم @types/ من DefinitelyTyped عندما لا توفر المكتبة أنواعًا. فهي تضيف ملفات .d.ts فقط إلى عملية البناء.
// install: npm i -D @types/lodash
// usage:
import _ from "lodash";
const r = _.chunk([1,2,3,4], 2);نصائح وحل الوحدات
نصائح:
- ضع ملفات .d.ts ضمن src/ أو أدرجها من خلال tsconfig.json (
include/typeRoots/types). - استخدم توسعة الوحدات لإضافة التوسعات، وتجنب تعديل node_modules.
- تجنب استخدام
anyبشكل واسع؛ وحدد أشكالًا دقيقة بالحد الأدنى المطلوب.
التحقق من التصريحات المحيطة
تحقق سريع: ما الغرض من استخدام التصريح المحيط؟
مراجعة
مراجعة: استخدم ملفات .d.ts للتصريحات العامة وتصريحات الوحدات، وفضّل @types لتعريفات الأنواع التي يوفرها المجتمع، ووسّع الأنواع بأمان باستخدام توسعة الوحدات.
مراجعة
مراجعة: استخدم مستقبلات محددة النوع لكل كتلة، وأضف @DslMarker لضمان أمان النطاق، وأعد نموذجًا غير قابل للتغيير لاستخدام واضح ونظيف.
الأسئلة الشائعة
هل درس «التصريحات المحيطة (.d.ts) وكتابات الجهات الخارجية» مجاني؟
نعم — نص درس «التصريحات المحيطة (.d.ts) وكتابات الجهات الخارجية» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة TypeScript Academy، انتقل إلى CoddyKit PRO. تتضمن دورة TypeScript Academy 3 دروس في المجموع.
ماذا ستتعلم في «التصريحات المحيطة (.d.ts) وكتابات الجهات الخارجية»؟
اكتب تصريحات محيطة في ملفات .d.ts لوصف المتغيرات العامة والوحدات، وثبّت كتابات الجهات الخارجية واستخدمها بأمان. تتمرن على TypeScript Academy مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.
هل أحتاج إلى خبرة سابقة لأبدأ TypeScript Academy؟
لا تُشترط خبرة سابقة. TypeScript Academy على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 2 من أصل 3.
كم من الوقت يستغرق درس «التصريحات المحيطة (.d.ts) وكتابات الجهات الخارجية»؟
معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.
هل يمكنني كتابة وتشغيل أكواد في درس TypeScript Academy هذا؟
نعم. كل درس في TypeScript Academy يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.
جميع الدروس في هذه الدورة
- وحدات ES (المسمّاة مقابل الافتراضية) وإعادة التصدير
- التصريحات المحيطة (.d.ts) وكتابات الجهات الخارجية
- تعيين المسارات وحلّ الوحدات