تطبيق: الوحدات

Modules Walkthrough

تطبيق ~20 دقيقة

تطبيق: الوحدات — Modules Walkthrough

في مشروع TypeScript حقيقي، لن تضع كل شيء في ملف واحد. الوحدات تجعل كل ملف يعلن ما يقدمه عبر export، ويستخدم ما يحتاجه عبر import. هذا ليس تنظيماً شكلياً فقط؛ هو حد معماري صغير. الملف الذي يصدّر دالة formatPrice يقول لبقية المشروع: هذه أداة عامة يمكن استخدامها.

لا تصدّر كل شيء. اترك التفاصيل الداخلية داخل الملف، وصدّر الواجهات والدوال التي تمثل عقداً. كل export يصبح شيئاً قد يعتمد عليه ملف آخر، لذلك اجعله واضحاً ومستقراً.

مثال ملفين

index.ts

// money.ts — ملف أدوات المال — Money utilities file
export function formatHalalas(halalas: number): string {
  const riyals = halalas / 100;
  return `${riyals.toFixed(2)} SAR`;
}

// app.ts — ملف الاستخدام — Usage file
// import { formatHalalas } from "./money";

console.log(formatHalalas(1250));

Output:

داخل playground وضعنا الملفين كتوضيح في نفس الكتلة. في مشروع فعلي، يكون كل جزء في ملف منفصل.

default أم named exports؟

استخدم named exports افتراضياً لأنها أوضح عند إعادة التسمية والبحث. default export مناسب في بعض الأطر، لكنه قد يجعل الأسماء أقل ثباتاً.

تحدي — Challenge

function formatHalalas(halalas: number): string {
  /* TODO */
  return ""; // حول halalas إلى SAR بمنزلتين — Convert halalas to SAR with two decimals
}

console.log(formatHalalas(1250));