如何创建含指定可选值的字符串类型数组？TypeScript类型提示问题

你遇到的问题是因为TypeScript会自动将SearchSchemaValue | string这样的联合类型简化为string，导致数组类型被识别为string[]，IDE无法提供特定值的提示。可以通过以下两种方式解决：

方法一：修改类型定义，保留联合类型提示 #

将SearchSchema的元素类型改为SearchSchemaValue | (string & {})，利用string & {}阻止TypeScript的类型自动拓宽：

type SearchSchemaValue =
    | 'tagName'
    | 'textContent'
    | 'attributes'
    | 'attributes.id'
    | 'attributes.class'
    | 'attributes.style';

export type SearchSchema = Array<SearchSchemaValue | (string & {})>;

这样定义后，IDE在你输入const schema: SearchSchema = ['时会自动弹出SearchSchemaValue中的所有选项，同时依然允许你输入任意自定义字符串，不会出现类型错误。

方法二：使用satisfies操作符（无需修改类型） #

如果你不想修改原有的类型定义，可以在赋值时使用satisfies操作符，它既能让IDE提供提示，又能确保数组符合SearchSchema的类型要求：

// 原类型定义不变
type SearchSchemaValue =
    | 'tagName'
    | 'textContent'
    | 'attributes'
    | 'attributes.id'
    | 'attributes.class'
    | 'attributes.style';

export type SearchSchema = (SearchSchemaValue | string)[];

// 使用satisfies
const schema = ['tagName', 'custom-attribute'] satisfies SearchSchema;

这种方式下，TypeScript会根据你输入的内容推断更具体的数组类型，同时IDE会在输入过程中提示SearchSchemaValue的可选值。

内容的提问来源于stack exchange，提问作者vdegenne