扩展node:http2 IncomingHttpHeaders后TypeScript报对象未定义如何解决？

针对你遇到的问题，核心原因是IncomingHttpHeaders的内置类型特性与自定义接口的定义存在冲突，导致TypeScript对headers对象的类型推断出现异常。以下是几种可行的解决方法：

1. 移除重复的索引签名 #

CustomHeaders继承自IncomingHttpHeaders，而后者已经内置了[key: string]: string | string[] | undefined的索引签名，重复定义会引发类型推断混乱。直接继承即可：

// types.d.ts
import type { IncomingHttpHeaders } from "node:http2";

export interface CustomHeaders extends IncomingHttpHeaders {}

export type Result = {
  request: {},
  response: {
    headers: CustomHeaders;
  }
};

2. 显式断言headers非空 #

如果你能确保result.response.headers在运行时一定存在，可以使用非空断言!跳过TypeScript的严格检查：

// do-something.ts
function doSomething(result: Result): Promise<Result> {
  result.response.headers!["x-custom-header"] = "custom_value";
  return Promise.resolve(result);
}

3. 添加非空检查（更严谨） #

即使类型定义中标记为必选，也可以添加运行时检查来避免潜在的异常：

function doSomething(result: Result): Promise<Result> {
  if (result.response.headers) {
    result.response.headers["x-custom-header"] = "custom_value";
  }
  return Promise.resolve(result);
}

4. 重新定义非可选索引签名（特定场景适用） #

如果你的业务场景中所有请求头都必须存在，可以修改索引签名为非可选，但这不符合HTTP头的通用特性，仅适用于特殊需求：

// types.d.ts
import type { IncomingHttpHeaders } from "node:http2";

export interface CustomHeaders extends IncomingHttpHeaders {
  [key: string]: string | string[];
}

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