如何在 Node.js 中高效构建 JSON 响应中嵌套字段的键值映射

本文详解如何从结构为 { “28338”: { “high”: 696000000, … }, … } 的 API 响应中，精准提取每个顶层键对应的 high 值，生成 map 或普通对象映射，解决因忽略响应嵌套层级（如 data 字段）导致的 undefined 问题。

本文详解如何从结构为 {“28338”: {“high”: 696000000, …}, …} 的 api 响应中，精准提取每个顶层键对应的 high 值，生成 map 或普通对象映射，解决因忽略响应嵌套层级（如 data 字段）导致的 undefined 问题。

在 node.js 中处理大型 jsON 响应时，常见误区是直接对整个响应体调用 Object.keys() 或 Object.entries()，而忽略了真实数据实际位于响应的某个子属性下（例如 response.data）。你遇到的 myList 输出为 { data: undefined }，根本原因正是：API 返回的 json 并非扁平对象，而是形如 { code: 200, data: { “28338”: { high: …, low: … }, … } } 的结构。因此，jsonResponse 本身不含 “28338” 这样的键，jsonResponse.data 才是目标数据源。

以下是推荐的健壮实现方案：

✅ 正确解析与映射（使用 Object.fromEntries + 解构）

async function fetchItemHighPrices() {   const url = 'https://prices.runescape.wiki/api/v1/osrs/latest';    try {     const response = await fetch(url);     if (!response.ok) {       throw new Error(`HTTP error! status: ${response.status}`);     }      const jsonResponse = await response.json();      // 关键修正：访问 jsonResponse.data 而非 jsonResponse     if (!jsonResponse.data || typeof jsonResponse.data !== 'object') {       throw new Error('Invalid API response: missing or invalid "data" field');     }      // 构建 { "28338": 696000000, "28337": ..., ... } 映射     const priceMap = Object.fromEntries(       Object.entries(jsonResponse.data).map(([itemId, itemData]) => [         itemId,         itemData.high // 安全访问：若需容错可写 itemData?.high ?? null       ])     );      return priceMap;   } catch (error) {     console.error('Failed to fetch or parse prices:', error);     throw error;   } }  // 使用示例 (async () => {   try {     const highPrices = await fetchItemHighPrices();     console.log(`Mapped ${Object.keys(highPrices).length} items`);     // 示例输出: { "28338": 696000000, "28337": 521000000, ... }      // 后续可用于批量更新 SQLite     // for (const [itemId, highPrice] of Object.entries(highPrices)) {     //   await db.run('UPDATE items SET itemValue = ? WHERE itemID = ?', highPrice, itemId);     // }   } catch (err) {     console.error(err);   } })();

? 关键要点说明

• 层级意识：始终检查 API 文档或 console.log(jsonResponse) 确认数据所在路径（本例为 jsonResponse.data）；
• 性能考量：Object.fromEntries() + map() 比 reduce() 更语义清晰且性能相当，适用于 28,000+ 条目；
• 错误防御：
  • 检查 HTTP 状态码；
  • 验证 jsonResponse.data 是否存在且为对象；
  • 对 itemData.high 使用可选链 itemData?.high 可进一步避免运行时错误（若部分条目缺失 high 字段）；
• 类型安全（typescript 提示）：

  interface ItemData { high: number; low: number; highTime: number; lowTime: number; } type PriceMap = Record<String, number>;

? 为什么你原来的代码返回 { data: undefined }？

因为 return Object.keys(jsonResponse).reduce(…) 实际遍历的是 jsonResponse 的顶层键（如 “code”、”data”、”timestamp”），而 jsonResponse[“data”] 是一个对象，其自身键才是 “28338”。你试图对 jsonResponse（而非 jsonResponse.data）做映射，自然无法得到预期结果。

掌握这一层级访问逻辑，即可稳定构建大规模键值映射，为后续数据库批量操作（如 UPDATE items SET itemValue = ? WHERE itemID = ?）提供可靠数据基础。