النصوص في TypeScript: الإدراج والنصوص متعددة الأسطر والبحث

النص في TypeScript هو نص JavaScript نوعه string. لإدراج القيم، اكتب template literal: علامات backtick مع عناصر نائبة ${expression}. أما علامات الاقتباس المفردة والمزدوجة فتنتج نصوصًا عادية دون إدراج.

const author: string = "Ada";
const year = 1843;

// String interpolation with a template literal
const intro = `${author} published her notes in ${year}.`;
console.log(intro);

// Any expression works inside ${ }
const price = 19.5;
const qty = 3;
console.log(`Total: $${(price * qty).toFixed(2)}`); // Total: $58.50
console.log(`${qty > 1 ? "items" : "item"} in cart: ${qty}`);

أنماط علامات الاقتباس الثلاثة تنتج النوع نفسه، string. أول $ في $${...} علامة دولار حرفية؛ و${ وحدها تبدأ عنصرًا نائبًا.

إدراج القيم في النصوص

داخل ${ } يمكنك وضع متغير أو عملية حسابية أو استدعاء دالة أو تعبير شرطي ثلاثي أو template literal متداخل. تُحوَّل القيمة إلى نص بالطريقة نفسها التي يحوّلها بها String(value) (الاستثناء هو symbol: إدراجه خطأ الترجمة TS2731، وكان سيرمي TypeError وقت التشغيل؛ اكتب String(sym)).

type User = { name: string; roles: string[]; lastLogin: Date | null };

const user: User = {
    name: "grace",
    roles: ["admin", "editor"],
    lastLogin: new Date("2024-03-15T10:30:00Z"),
};

const capitalize = (s: string) => s[0].toUpperCase() + s.slice(1);

console.log(`User: ${capitalize(user.name)}`);
console.log(`Roles: ${user.roles.join(", ")}`);
console.log(`Last login: ${user.lastLogin?.toISOString() ?? "never"}`);
console.log(`Raw array: ${user.roles}`); // arrays join with commas

إدراج كائن يطبع [object Object]، وهذا ما لا تريده في أغلب الأحوال. اختر الحقول، أو استخدم JSON.stringify(obj).

النصوص متعددة الأسطر

يمكن أن يمتد template literal على عدة أسطر. تُحفظ فواصل الأسطر، وتُحفظ كذلك أي مسافات بادئة في بداية كل سطر، لأن كل ما بين علامتي backtick جزء من النص.

const poem = `Roses are red,
Violets are blue,
Types are erased,
And so are you.`;
console.log(poem);

function card(title: string, body: string): string {
    return `
    [${title}]
    ${body}`; // the leading spaces and first newline are in the string
}
console.log(JSON.stringify(card("Note", "Hi")));

// Alternatives without the indentation problem:
const lines = ["first line", "second line"].join("\n");
console.log(lines);

عندما تتسرب المسافات البادئة في كودك إلى النص، ابنِه بمصفوفة وjoin("\n")، أو اجعل أسطر template literal تبدأ من أول السطر.

التحقق من أن نصًا يحتوي على نص فرعي

يجيب includes عن سؤال «هل يحتوي» بقيمة boolean. ويفحص startsWith وendsWith الطرفين. ويعطي indexOf الموضع، أو -1 عند غياب النص الفرعي. كلها حساسة لحالة الأحرف.

const file = "Report-2024.PDF";

console.log(file.includes("2024"));    // true
console.log(file.includes("pdf"));     // false: case-sensitive
console.log(file.toLowerCase().endsWith(".pdf")); // true
console.log(file.startsWith("Report")); // true
console.log(file.indexOf("-"));        // 6
console.log(file.indexOf("x"));        // -1

// A regular expression for patterns, with the i flag for case-insensitive
console.log(/report-\d{4}/i.test(file)); // true

يقبل includes أيضًا موضع بدء: file.includes("R", 1) يبحث ابتداءً من الفهرس 1 فقط.

الدوال الشائعة وأنواعها

تعرف TypeScript نوع القيمة المُعادة لكل دالة مدمجة. الدوال التي قد تعود فارغة هي ما يجب الانتباه إليه، لأنه تحت strict يجب أن تعالج null أو undefined قبل استخدام الناتج.

const log = "error=404 path=/users";

const match = log.match(/error=(\d+)/);
// match is RegExpMatchArray | null: check before indexing
if (match) {
    console.log(Number(match[1])); // 404
}

const last = "abc".at(-1); // string | undefined
console.log(last?.toUpperCase()); // C

const parts = log.split(" ").map((p) => p.split("="));
console.log(parts); // [ [ 'error', '404' ], [ 'path', '/users' ] ]

الوصول العادي بالفهرس، s[5]، نوعه string حتى عندما يتجاوز الفهرس النهاية (حيث تكون القيمة undefined وقت التشغيل). خيار المترجم noUncheckedIndexedAccess يجعله string | undefined بدلًا من ذلك.

النصوص غير قابلة للتغيير

لا يمكنك تغيير حرف في مكانه. تبلّغ TypeScript عن الإسناد إلى فهرس بالخطأ TS2542، Index signature in type 'String' only permits reading.، وفي كود JavaScript بالوضع الصارم الذي يُترجم إليه، كان الإسناد نفسه سيرمي TypeError وقت التشغيل. كل دالة تبدو كأنها تعدّل نصًا تعيد نصًا جديدًا.

let word = "hello";

// @ts-expect-error: Index signature in type 'String' only permits reading.
const change = () => { word[0] = "H"; };

word = "H" + word.slice(1); // build a new string instead
console.log(word);          // Hello

لتحويل قيم أخرى إلى نصوص، أو نصوص إلى أرقام، انظر تحويل النص إلى رقم.

أنواع النصوص الحرفية

يقبل string أي نص. أما نوع النص الحرفي فيقبل قيمة واحدة بالضبط، وunion منها يصنع مجموعة من النصوص المسموحة تشبه enum:

type Status = "draft" | "published" | "archived";

function label(status: Status): string {
    return `Post is ${status}`;
}

console.log(label("draft"));
// @ts-expect-error: Argument of type '"deleted"' is not assignable to parameter of type 'Status'.
console.log(label("deleted"));

تُفحص الأنواع الحرفية وقت الترجمة فقط؛ وقت التشغيل سيعمل label("deleted") رغم ذلك ويطبع Post is deleted، وهذا ما يفعله السطر الثاني هنا. وتعمل صياغة template literal أيضًا على مستوى الأنواع، كما في type EventName = `on${string}`، الذي يقبل أي نص يبدأ بـ on.