You need to enable JavaScript to run this app. TypeScript/JavaScript 如何按位和值选取字符串字面量并兼容指定类型
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.10 17:15:03