الدليل الشامل لـ TypeScript 5.5: الميزات الجديدة واستراتيجيات الترحيل

يقدّم TypeScript 5.5 تحسينات كبيرة على نظام الأنواع وتجربة المطوّر. سواء كنت تبدأ من جديد أو تُرحّل مشروع JavaScript قائماً، سيساعدك هذا الدليل على الاستفادة من أحدث الميزات بفعّالية.

الميزات الرئيسية في TypeScript 5.5

1. استنتاج أنواع محسّن

يتميّز TypeScript 5.5 باستنتاج أذكى يقلّل الحاجة إلى تعليقات الأنواع الصريحة:

// The type is now correctly inferred as (string | number)[]
const mixed = [1, "two", 3, "four"];

// Function return types are inferred more accurately
function processData(input: unknown) {
    if (typeof input === "string") {
        return input.toUpperCase(); // string
    }
    if (typeof input === "number") {
        return input * 2; // number
    }
    return null;
}
// Return type: string | number | null

2. معاملات النوع الثابتة (Const Type Parameters)

function createConfig<const T extends Record<string, unknown>>(config: T): T {
    return config;
}

// Type is exactly { apiUrl: "https://api.example.com"; timeout: 5000 }
const config = createConfig({
    apiUrl: "https://api.example.com",
    timeout: 5000
});

3. بيانات وصفية للمزخرفات (Decorator Metadata)

function logged(target: any, context: ClassMethodDecoratorContext) {
    const methodName = String(context.name);

    return function (...args: any[]) {
        console.log(\`Calling \${methodName} with:\`, args);
        const result = target.apply(this, args);
        console.log(\`\${methodName} returned:\`, result);
        return result;
    };
}

class Calculator {
    @logged
    add(a: number, b: number) {
        return a + b;
    }
}

استراتيجيات الترحيل

نهج الترحيل التدريجي

1. أضف TypeScript إلى مشروعك:

   npm install typescript --save-dev
   npx tsc --init

2. اضبطه للتبنّي التدريجي:

   // tsconfig.json
   {
     "compilerOptions": {
       "allowJs": true,
       "checkJs": false,
       "strict": false,
       "noImplicitAny": false
     }
   }

3. حوّل الملفات تدريجياً: ابدأ بالدوال المساعِدة وتقدّم نحو المكوّنات المعقّدة
4. فعّل الوضع الصارم تدريجياً: شغّل علماً صارماً واحداً في كل مرة

أعلام الوضع الصارم التي ينبغي تفعيلها

{
  "compilerOptions": {
    "strict": true,                    // Enable all strict checks
    "noImplicitAny": true,            // Error on implicit any
    "strictNullChecks": true,         // Null/undefined handling
    "strictFunctionTypes": true,      // Function type checking
    "strictPropertyInitialization": true // Class property init
  }
}

أنماط وأدوات شائعة

حُرّاس الأنواع (Type Guards)

interface Dog {
    bark(): void;
}

interface Cat {
    meow(): void;
}

function isDog(animal: Dog | Cat): animal is Dog {
    return 'bark' in animal;
}

function makeSound(animal: Dog | Cat) {
    if (isDog(animal)) {
        animal.bark(); // TypeScript knows it's a Dog
    } else {
        animal.meow(); // TypeScript knows it's a Cat
    }
}

أنواع المرافق (Utility Types)

interface User {
    id: string;
    name: string;
    email: string;
    password: string;
}

// Create a type without sensitive fields
type PublicUser = Omit<User, 'password'>;

// Create a type with all optional fields
type PartialUser = Partial<User>;

// Create a type with all required fields
type RequiredUser = Required<PartialUser>;

يواصل TypeScript تطوّره وتحسّنه. ابقَ مواكباً لأحدث الميزات لكتابة شيفرة أكثر أماناً وقابلية للصيانة.