jQuery Ajax中fail函数触发时机及「请求发送期间」含义与示例
1. 「请求发送期间」的含义与示例
这里提到的「请求发送期间」,并不是单指把HTTP请求报文推送到公网链路的那一瞬间动作,而是覆盖从$.ajax()方法被调用开始,到浏览器完全接收对应响应、准备触发回调逻辑的全链路周期。这个区间包含了浏览器构造XHR/fetch实例、解析目标域名IP、建立TCP/TLS连接、传输请求报文、后端服务处理、回传响应报文、前端解析响应内容的所有环节,不存在狭义的“仅算网络传输段”的划分边界。
举个直观的边界说明示例:
// 调用方法的这一刻,就已经正式进入「请求发送期间」 const pendingReq = $.ajax({ url: '/api/article-list', method: 'GET', dataType: 'json' }) // 后续从域名解析、TCP建连、把请求发给后端、等后端算完返回结果、浏览器收完响应的全过程,都属于这个区间 // 直到浏览器完成响应内容解析、准备调用done/fail回调的前一刻,这个区间才正式结束
哪怕错误发生在最开始的浏览器构造请求阶段,也算在「请求发送期间」的覆盖范围内。
2. fail回调的全触发场景
只要在上面提到的全周期内出现任意不符合成功判定规则的问题,fail就会被触发,具体覆盖的常见场景包括:
- 网络链路中断:比如请求传输过程中设备断网、用户切换Wi-Fi/移动网络、运营商链路丢包,导致浏览器无法拿到完整的响应报文
- HTTP状态码不符合成功判定规则:默认jQuery会将2xx区间状态码、304状态码判定为请求成功,其余状态码(比如403权限不足、404接口不存在、500服务端内部错误、502网关错误)只要后端正常返回了响应,都会触发fail。这个成功判定的阈值可以通过
converters、statusCode配置自定义 - 响应内容解析失败:哪怕后端返回了200的成功状态码,如果响应内容和你配置的
dataType不匹配,解析过程抛错的话依然会触发fail。比如你配置了dataType: 'json',但后端实际返回的是纯文本的报错页面,JS层尝试把内容转成合法JSON时抛错,就会走fail分支 - 请求被主动中止:如果你手动调用之前拿到的jqXHR对象的
.abort()方法,主动中断还未完成的请求,fail也会被触发,这时候回调收到的错误标识会是'abort' - 请求超时:如果配置了
timeout参数,整个全周期的耗时超过了设定的阈值,浏览器主动中断请求,fail会被触发,对应错误标识是'timeout' - 跨域请求被浏览器拦截:没有配置合规CORS规则的跨域响应,会被浏览器安全策略直接拦截,JS层拿不到任何响应细节,这种情况同样会触发fail
内容的提问来源于stack exchange,提问作者fahmi derbali
相关产品推荐
相关产品推荐

