كيفية إنشاء وحدات TypeScript واستخدامها

توفر وحدات TypeScript نهجًا منظمًا لتنظيم وإدارة التعليمات البرمجية. تتيح الوحدات تغليف التعليمات البرمجية في ملفات منفصلة، ​​مما يعزز إمكانية الصيانة وإعادة الاستخدام والاختبار. يشرح هذا الدليل عملية إنشاء وحدات TypeScript واستخدامها.

ما هي وحدات TypeScript؟

وحدات TypeScript هي ملفات فردية تقوم بتصدير واستيراد عناصر التعليمات البرمجية مثل الفئات والوظائف والمتغيرات. من خلال استخدام الوحدات، يمكن تقسيم التعليمات البرمجية إلى أجزاء قابلة للإدارة، مما يسهل التحكم بشكل أفضل في التفاعلات بين الأجزاء المختلفة من التعليمات البرمجية.

إنشاء وحدة TypeScript

لإنشاء وحدة TypeScript، يجب اتباع الخطوات التالية:

  1. قم بإنشاء ملف TypeScript: ابدأ بإنشاء ملف `.ts` جديد للوحدة، مثل `mathUtils.ts`.
  2. قم بتعريف وتصدير الكود: قم بتنفيذ الوظائف أو الفئات أو المتغيرات داخل هذا الملف واستخدم الكلمة الأساسية export لجعلها متاحة للوحدات النمطية الأخرى.

مثال على وحدة بسيطة:

// mathUtils.ts

export function add(a: number, b: number): number {
  return a + b;
}

export function subtract(a: number, b: number): number {
  return a - b;
}

في هذا المثال، تم تعريف الدالتين `add` و`subtract` وتصديرهما من وحدة `mathUtils.ts`.

استيراد وحدة TypeScript واستخدامها

للاستفادة من الكود من وحدة TypeScript في ملف آخر، يجب استيراده. ويتضمن ذلك:

  1. إنشاء ملف TypeScript جديد: إنشاء ملف حيث سيتم استخدام كود الوحدة النمطية، مثل `app.ts`.
  2. استيراد الوحدة النمطية: استخدم الكلمة الأساسية import لإحضار الوظائف أو الفئات أو المتغيرات من الوحدة النمطية.

مثال على استيراد واستخدام الدالتين `add` و`subtract`:

// app.ts

import { add, subtract } from './mathUtils';

const sum = add(5, 3);
const difference = subtract(5, 3);

console.log(`Sum: ${sum}`);
console.log(`Difference: ${difference}`);

في هذا المثال، يتم استيراد الدالتين `add` و`subtract` من وحدة `mathUtils` واستخدامهما داخل الملف `app.ts`.

الصادرات الافتراضية والمسماة

تدعم وحدات TypeScript كلاً من التصدير الافتراضي والمسمى. فيما يلي نظرة عامة موجزة:

  • الصادرات الافتراضية: يمكن تصدير قيمة واحدة كتصدير افتراضي من وحدة باستخدام export default.
  • الصادرات المسماة: يمكن تصدير قيم متعددة من وحدة باستخدام الصادرات المسماة مع الكلمة الأساسية export.

مثال يوضح كلا النوعين من الصادرات:

// shapes.ts

export default class Circle {
  constructor(public radius: number) {}
  
  area(): number {
    return Math.PI * this.radius ** 2;
  }
}

export function getCircleInfo(radius: number): string {
  const circle = new Circle(radius);
  return `A circle with radius ${radius} has an area of ${circle.area()}`;
}

في هذا المثال، يتم تصدير `Circle` كتصدير افتراضي، بينما `getCircleInfo` عبارة عن تصدير مسمى.

تنظيم الوحدات في المشروع

بالنسبة للمشاريع الأكبر حجمًا التي تحتوي على وحدات متعددة، يصبح التنظيم أمرًا بالغ الأهمية. ضع في اعتبارك النصائح التالية:

  • هيكل الدليل: تجميع الوحدات النمطية ذات الصلة في أدلة مثل `models/` و`services/` و`utils/`.
  • ملفات الفهرس: استخدم ملفات `index.ts` في الدلائل لتجميع وإعادة تصدير الوحدات النمطية، مما يسهل عمليات الاستيراد عبر المشروع.

مثال على هيكل الدليل:

project/
│
├── src/
│   ├── models/
│   │   ├── index.ts
│   │   └── user.ts
│   └── app.ts

خاتمة

تُعد وحدات TypeScript ميزة أساسية لتنظيم وإدارة التعليمات البرمجية. من خلال إنشاء الوحدات واستخدامها، يمكن الحفاظ على التعليمات البرمجية معيارية وقابلة للصيانة وقابلة للتطوير. إن فهم كيفية تصدير التعليمات البرمجية واستيرادها، بالإضافة إلى كيفية هيكلة المشروع، يعزز فعالية تطوير TypeScript.