0

0

javascript如何与后端API通信?【教程】

狼影

狼影

发布时间:2026-01-22 17:19:10

|

536人浏览过

|

来源于php中文网

原创

fetch发get请求最直接:返回promise支持async/await,需手动检查res.ok或status处理404/500;带参用urlsearchparams;跨域依赖后端cors配置;post需设content-type;错误处理须兼顾网络异常与业务错误。

javascript如何与后端api通信?【教程】

fetch 发 GET 请求最直接

浏览器环境里,fetch 是当前最常用、也最轻量的通信方式。它返回 Promise,天然支持 async/await,不用额外引入库。

常见错误是忽略网络失败和 HTTP 状态码异常——fetch 只在真正“请求没发出去”(如断网、DNS 失败)时 reject,而 404、500 这类响应仍会 resolve,必须手动检查 response.okresponse.status

  • GET 请求示例:
    const res = await fetch('/api/users');<br>if (!res.ok) throw new Error(`HTTP ${res.status}`);<br>const data = await res.json();
  • 带查询参数建议用 URLSearchParams 构造,避免拼接出错:
    const params = new URLSearchParams({ page: '1', limit: '10' });<br>await fetch(`/api/posts?${params}`);
  • 默认不带 Cookie,如需携带登录态,得显式加 credentials: 'include'

POST 提交 JSON 数据要设好 Content-Type

后端通常依赖 Content-Type: application/json 来解析请求体。漏掉这个 header 是 400 错误的高频原因,尤其用 Express、FastAPI 等框架时。

ColorMagic
ColorMagic

AI调色板生成工具

下载
  • 正确写法:
    await fetch('/api/login', {<br>  method: 'POST',<br>  headers: { 'Content-Type': 'application/json' },<br>  body: JSON.stringify({ email: 'a@b.c', password: '123' })<br>});
  • 如果后端接收的是表单数据(application/x-www-form-urlencoded),就别用 JSON.stringify,改用 new URLSearchParams(formObj)
  • 注意:body 必须是字符串、Blob、FormData 等可读流类型,不能直接传对象

跨域问题不是前端能绕开的

当域名、协议或端口不一致时,浏览器会拦截响应(即使后端已返回数据)。这不是 fetch 的限制,而是 CORS 安全机制。

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

  • 前端唯一可控的是加 mode: 'cors'(默认值),但关键在后端是否返回了合法的 Access-Control-Allow-Origin
  • 开发时本地启了 localhost:3000,后端在 localhost:8000,必须让后端允许该源,例如返回 Access-Control-Allow-Origin: http://localhost:3000
  • 若需带认证(如 Cookie、Authorization header),后端还必须设置 Access-Control-Allow-Credentials: true,且此时 Access-Control-Allow-Origin 不能为 *

错误处理别只靠 try/catch

try/catch 只能捕获 fetch 抛出的网络异常,抓不到 4xx/5xx 响应。真实项目里,业务错误(如登录失败、权限不足)几乎都藏在响应体里。

  • 建议封装一层请求函数,统一处理状态码和常见错误结构:
    async function request(url, options = {}) {<br>  const res = await fetch(url, options);<br>  if (!res.ok) {<br>    const err = await res.json();<br>    throw new Error(err.message || `HTTP ${res.status}`);<br>  }<br>  return res.json();<br>}
  • 后端返回格式不一致时(比如有时是 { code: 0, data: ... },有时是裸对象),前端解析逻辑容易崩,最好在封装层做归一化
  • 超时控制原生 fetch 不支持,需用 AbortController 配合 signal 选项
实际用起来,最难的往往不是发请求,而是对每个接口的响应结构、错误字段、认证方式、缓存策略做准确适配。这些细节不会写在文档里,得靠调试时多看 Network 面板里的 Response 和 Headers。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

455

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

546

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

334

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

82

2025.09.10

Node.js后端开发与Express框架实践
Node.js后端开发与Express框架实践

本专题针对初中级 Node.js 开发者,系统讲解如何使用 Express 框架搭建高性能后端服务。内容包括路由设计、中间件开发、数据库集成、API 安全与异常处理,以及 RESTful API 的设计与优化。通过实际项目演示,帮助开发者快速掌握 Node.js 后端开发流程。

416

2026.02.10

Python FastAPI异步API开发_Python怎么用FastAPI构建异步API
Python FastAPI异步API开发_Python怎么用FastAPI构建异步API

Python FastAPI 异步开发利用 async/await 关键字,通过定义异步视图函数、使用异步数据库库 (如 databases)、异步 HTTP 客户端 (如 httpx),并结合后台任务队列(如 Celery)和异步依赖项,实现高效的 I/O 密集型 API,显著提升吞吐量和响应速度,尤其适用于处理数据库查询、网络请求等耗时操作,无需阻塞主线程。

28

2025.12.22

Python 微服务架构与 FastAPI 框架
Python 微服务架构与 FastAPI 框架

本专题系统讲解 Python 微服务架构设计与 FastAPI 框架应用,涵盖 FastAPI 的快速开发、路由与依赖注入、数据模型验证、API 文档自动生成、OAuth2 与 JWT 身份验证、异步支持、部署与扩展等。通过实际案例,帮助学习者掌握 使用 FastAPI 构建高效、可扩展的微服务应用,提高服务响应速度与系统可维护性。

251

2026.02.06

cookie
cookie

Cookie 是一种在用户计算机上存储小型文本文件的技术,用于在用户与网站进行交互时收集和存储有关用户的信息。当用户访问一个网站时,网站会将一个包含特定信息的 Cookie 文件发送到用户的浏览器,浏览器会将该 Cookie 存储在用户的计算机上。之后,当用户再次访问该网站时,浏览器会向服务器发送 Cookie,服务器可以根据 Cookie 中的信息来识别用户、跟踪用户行为等。

6500

2023.06.30

C# ASP.NET Core微服务架构与API网关实践
C# ASP.NET Core微服务架构与API网关实践

本专题围绕 C# 在现代后端架构中的微服务实践展开,系统讲解基于 ASP.NET Core 构建可扩展服务体系的核心方法。内容涵盖服务拆分策略、RESTful API 设计、服务间通信、API 网关统一入口管理以及服务治理机制。通过真实项目案例,帮助开发者掌握构建高可用微服务系统的关键技术,提高系统的可扩展性与维护效率。

3

2026.03.11

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
React 教程
React 教程

共58课时 | 6万人学习

TypeScript 教程
TypeScript 教程

共19课时 | 3.4万人学习

Bootstrap 5教程
Bootstrap 5教程

共46课时 | 3.6万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号