如何正确使用 Fetch API 动态填充下拉菜单(Dropdown)

18次阅读

如何正确使用 Fetch API 动态填充下拉菜单(Dropdown)

本文详解如何通过 javascript 的 `fetch()` 正确读取本地 json 文件并动态生成 `

在构建基于静态文件的轻量级管理界面(如 Wi-Fi 密码更新页)时,常需从本地 JSON 文件(如 data/data.json)动态加载选项到

✅ 正确实现:使用 async/await + 单次 DOM 加载监听

原始代码存在多个隐患:

  • 重复注册 DOMContentLoaded 监听器(可能导致函数执行多次或冲突);
  • .then().then().catch() 链中未正确处理 Promise 拒绝(如网络失败、JSON 解析错误);
  • fetch() 返回的 Response 对象需显式调用 .json() 才能解析为 JS 对象,且该方法本身也返回 Promise——必须 await 或链式 .then(),否则 roomsData 将是未解析的 Promise 实例,导致 forEach 报错(TypeError: roomsData.forEach is not a function)。

以下是修复后的 推荐写法(简洁、健壮、可维护):

   Select your room:            
// ✅ 推荐:使用 async/await + 单次事件监听 document.addEventListener('DOMContentLoaded', loadRoomNumbers);  async function loadRoomNumbers() {   const roomSelect = document.getElementById('room');    try {const response = await fetch('data/data.json');      if (!response.ok) {throw new Error(`HTTP error! Status: ${response.status}`);     }      const roomsData = await response.json(); // ✅ 关键:await 确保解析完成      // 清空默认提示项以外的选项(可选,提升容错性)roomSelect.innerHTML = '';      roomsData.forEach(roomData => {const option = document.createElement('option');       option.value = roomData.Room;       option.textContent = roomData.Room;       roomSelect.appendChild(option);     });    } catch (error) {console.error('❌ Failed to load room data:', error.message);     // 可选:向用户展示友好提示     roomSelect.innerHTML ='';   } }

⚠️ 注意事项与调试建议

  • 路径验证 :确保 data/data.json 路径正确(区分大小写,检查服务器是否允许跨源或直接访问 .json 文件)。可在 浏览器 开发者 工具 的 Network 标签中查看请求是否返回 200 OK 及响应体是否为合法 JSON。
  • CORS 限制 :若直接双击 HTML 文件打开(file:// 协议),现代浏览器会因安全策略阻止 fetch() 读取本地文件。 务必通过本地服务器运行(如 VS Code 的 Live Server 插件、npx serve 或 Python 的 python -m http.server)。
  • JSON 格式校验:确认 data.json 是严格有效的 JSON(字段名需双引号包裹,无尾逗号,无注释)。
  • DOM 元素存在性:getElementById(‘room’) 返回 null 时说明元素未加载或 ID 不匹配,请检查 HTML 是否已渲染且 ID 拼写一致。

✅ 总结

下拉菜单无选项的核心原因通常是:JSON 数据未成功解析为数组,或解析后未正确遍历注入 DOM。通过统一使用 async/await、添加完整的错误处理、避免重复监听,并配合本地 HTTP 服务调试,即可稳定实现 JSON 驱动的动态表单选项。此模式同样适用于加载设备列表、楼层信息、用户配置等场景。

text=ZqhQzanResources