TypeScript定义Chain类型时元组末位Handler无法正确推断类型如何解决
问题背景
正在为已有的http handler库编写类型定义,无法修改原有API。
相关初始类型定义如下:
// Callback function passed to handlers & middleware. type NextFn<Res> = (err?: Error|null, res?: Res) => void; // Note: the res parameter is always null. type Middleware<Req, Res> = (req: Req, res: Res, next: NextFn<Res>) => void; // A function called after all the middleware. type Handler<Req, Res> = (req: Req, next: NextFn<Res>) => void; // A chain a set of middleware functions with a handler function at the end. type Chain<Req, Res> = [...Middleware<Req, Res>[], Handler<Req, Res>]; const chain: Chain<any, any> = [ // middleware (req, _, next) => {}, // middleware (req, _, next) => {}, // handler: why am I getting no-explit-any errors here? (req, next) => {} ];
定义的Chain类型要求为若干个Middleware加末尾一个Handler组成的元组,但在声明Chain类型变量时,末尾的Handler元素总是报no-explicit-any错误,TypeScript无法正确推断Handler的参数类型。
已尝试将Chain的展开语法替换为固定长度的重载联合类型,依然没有生效:
type Chain<Req, Res> = [Handler<Req, Res>] | [Middleware<Req, Res>, Handler<Req, Res>] | [Middleware<Req, Res>, Middleware<Req, Res>, Handler<Req, Res>];
问题原因
- TypeScript对数组字面量的类型推断优先级是先尝试统一所有元素的类型,再匹配元组约束。当你直接声明变量为
Chain<Req, Res>类型时,TS会把数组内的所有元素都尝试匹配Middleware | Handler联合类型,不会自动把最后一个元素单独匹配Handler类型。 - Middleware接收3个参数,Handler接收2个参数,TS在推断末尾函数的参数时,会优先尝试适配Middleware的参数结构,导致第二个参数
next的类型无法被正确识别,最终推断为any触发规则报错。 - 直接给泛型参数传入
any也会弱化TS的类型推断能力,进一步收窄不了参数类型。
解决方案
最简便的方式是通过构造函数工具来创建Chain实例,利用TS对函数剩余参数的元组推断能力,自动区分前置中间件和末尾的Handler:
// 新增Chain构造工具函数 function createChain<Req, Res, T extends Middleware<Req, Res>[]>( ...args: [...T, Handler<Req, Res>] ): [...T, Handler<Req, Res>] { return args; } // 用法 const chain = createChain<any, any>( // 中间件参数会被自动推断,无需手动标注 (req, _, next) => {}, (req, _, next) => {}, // Handler参数会被自动识别,不会触发no-explicit-any错误 (req, next) => {} );
如果不想引入工具函数,也可以直接显式标注末尾Handler的类型:
const chain: Chain<any, any> = [ (req, _, next) => {}, (req, _, next) => {}, // 显式标注为Handler类型即可 ((req, next) => {}) as Handler<any, any> ];
内容的提问来源于stack exchange,提问作者Ilia Choly
相关产品推荐
相关产品推荐

