fetch 是 Promise 驱动,XMLHttpRequest 是事件回调驱动;前者默认不带 Cookie、无上传进度支持、需 AbortController 取消,后者默认发 Cookie、支持 upload.onprogress、直接 abort() 且兼容性更强。
这是最根本的差异:调用 fetch() 立即返回一个 Promise,你用 .then() 或 async/await 处理响应;而 XMLHttpRequest 必须监听 onload、onerror、onprogress 等事件,手动管理状态(readyState)。
这意味着:
fetch() 默认不带错误状态码拦截(如 404、500 仍进 then),需手动检查 response.ok
XMLHttpRequest 的 onerror 只在真正网络失败时触发(如断网、DNS 失败),而 fetch() 的 catch 也只捕获这类异常,不是 HTTP 错误fetch() 依赖 AbortController;XMLHttpRequest 直接调用 .abort()
XMLHttpRequest 构造时传入 false 第三个参数可发起同步请求(阻塞主线程),但现代浏览器已禁用该能力(抛出 DOMException: Synchronous XMLHttpRequest on the main thread is not allowed)。fetch() 从设计上就不支持同步——它只能是异步的。
所以实际开发中:
fetch() 配合 Promise.all() 更自然;XMLHttpRequest 得靠计数器或封装 PromiseAbortController.timeout()(需 polyfill 或自行实现);XMLHttpRequest 直接设 .timeout 属性fetch() 的 credentials 选项默认是 'omit',即跨域或同域都不带 Cookie;XMLHttpRequest 在同域下默认携带 Cookie(只要没显式设 withCredentials = false)。
常见踩坑点:
fetch() 没加 { credentials: 'include' }
Access-Control-Allow-Origin 具体域名(不能是 *),且 credentials: 'include' 缺一不可XMLHttpRequest 设 withCredentials = true 后,预检请求(OPTIONS)也会带上认证头,需后端配合fetch('/api/user', {
credentials: 'include'
})
upload.onprogress
如果你要做大文件上传并显示进度条,XMLHttpRequest 是更直接的选择。它的 xhr.upload.onprogress 能拿到 loaded 和 total 字节数;fetch() 本身不暴露上传过程,得靠 ReadableStream + TransformStream 手动分块读取并上报进度(复杂且兼容性差)。
折中方案:
fetch() 更简洁XMLHttpRequest,尤其还要兼容 Safari 15.4 以下或旧 Androidfetch + FormData + 自定义流监控,但代码量和调试成本显著上升fetch() 已成主流,但别盲目替换所有 XMLHttpRe
quest —— 特别是涉及上传进度、细粒度超时、或需要兼容极老环境的场景,老 API 还有它不可替代的位置。