TypeScript动态调用导入方法的实现方案及编译报错解决

核心需求 #

无需通过硬编码switch分支逐一定义方法映射，实现根据传入的方法名字符串，从导入的模块中动态获取并调用对应方法，目标实现逻辑参考：

import * as mathFn from './formula/math';

export function loadMethod(fnName: string, params: string){
   mathFn[fnName](params); 
}

前期尝试与遇到的问题 #

• 最初尝试通过类型约束限定允许传入的方法名范围，写法如下，但始终无法正常运行：

type SupportedMathFunction = keyof typeof mathFn;

export function loadMethod(fnName: SupportedMathFunction, params: string){
       mathFn[fnName](params); 
}

• 在VSCode终端通过ts-node编译运行TypeScript代码时，遇到如下语法解析报错：

SyntaxError: Unexpected token '?'
at wrapSafe (internal/modules/cjs/loader.js:1047:16)
at Module._compile (internal/modules/cjs/loader.js:1097:27)
at Module.m._compile (...\node_modules\ts-node\src\index.ts:1043:23)
at Module._extensions..js (internal/modules/cjs/loader.js:1153:10)
at Object.require.extensions.<computed> [as .ts] (...\node_modules\ts-node\src\index.ts:1046:12)
at Module.load (internal/modules/cjs/loader.js:977:32)
at Function.Module._load (internal/modules/cjs_helpers.js:77:18)
at Object.<anonymous> (...\src\functions.ts:11:1)

问题解决路径 #

• 上述语法报错的本质是运行环境版本不兼容：旧版本Node.js无法识别可选链这类较新的ECMAScript语法，因此触发"Unexpected token '?'"的解析异常
• 实际验证可落地的操作步骤：
  • 将Node.js从12.16.3版本升级至14.15.5稳定版，执行npm update同步更新项目依赖，原语法报错不再出现
  • 后续运行时出现jasmine相关报错时，将ts-node降级至8.10.2版本调整配置后，代码可正常运行

验证通过的实现方案 #

两种写法均可实现无硬编码的动态方法调用能力：

• 基础类型约束写法

type SupportedMathFunction = keyof typeof mathFn;

export function loadMethod(fnName: SupportedMathFunction, params: string){
   mathFn[fnName](params); 
}

该写法可在编译阶段拦截非法的方法名输入，从源头避免运行时出现方法不存在的异常。

• 泛型优化写法
  由社区贡献者@Lesiak提供，相比基础写法类型提示更灵活：

function loadMethod<K extends keyof typeof mathFn>(fnName: K ): typeof mathFn[K]{
  return mathFn[fnName]; 
}

该写法通过泛型自动匹配返回值类型，当调用方需要获取方法引用做后续复用时，无需手动做类型断言即可获得完整的类型提示。

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