TypeScript/JavaScript 如何按位和值选取字符串字面量并兼容指定类型
位运算匹配 TS 字面量的实现方案
核心认知澄清
TypeScript 的联合类型是编译期类型约束,仅存在于类型系统层面,运行时的 JavaScript 无法返回同时为多个值的联合运行时值。如果需要返回所有匹配项,必须用数组承载。
前置准备
要避免字面量被放宽为普通string,首先需要给位-值映射表加as const,强制保留字面量类型:
const optMap = [ { key: 1, val: "Aaa" }, { key: 2, val: "Bbb" }, { key: 4, val: "Ccc" }, { key: 8, val: "Ddd" } ] as const; // 此时 optMap 每一项的 val 都保留 "Aaa"/"Bbb" 等字面量类型,不会被推断为 string
变体2 实现(返回约束型数组)
需求:传入位和5时,运行时返回["Aaa", "Ccc"],类型为匹配项组成的字面量数组,而非普通string[]。
export function selectByBitwiseSum2(bitwiseSum: number): typeof optMap[number]["val"][] { // 显式标注结果数组的类型,避免被推断为 string[] const result = [] as typeof optMap[number]["val"][]; for (const item of optMap) { // 按位与判断当前位是否存在于传入的位和中 if (bitwiseSum & item.key) { result.push(item.val); } } return result; }
调用测试:
const result = selectByBitwiseSum2(5); // 运行时值为 ["Aaa", "Ccc"],类型为 ("Aaa"|"Bbb"|"Ccc"|"Ddd")[]
变体1 实现(类型自动收窄为匹配的联合)
你注释里的「返回"Aaa" | "Ccc"」是类型层面的期望,运行时如果要返回多值必须用数组,以下是两种符合场景的实现:
前置类型工具定义
首先基于as const的映射表生成类型推导工具,支持自动拆分位和、匹配对应字面量:
// 提取键到值的固定映射 type OptMap = typeof optMap; type BitKeys = OptMap[number]["key"]; type BitToValMap = { [K in BitKeys]: Extract<OptMap[number], { key: K }>["val"]; }; // 把传入的位和字面量拆成单个位的联合(支持最高到15的位和,按需扩展终止条件) type SplitNumberToBits<T extends number, CurrentBit extends number = 1> = CurrentBit extends 16 ? never : (T & CurrentBit) extends 0 ? SplitNumberToBits<T, CurrentBit << 1> : CurrentBit | SplitNumberToBits<Exclude<T, CurrentBit>, CurrentBit << 1>; // 自动计算匹配的字面量联合类型,普通number入参返回全量联合 type GetMatchedVals<T extends number> = number extends T ? BitToValMap[BitKeys] : BitToValMap[SplitNumberToBits<T>];
场景1:返回单个值,类型仅包含匹配到的字面量联合
(比如传入位和5时,返回值的类型只可能是"Aaa"或"Ccc")
export function selectByBitwiseSum1<T extends number>(bitwiseSum: T): GetMatchedVals<T> { // 运行时取第一个匹配项,也可以按需自定义返回规则 const matched = selectByBitwiseSum2(bitwiseSum); return matched[0] as GetMatchedVals<T>; }
调用测试:
// 传入字面量5时,返回类型自动推导为 "Aaa" | "Ccc",符合预期 const result = selectByBitwiseSum1(5);
场景2:返回数组,类型自动收窄为匹配项的联合数组
如果你的实际需求是返回数组,且类型自动收窄为仅匹配到的字面量联合(比如传入5时返回类型为("Aaa"|"Ccc")[]),可以在上述泛型基础上调整返回类型:
export function selectByBitwiseSum2Typed<T extends number>(bitwiseSum: T): GetMatchedVals<T>[] { const result = [] as GetMatchedVals<T>[]; for (const item of optMap) { if (bitwiseSum & item.key) { result.push(item.val as GetMatchedVals<T>); } } return result; }
调用测试:
// 运行时值为 ["Aaa", "Ccc"],类型为 ("Aaa" | "Ccc")[],完全符合你的注释预期 const result = selectByBitwiseSum2Typed(5);
避坑要点
- 不要直接写普通数组字面量,必须加
as const或者显式标注val的类型为字面量,否则会被TS自动放宽为string - 运行时多值必须用数组承载,联合类型仅用于编译期类型约束
- 如果需要类型自动推导,必须给函数加泛型,让传入的位和保留字面量类型,否则TS会把
bitwiseSum推断为普通number,无法收窄返回类型
内容的提问来源于stack exchange,提问作者Felix
相关产品推荐
相关产品推荐

