اختبار جاهزية الإنتاج

Production Readiness Quiz

اختبار ~24 دقيقة

اختبار جاهزية الإنتاج — Production Readiness Quiz

وصلت إلى نهاية مسار TypeScript. الفكرة الأساسية التي يجب أن تبقى معك: الأنواع تصميم. ليست زخرفة ولا مجرد إسكات compiler. النوع الجيد يصف المجال، يضيّق الاحتمالات، ويجعل التغيير أكثر أماناً. لكن البيانات الخارجية تحتاج تحقق runtime، والاختبارات ما زالت ضرورية للسلوك.

قبل اعتبار كود TypeScript جاهزاً، اسأل: هل strict مفعّل؟ هل any محصور؟ هل استجابات API تمثل الفشل؟ هل unions لها فحص شامل؟ هل public types مستقرة وواضحة؟ هل المنطق المهم قابل للاختبار؟ هذه الأسئلة تحول TypeScript من syntax إلى ممارسة هندسية.

مراجعة نهائية

index.ts

type Result<T> =
  | { ok: true; value: T }
  | { ok: false; error: string };

function readPort(value: unknown): Result<number> {
  if (typeof value !== "string") {
    return { ok: false, error: "port must be a string" };
  }

  const port = Number(value);
  if (!Number.isInteger(port) || port <= 0 || port > 65535) {
    return { ok: false, error: "port must be between 1 and 65535" };
  }

  return { ok: true, value: port };
}

const result = readPort("3000");
console.log(result.ok ? `port=${result.value}` : result.error);

Output:

هذا المثال يجمع unknown, validation, وResult. هذه هي عقلية production.

التحدي الأخير

أكمل الدالة بحيث ترجع ok فقط عندما تكون القيمة "ready".

تحدي — Challenge

type Result = { ok: true; value: string } | { ok: false; error: string };

function checkReady(value: unknown): Result {
  /* TODO: تحقق من value ثم أرجع Result مناسب */
  return { ok: false, error: "todo" }; // أرجع نجاحاً فقط إذا value === "ready" — Return success only for ready
}

const result = checkReady("ready");
console.log(result.ok ? result.value : result.error);

ماذا بعد؟

استخدم TypeScript في مشاريع حقيقية صغيرة: CLI، واجهة نموذج، أو API client. ابدأ بـstrict، اكتب types من المجال، وتجنب any إلا عند الحدود وبسبب واضح. عندما تشعر أن النوع صار معقداً جداً، لا تستسلم له؛ ارجع إلى التصميم. غالباً المشكلة ليست في TypeScript، بل في نموذج يحتاج اسماً أو فصلاً أو حالة أوضح.