如何在TypeScript中泛型声明返回解析为对象数组的Promise的函数？

我来帮你搞定这个TypeScript类型问题！你想要的是一个能灵活返回不同结构对象数组的Promise函数，同时让TS能准确识别数组类型，这样forEach这类操作就不会报错了对吧？

核心方案：使用泛型函数定义 #

最适合你的场景是用**泛型（Generics）**来定义OpenJSON函数，这样它就能适配任意你需要的对象类型，而不用写死固定结构。具体写法如下：

function OpenJSON<T>(): Promise<T[]> {
  // 这里是你的异步逻辑，比如读取文件、解析JSON
  return new Promise((resolve) => {
    // 示例：模拟从文件读取并解析JSON
    const mockData = [
      { id: "1", performance: 90, average: 85 },
      { id: "2", performance: 80, average: 75 }
    ];
    resolve(mockData as T[]); // 用类型断言告诉TS解析后的数据是T[]类型
  });
}

怎么调用这个泛型函数？ #

调用时你只需要传入具体的对象类型（可以是接口、类型别名或者匿名类型），TypeScript就会自动推断出返回的Promise解析后是该类型的数组：

方式1：使用接口复用类型

如果某个对象结构会多次使用，先定义接口：

interface PerformanceRecord {
  id: string;
  performance: number;
  average: number;
}

// 调用函数
async function fetchData() {
  const records = await OpenJSON<PerformanceRecord>();
  // 现在TS明确知道records是PerformanceRecord[]，forEach不会报错
  records.forEach(record => {
    console.log(record.id, record.performance);
  });
}

方式2：直接传入匿名类型

如果只是临时使用某个结构，可以直接在调用时指定匿名类型：

async function fetchUserList() {
  const users = await OpenJSON<{ id: number; name: string; email: string }>();
  users.forEach(user => {
    console.log(user.name); // TS能识别user的属性，不会报错
  });
}

为什么这个方案能解决你的问题？ #

• 泛型T让函数具备了灵活性，未来不管你需要返回什么结构的对象数组，只需要在调用时传入对应的类型即可，不用修改函数本身。
• 明确指定Promise<T[]>后，TypeScript知道解析后的结果是该类型的数组，自然就能正确识别forEach、map等数组方法的参数类型，消除之前的错误提示。

补充：处理JSON.parse的类型问题 #

如果你的函数内部是用JSON.parse解析文件内容，记得用类型断言告诉TypeScript解析后的结果是T[]，因为JSON.parse默认返回any类型：

import fs from 'fs/promises';

async function OpenJSON<T>(): Promise<T[]> {
  const fileContent = await fs.readFile('./data.json', 'utf8');
  return JSON.parse(fileContent) as T[]; // 这里的类型断言是关键
}

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