الأنواع في TypeScript: string وnumber وboolean وغيرها

تصف أنواع TypeScript نوع القيمة التي يمكن أن يحملها متغير. تكتب النوع بعد نقطتين، let name: string، فيرفض المترجم أي كود يضع هناك قيمة من نوع خاطئ. الأنواع الأساسية هي الأنواع البدائية السبعة في JavaScript، إضافة إلى أنواع الكائنات للمصفوفات والكائنات.

let title: string = "TypeScript";
let version: number = 7;
let isStrict: boolean = true;
let big: bigint = 9007199254740993n;
let id: symbol = Symbol("id");
let nothing: null = null;
let notSet: undefined = undefined;

let scores: number[] = [90, 72, 85];
let user: { name: string; age: number } = { name: "Ada", age: 36 };

console.log(title, version, isStrict, big, id);
console.log(nothing, notSet);
console.log(scores, user);

تُفحص تعليقات الأنواع وقت الترجمة ثم تُحذف. البرنامج الذي يعمل هو JavaScript عادية.

الأنواع البدائية

أسماء الأنواع بأحرف صغيرة. ويعيد typeof وقت التشغيل الكلمات نفسها لمعظمها، لذلك فإن typeof x === "number" هي طريقة التحقق من النوع البدائي لقيمة أثناء تشغيل البرنامج.

تعليقات الأنواع

التعليق هو : Type بعد متغير أو معامل أو قائمة معاملات دالة. المعاملات هي المكان الذي تهم فيه التعليقات أكثر، لأن TypeScript لا تستطيع تخمين ما سيمرره المستدعي.

function describe(name: string, age: number, admin: boolean): string {
    return `${name} (${age})${admin ? " [admin]" : ""}`;
}

let label: string = describe("Ada", 36, true);
console.log(label); // Ada (36) [admin]

// Without an annotation, TypeScript infers the type from the value:
let count = 10; // count: number
count = count + 1;
console.log(count); // 11

عندما يُهيأ المتغير في السطر نفسه، يكون التعليق زائدًا عادة: let count = 10 نوعه number أصلًا. قواعد ترك الأنواع موجودة في صفحة استنتاج الأنواع.

النوع الخاطئ خطأ ترجمة

أسند قيمة من نوع خاطئ فيتوقف المترجم قبل تشغيل أي شيء:

// This does not compile: a string is not a number.
let port: number = 8080;
port = "3000";
console.log(port);

يطبع المترجم:

index.ts(3,1): error TS2322: Type 'string' is not assignable to type 'number'.

الحل هو تحويل القيمة، port = Number("3000")، أو تغيير التعليق إذا كان المتغير يجب فعلًا أن يحمل نصًا.

number: لا يوجد نوع للأعداد الصحيحة

تخزن JavaScript كل رقم كقيمة عشرية 64 بت، لذلك لدى TypeScript نوع واحد هو number. الأعداد الصحيحة دقيقة حتى Number.MAX_SAFE_INTEGER (2 ** 53 - 1). وبعد ذلك استخدم bigint.

let price: number = 19.99;
let quantity: number = 3; // also number: no int type

console.log(Number.isInteger(quantity)); // true
console.log(Number.isInteger(price));    // false
console.log(Math.trunc(7 / 2));          // 3 (integer division)
console.log(0.1 + 0.2);                  // 0.30000000000000004

console.log(Number.MAX_SAFE_INTEGER);     // 9007199254740991
console.log(Number.MAX_SAFE_INTEGER + 2); // 9007199254740992 (wrong)

let exact: bigint = 9007199254740991n + 2n;
console.log(exact); // 9007199254740993n

// @ts-expect-error: bigint and number cannot be mixed
const mixed = () => exact + 1;
console.log(exact + BigInt(1), Number(exact)); // 9007199254740994n 9007199254740992

لا يختلط bigint وnumber: exact + 1 خطأ ترجمة (TS2365: Operator '+' cannot be applied to types 'bigint' and '1'.، حيث '1' هو النوع الحرفي للقيمة 1)، ولو شُغّل لكان TypeError وقت التشغيل أيضًا. حوّل أحد الطرفين صراحة بـ BigInt(1) أو Number(exact)، مع العلم أن Number يقرّب القيم التي تتجاوز النطاق الآمن.

إذا أردت نوعًا لا يقبل إلا الأعداد الصحيحة، فلا تستطيع TypeScript التعبير عنه لقيم عشوائية. تحقق بـ Number.isInteger عند دخول القيمة إلى برنامجك.

boolean

لـ boolean قيمتان بالضبط، true وfalse. القيم التي تُعد صحيحة منطقيًا فقط (1 و"yes") ليست من نوع boolean، لذلك حوّلها بـ Boolean(x) أو x !== 0.

let loggedIn: boolean = false;
const items: string[] = ["a", "b"];

const hasItems: boolean = items.length > 0;
const hasName: boolean = Boolean("Ada");

console.log(loggedIn, hasItems, hasName); // false true true

null و undefined

مع تفعيل strict (وهو الافتراضي منذ TypeScript 6.0)، يكون null وundefined نوعين منفصلين، وليسا جزءًا من string أو number أو أي نوع آخر. المتغير الذي قد يكون فارغًا يصرّح بذلك باستخدام union:

let nickname: string | undefined;
console.log(nickname); // undefined

nickname = "Ace";
console.log(nickname.toUpperCase()); // ACE

let middleName: string | null = null;
console.log(middleName ?? "(none)"); // (none)

قراءة خاصية من قيمة قد تكون undefined خطأ ترجمة حتى تتحقق منها. تغطي صفحة null و undefined هذه الفحوص و?. و??.

لمحة عن المصفوفات والكائنات

كل ما ليس نوعًا بدائيًا هو نوع كائن. الأشكال الثلاثة التي تقابلها أولًا:

let tags: string[] = ["ts", "js"];               // array of strings
let point: { x: number; y: number } = { x: 1, y: 2 }; // object with two number properties
let greet: (name: string) => string = (n) => `hi ${n}`; // function type

لكل منها صفحة خاصة: المصفوفات، وtuples (مصفوفات ذات طول ثابت)، وأنواع الكائنات، وأنواع الدوال.

string وnumber وboolean مقابل String وNumber وBoolean

الأسماء التي تبدأ بحرف كبير هي أنواع الكائنات المغلِّفة في JavaScript (new String("x"))، لا أنواع القيم العادية. اكتب التعليقات بالأسماء ذات الأحرف الصغيرة.

// This does not compile: String (the wrapper) is not string (the primitive).
const wrapped: String = "text";
const plain: string = wrapped;
console.log(plain);

index.ts(3,7): error TS2322: Type 'String' is not assignable to type 'string'.
  'string' is a primitive, but 'String' is a wrapper object. Prefer using 'string' when possible.

غيّر String إلى string في السطر الأول فيعمل المثال. وينطبق الأمر نفسه على Number وBoolean وSymbol وBigInt. (أما Object فحالة مختلفة: يقبل أي قيمة تقريبًا، ومنها القيم البدائية؛ انظر أنواع الكائنات.)

أنواع مدمجة أخرى

تظهر بعض الأنواع الأخرى مبكرًا. لكل منها صفحة خاصة.