javascript如何与apis交互_处理json数据的最佳实践是什么

15次阅读

fetch 交互需先检查 response.ok 再 await response.json(),否则易解析错误页或空响应;须校验数据结构、深拷贝防篡改、区分错误类型并提供 fallback。

javascript如何与apis交互_处理json数据的最佳实践是什么

javaScript 与 API 交互的核心是 fetch,但“能发请求”不等于“处理 json 安全可靠”——常见错误不是收不到数据,而是没检查 response.ok、没处理 response.status、或直接 .json() 后忽略 promise 拒绝。

fetch 发请求前必须检查 response.ok

fetch 只在网络失败时 reject(比如断网、dns 错误),而 http 404、500、401 等状态码仍会 resolve。若跳过 response.ok 判断,后续 .json() 会尝试解析空响应体或 html 错误页,抛出 Unexpected Token 这类误导性错误。

实操建议:

  • 始终在 await response.json() 前加 if (!response.ok) throw new Error(`${response.status} ${response.statusText}`)
  • 不要只靠 try/catch 捕获 .json(),它解决不了语义错误(比如后端返回 {error: "not found"}状态码是 200)
  • 对关键业务接口,额外校验响应体结构,例如 if (typeof data !== 'Object' || data === NULL || !('id' in data)) throw new TypeError('Invalid user object')

async/await 下正确链式处理 JSON 响应

.json() 当作独立异步步骤,而不是跟在 fetch() 后面无脑 .then()。否则容易写出嵌套 Promise 或忘记 await。

立即学习Java免费学习笔记(深入)”;

async function getUser(id) {   const response = await fetch(`/api/users/${id}`);   if (!response.ok) throw new Error(`HTTP ${response.status}`);    const data = await response.json(); // ← 必须 await,.json() 返回 Promise   if (!data?.name) throw new TypeError('User name missing');    return data; }

常见错误写法:

  • const data = response.json();(没 await,data 是 Promise 对象
  • return fetch(...).then(r => r.json())(外层函数没声明 async,返回的是 Promise 而非数据)
  • .catch() 里吞掉所有错误却不 re-throw 或转为业务错误类型

避免重复解析或意外修改原始 JSON 数据

response.json() 得到的对象是可变的普通 JS 对象。如果后续代码不小心修改了它(比如 user.name = 'test'),会影响其他引用该对象的逻辑,尤其在 react/vue 的响应式系统中可能引发难以追踪的副作用。

实操建议:

  • 需要修改时,用 structuredClone(data)(现代浏览器支持)或 JSON.parse(JSON.stringify(data))(兼容旧环境,但不支持函数、undefineddate 等)做深拷贝
  • 对只读场景,用 Object.freeze(data) 防止意外赋值(注意:只冻结第一层)
  • 不要把 response.json() 结果直接传给第三方库(如某些图表库)而不确认其是否修改入参

错误边界和 fallback 数据要明确区分网络错误、HTTP 错误、解析错误

用户看到“加载失败”,你得知道到底是 DNS 解析失败(TypeError: Failed to fetch)、后端挂了(503 Service Unavailable),还是返回了非法 JSON(SyntaxError: Unexpected token)。每种错误的恢复策略不同。

实操建议:

  • instanceof 区分错误类型:err instanceof TypeError(网络层) vs err.message.includes('HTTP')(业务层)
  • 对 401/403,触发登录态刷新;对 429,加退避重试;对 5xx,显示“服务暂时不可用”并禁用重试按钮
  • 提供有意义的 fallback:空数组、默认对象,而不是 nullundefined,避免下游组件反复做空值检查

真正难的不是调通接口,而是让每次 fetch 都带着明确的契约意识:我期望什么状态?接受什么数据形状?遇到哪些错误必须中断流程?这些判断点一旦漏掉一个,就可能让 bug 潜伏数周才暴露。

text=ZqhQzanResources