全局 Ajax 事件处理器

全局 Ajax 事件处理器

这些方法用于注册事件处理器,用来处理页面上的任何 Ajax 请求,当某些事件触发后,这些事件处理器被调用。如果 jQuery.ajaxSetup() 中的 global 属性被设置为 true (这也是默认设置),那么,每个 Ajax 请求都会触发全局事件。
注意: 全局事件绝对不会被跨域(cross-domain)脚本或 JSONP 请求触发,和 global 属性的设置毫无关系。


一、.ajaxStart()

描述: 在AJAX 请求刚开始时执行一个处理函数。 这是一个 Ajax Event.

参数
.ajaxStart(callback)

  • callback: 类型: Function()被调用的函数。

每当一个Ajax请求即将发送,jQuery检查是否有任何其他响应过程中的Ajax请求(注:未完成的请求)。如果没有检查到,jQuery就会触发ajaxStart事件,在这个时间点所有处理函数都会使用.ajaxStart()方法注册并执行。

注意

  • 从 jQuery 1.8 开始, .ajaxStart() 方法只能绑定到 document元素.

二、.ajaxSend()

描述: 在Ajax请求发送之前绑定一个要执行的函数,这是一个 Ajax Event.
XMLHttpRequest 对象和设置作为参数传递给回调函数。

参数
ajaxSend(fn(event, jqXHR, ajaxOptions))

  • fn(event, jqXHR, ajaxOptions):类型: Function()被调用的函数。

每当一个Ajax请求即将发送,jQuery就会触发ajaxSend事件,在这个时间点所有处理函数都会使用.ajaxSend()方法注册并执行。

注意

  • 从 jQuery 1.8 开始, .ajaxSend() 方法只能绑定到 document元素.
  • 如果global选项设置为false,调用$.ajax() 或 .ajaxSend()方法将不会被触发。

三、.ajaxComplete()

描述: 当Ajax请求完成后注册一个回调函数。这是一个 Ajax Event.
XMLHttpRequest 对象和设置作为参数传递给回调函数。

参数
ajaxComplete(fn(event, XMLHttpRequest, ajaxOptions))

  • fn(event, XMLHttpRequest, ajaxOptions):类型: Function()被调用的函数。

每当一个Ajax请求完成,jQuery就会触发ajaxComplete事件,在这个时间点所有处理函数会使用.ajaxComplete()方法注册并执行。

注意

  • 从 jQuery 1.8 开始, .ajaxComplete() 方法只能绑定到 document元素.
  • 如果global选项设置为false,调用$.ajax() 或 $.ajaxSetup(),.ajaxComplete()方法将不会被触发。

四、.ajaxSuccess()

描述: 绑定一个函数当 Ajax 请求成功完成时执行。,这是一个 Ajax Event.
XMLHttpRequest 对象和设置作为参数传递给回调函数。

参数
ajaxSuccess(fn(event, XMLHttpRequest, ajaxOptions))

  • fn(event, XMLHttpRequest, ajaxOptions):类型: Function()被调用的函数。

每当一个Ajax请求成功完成,jQuery就会触发ajaxSuccess事件,在这个时间点所有处理函数都会使用.ajaxSuccess()方法注册并执行。

注意

  • 从 jQuery 1.8 开始, .ajaxSuccess() 方法只能绑定到 document元素.
  • 你可以得到返回的AJAX内容 察看XML和HTML的xhr.responseXML 或 xhr.responseHTML 之间的分别。

五、.ajaxError()

描述: Ajax请求出错时注册一个回调处理函数,这是一个 Ajax Event.
XMLHttpRequest 对象和设置作为参数传递给回调函数。捕捉到的错误可作为最后一个参数传递。

参数
ajaxError(fn(event, jqXHR, ajaxSettings, thrownError))

  • fn(event, jqXHR, ajaxSettings, thrownError):类型: Function()被调用的函数。

每当一个Ajax请求出错时,jQuery就会触发ajaxError事件,在这个时间点所有处理函数会使用.ajaxError()方法注册并执行。

注意

  • 这里的handler处理器调用跨域的脚本和跨域的JSONP请求。
  • 从 jQuery 1.8 开始, .ajaxError() 方法只能绑定到 document元素.
  • 如果global选项设置为false,调用$.ajax() 或 $.ajaxError()方法将不会被触发。

六、.ajaxError()

描述: 在AJAX 请求完成时执行一个处理函数,这是一个 Ajax Event.
XMLHttpRequest 对象和设置作为参数传递给回调函数。捕捉到的错误可作为最后一个参数传递。

参数
ajaxError(fn(event, jqXHR, ajaxSettings, thrownError))

  • fn(event, jqXHR, ajaxSettings, thrownError):类型: Function()被调用的函数。

每当一个Ajax请求完成,jQuery检查是否有任何其他响应过程中的Ajax请求(注:未完成的请求)。如果都执行完成,jQuery就会触发ajaxStop事件,在这个时间点所有处理函数都会使用.ajaxStop()方法注册并执行。如果一个未处理完成的Ajax请求用beforeSend回调函数返回false取消,ajaxStop事件也被触发。

注意

  • 从 jQuery 1.8 开始, .ajaxStop() 方法只能绑定到 document元素.
  • 如果global选项设置为false,调用$.ajax() 或 $.ajaxStop()方法将不会被触发。

猜你喜欢

转载自blog.csdn.net/weixin_42952665/article/details/82755595