Node.js构建嵌套JSON映射技巧

本文深入解析了在 Node.js 中如何正确处理嵌套 JSON 响应（如 `{ code: 200, data: { "28338": { "high": 696000000, ... }, ... } }`），精准提取每个商品 ID 对应的 `high` 价格并构建高效键值映射，彻底避开因误读响应结构（如直接遍历根对象而非 `response.data`）导致的 `undefined` 陷阱；文内提供健壮、可扩展的实战代码——含错误防护、可选链容错、性能优化建议及 TypeScript 类型提示，助你稳定支撑万级数据的批量数据库更新等关键场景。

本文详解如何从结构为 { "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 = ?）提供可靠数据基础。

理论要掌握，实操不能落！以上关于《Node.js构建嵌套JSON映射技巧》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！