مقدمة إلى توسيع الوحدات

يتيح توسيع الوحدات تمديد الوحدات الموجودة أو تعديلها، مما يسمح بإضافة خصائص أو أساليب مخصصة إلى المكتبات أو الوحدات في TypeScript.

يفيد ذلك خصوصًا عند العمل مع مكتبات الجهات الخارجية التي تحتاج إلى وظائف إضافية أو أنواع مخصصة.

ما توسيع الوحدات؟

يتضمن توسيع الوحدات إعادة فتح وحدة موجودة وإضافة أنواعها أو وظائفها أو تعديلها باستخدام بناء الجملة declare module.

مثال أساسي على توسيع الوحدات

إليك مثالًا على توسيع الوحدة express لإضافة خاصية مخصصة إلى الكائن Request:

import 'express';

declare module 'express' {
  interface Request {
    user?: { id: string; role: string };
  }
}

استخدام الوحدات الموسّعة

بعد توسيع الوحدة، يمكنك استخدام الوظائف الموسّعة في تطبيقك:

import express from 'express';

const app = express();

app.use((req, res, next) => {
  req.user = { id: '123', role: 'admin' };
  next();
});

app.get('/', (req, res) => {
  res.send(`User ID: ${req.user?.id}`);
});

إضافة أنواع مخصصة إلى وحدات الجهات الخارجية

يُستخدم توسيع الوحدات غالبًا لإضافة أنواع مخصصة إلى مكتبات الجهات الخارجية التي لا تغطي حالة استخدامك بالكامل.

احتياطات عند توسيع الوحدات

عند توسيع وحدة:

• تأكد من عدم استبدال الأنواع الموجودة عن غير قصد.
• وثّق تغييراتك لتحسين قابلية صيانة التعليمات البرمجية.
• استخدم توسيع الوحدات عند الحاجة فقط لتجنب ازدحام الأنواع العامة.

حالات الاستخدام الواقعية

يُستخدم توسيع الوحدات عادةً في:

• توسيع مكتبات الجهات الخارجية لتضمين خصائص خاصة بالتطبيق.
• إضافة خصائص مخصصة للبرمجيات الوسيطة في أطر عمل مثل Express.js.
• تكييف الوحدات لتلبية متطلبات مشاريع محددة.

مهمة تدريبية

وسّع الكائن Request من الوحدة express ليشمل أسلوبًا مخصصًا باسم isAuthenticated. استخدم هذا الأسلوب في دالة برمجية وسيطة نموذجية.

تهانينا!

لقد تعلّمت كيفية استخدام توسيع الوحدات لتمديد الوحدات الموجودة أو تعديلها في TypeScript. مارس هذه المهارة لتخصيص مكتبات الجهات الخارجية وتحسين تطبيقاتك!