أنواع القوالب الحرفية: أنماط السلاسل النصية

مرحبًا

نوع القالب الحرفي الأساسي

type Greeting = `Hello, ${string}`;
const g: Greeting = 'Hello, World'; // OK
// const bad: Greeting = 'Hi there'; // Error

جمع الاتحادات

type Color = 'red' | 'green' | 'blue';
type Size = 'sm' | 'lg';
type ColorSize = `${Color}-${Size}`;
// 'red-sm' | 'red-lg' | 'green-sm' | ...

نمط أسماء الأحداث

type Entity = 'user' | 'product';
type EventName = `on${Capitalize<Entity>}Created`;
// 'onUserCreated' | 'onProductCreated'

Capitalize والأنواع الجوهرية الأخرى

type T = Capitalize<'hello world'>; // 'Hello world'
type U = Uppercase<'hello'>;        // 'HELLO'
type L = Lowercase<'WORLD'>;        // 'world'

نمط إنشاء أساليب getter

type Getters<T> = {
  [K in keyof T as `get${Capitalize<string & K>}`]: () => T[K]
};

معاملات المسارات ذات الأنواع

type RouteParams<T extends string> =
  T extends `${infer _Start}:${infer Param}/${infer Rest}`
    ? Param | RouteParams<Rest>
    : T extends `${infer _Start}:${infer Param}`
    ? Param
    : never;

تسمية خصائص CSS

type CSSVar = `--${string}`;
const color: CSSVar = '--primary-color'; // OK

القالب الحرفي في معاملات الدوال

function emit<E extends `on${string}`>(event: E): void {
  console.log('Emitting:', event);
}
emit('onClick'); // OK
// emit('click'); // Error — must start with 'on'

استخراج الأجزاء باستخدام infer

type GetSuffix<T extends string> =
  T extends `${infer _Prefix}_${infer Suffix}` ? Suffix : never;
type S = GetSuffix<'user_created'>; // 'created'

التقاطع مع Record

type Handlers<T extends string> = Record<`on${Capitalize<T>}`, () => void>;

تحقّق سريع

مراجعة