0

0

javascript Fetch API是什么_它与XMLHttpRequest有何不同?

狼影

狼影

发布时间:2025-12-30 16:07:02

|

705人浏览过

|

来源于php中文网

原创

fetch api 是浏览器原生网络请求接口,基于 promise 设计,不自动处理 http 错误;4xx/5xx 状态码不会触发 reject,需手动检查 response.ok 或 status。

javascript fetch api是什么_它与xmlhttprequest有何不同?

Fetch API 是浏览器原生提供的、用于发起网络请求的现代 JavaScript 接口;它不是 XMLHttpRequest 的升级版,而是设计哲学完全不同的替代方案——默认基于 Promise,不自动处理 HTTP 错误状态码,也不共享 cookie(除非显式配置)。

Fetch 默认不把 4xx/5xx 当作 reject

这是最常踩的坑:用 fetch() 请求一个返回 404 的 URL,then() 依然会执行,因为只要网络层通了、响应头收到了,Promise 就算 fulfilled。你得手动检查 response.okresponse.status

fetch('/api/user/999')
  .then(response => {
    if (!response.ok) {
      throw new Error(`HTTP error: ${response.status}`);
    }
    return response.json();
  })
  .catch(err => console.error(err));
  • response.ok 等价于 response.status >= 200 && response.status
  • XMLHttpRequest 在 4xx/5xx 时不会触发 onerror,但会进 onload,同样需要手动判断 status
  • 区别在于:Fetch 把“网络失败”和“HTTP 错误”明确区分开,前者 reject,后者 resolve

Fetch 不支持 progress 事件,也无法中止正在传输的 body

上传大文件或需要实时显示下载进度时,XMLHttpRequestupload.onprogressdownload.onprogress 仍是不可替代的。Fetch 没有等效机制;虽可用 AbortController 中止整个请求,但无法在流式读取过程中暂停或监听已接收字节数。

Video Ocean
Video Ocean

人人皆导演,让视频创作变得轻松自如

下载
  • fetch() 支持 signal 参数配合 AbortController 实现超时或取消,但仅作用于请求发起阶段或未开始读取时
  • 要监听进度,必须退回到 XMLHttpRequest,或用 ReadableStream + tee() 自行分块读取(复杂且不兼容旧浏览器)
  • 服务端流式响应(如 SSE、text/event-stream)可配合 response.body.getReader() 逐段处理,但无内置进度百分比

Fetch 的 credentials 行为默认更严格

默认情况下,fetch() 不发送 cookies,也不携带认证头(如 Authorization),即使目标域名与当前页面同源。这和 XMLHttpRequest 的默认行为一致,但开发者常常忽略这点,导致登录态丢失。

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

fetch('/api/profile', {
  credentials: 'include' // 必须显式声明
});
  • credentials: 'include':发送 cookies 和认证头(需服务端设置 Access-Control-Allow-Credentials: true
  • credentials: 'same-origin':默认值,只在同源时发(但很多人误以为是“自动同源”)
  • credentials: 'omit':从不发送(类似 XMLHttpRequest.withCredentials = false
  • XMLHttpRequestwithCredentials 默认为 false,行为其实一致,只是 Fetch 的默认值名更易误导

真正难处理的不是语法差异,而是 Fetch 把错误分类、凭据策略、流控制这些原本隐含在 XHR 里的行为全部暴露成显式配置项——写对容易,写全、写稳、覆盖边界场景,反而更费神。

热门AI工具

更多
DeepSeek
DeepSeek

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

豆包大模型
豆包大模型

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

通义千问
通义千问

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

腾讯元宝
腾讯元宝

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

文心一言
文心一言

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

讯飞写作
讯飞写作

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

即梦AI
即梦AI

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

ChatGPT
ChatGPT

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

相关专题

更多
cookie
cookie

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

6500

2023.06.30

document.cookie获取不到怎么解决
document.cookie获取不到怎么解决

document.cookie获取不到的解决办法:1、浏览器的隐私设置;2、Same-origin policy;3、HTTPOnly Cookie;4、JavaScript代码错误;5、Cookie不存在或过期等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

368

2023.11.23

阻止所有cookie什么意思
阻止所有cookie什么意思

阻止所有cookie意味着在浏览器中禁止接受和存储网站发送的cookie。阻止所有cookie可能会影响许多网站的使用体验,因为许多网站使用cookie来提供个性化服务、存储用户信息或跟踪用户行为。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

445

2024.02.23

cookie与session的区别
cookie与session的区别

本专题整合了cookie与session的区别和使用方法等相关内容,阅读专题下面的文章了解更详细的内容。

97

2025.08.19

硬盘接口类型介绍
硬盘接口类型介绍

硬盘接口类型有IDE、SATA、SCSI、Fibre Channel、USB、eSATA、mSATA、PCIe等等。详细介绍:1、IDE接口是一种并行接口,主要用于连接硬盘和光驱等设备,它主要有两种类型:ATA和ATAPI,IDE接口已经逐渐被SATA接口;2、SATA接口是一种串行接口,相较于IDE接口,它具有更高的传输速度、更低的功耗和更小的体积;3、SCSI接口等等。

1902

2023.10.19

PHP接口编写教程
PHP接口编写教程

本专题整合了PHP接口编写教程,阅读专题下面的文章了解更多详细内容。

656

2025.10.17

php8.4实现接口限流的教程
php8.4实现接口限流的教程

PHP8.4本身不内置限流功能,需借助Redis(令牌桶)或Swoole(漏桶)实现;文件锁因I/O瓶颈、无跨机共享、秒级精度等缺陷不适用高并发场景。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2387

2025.12.29

java接口相关教程
java接口相关教程

本专题整合了java接口相关内容,阅读专题下面的文章了解更多详细内容。

47

2026.01.19

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

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

3

2026.03.11

热门下载

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

精品课程

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

共58课时 | 5.9万人学习

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号