如何在TypeScript中用普通string调用接受字符串字面量联合类型的方法？

问题背景 #

第三方库提供的函数声明如下：

function printText(s: string, alignment: "left" | "right" | "center") {
  // ...
}

我们从外部传入或JSON配置中获取的printerConfig对象，其textAlignment属性类型为string，无法直接传递给printText的alignment参数，需要解决类型适配问题。

可行方案 #

1. 运行时校验 + 类型断言 #

由于外部传入的string值不可控，必须先校验其是否属于允许的字面量集合，再通过类型断言让TypeScript认可该值的类型：

// 定义合法的对齐方式集合
const validAlignments = new Set(["left", "right", "center"]);

// 校验后调用函数
if (validAlignments.has(printerConfig.textAlignment)) {
  printText("Test", printerConfig.textAlignment as "left" | "right" | "center");
} else {
  // 处理无效值，示例为抛出错误，也可替换为使用默认值等逻辑
  throw new Error(`无效的对齐方式：${printerConfig.textAlignment}`);
}

2. 自定义类型守卫函数 #

将校验逻辑封装为类型守卫，让代码更具可读性和复用性，TypeScript会自动识别通过校验后的值类型：

// 类型守卫函数：判断值是否为合法对齐方式
function isValidAlignment(value: string): value is "left" | "right" | "center" {
  return ["left", "right", "center"].includes(value);
}

// 使用类型守卫调用函数
if (isValidAlignment(printerConfig.textAlignment)) {
  printText("Test", printerConfig.textAlignment);
} else {
  console.error(`不支持的对齐方式：${printerConfig.textAlignment}`);
}

3. 直接类型断言（不推荐） #

如果能100%确认外部传入的textAlignment一定是合法值，可直接使用类型断言跳过检查，但这种方式会丢失运行时安全校验，仅适用于绝对可信的数据源：

printText("Test", printerConfig.textAlignment as "left" | "right" | "center");

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