TypeScript 如何校验普通函数符合指定函数接口签名
核心结论
TS 原生确实没有类上面那种implements可以直接加在普通函数声明上的语法——这个语法目前只对类和类成员开放。但完全可以通过几行零运行时开销的类型校验代码,实现你要的效果:不用把函数声明挪到调用前面,就能在函数定义的源位置触发类型不匹配的报错,不用等到传参的时候才在调用点被TS打回。
具体实现方式
兼容所有TS版本的写法
不用改你原来的函数声明位置,只需要在函数定义的旁边加一行临时的类型匹配代码就行:
export function setup(){ const browserEvents = new BrowserEvents(); browserEvents.onClicks(handleClicks); function handleClicks(ev: Event) { ev.preventDefault(); } // 新增的校验代码,编译后直接消失,没有运行时负担 const _checkHandler: eventHandler = handleClicks; }
只要handleClicks的签名和eventHandler对不上,TS的报错就会直接出现在这行校验代码上,离函数定义只有一行距离,根本不会把错误抛到几十行外的onClicks调用位置。
这种写法完全保留了JS函数声明的提升特性,你想把函数写在调用后面就写在后面,不用像const函数表达式那样必须把声明挪到最前面。
TS 4.9以上版本的更优写法
如果你用的TS版本支持satisfies运算符,比刚才的临时变量写法更顺手:
export function setup(){ const browserEvents = new BrowserEvents(); browserEvents.onClicks(handleClicks); function handleClicks(ev: Event) { ev.preventDefault(); } // 直接做严格校验,不会生成临时变量 handleClicks satisfies eventHandler; }
satisfies的好处是校验更严格:不会像直接赋值那样给原函数做隐式的类型收窄,能精准识别出参数、返回值上的签名不匹配问题,也不会改变原函数的类型推导结果。
容易踩的小坑
- 上面的所有校验代码都只会在编译阶段生效,打包后完全会被擦除,不会增加任何运行时体积。
- 如果你需要完全严格的签名匹配,记得在
tsconfig里开strictFunctionTypes配置,不然TS的结构类型规则会允许你写参数更宽松、返回值更窄的函数“蒙混过关”。
内容的提问来源于stack exchange,提问作者Uri Kutner
相关产品推荐
相关产品推荐

