这是 共享一组通用选项和回调的Ajax命名空间。
回调在请求生命周期的不同点被调用,并且始终具有相同的参数列表。它们与其他选项一起传递给请求者。
常用选项
选项 | 描述 |
---|---|
asynchronous | 默认值为true。 确定是否异步使用 XMLHttpRequest。 |
contentType | 默认值为application/x-www-form-urlencoded。 您的请求的 Content-Type 标头。 |
encoding | 默认值为UTF-8。 您的请求的 Content-Type 标头。 |
method | 默认值为post。 用于请求的 HTTP 方法。 |
parameters | 默认值为‘ ‘。 请求的参数,将被编码到“get”方法的 URL 中,或编码到其他方法的请求正文中。这可以作为 URL 编码的字符串或任何具有表示参数的属性的哈希兼容对象提供。 |
postBody | 默认值为无。 “post”方法上请求正文的具体内容。如果未提供,将使用参数选项的内容代替。 |
requestHeaders | 请参阅下面的说明。 请求标头可以通过两种形式传递 -作为一个对象,具有表示标题的属性。作为一个数组,偶数索引 (0, 2…) 元素是标题名称,奇数索引 (1, 3…) 元素是值。Prototype 自动提供一组默认标头,此选项可以覆盖和扩充 –X-Requested-With设置为‘XMLHttpRequest’。X-Prototype-Version提供 Prototype 的当前版本(例如 1.5.0)。接受默认为‘text/javascript, text/html, application/xml, text/xml, */*’Content-type是基于contentType和编码选项构建的。 |
evalJS | 默认值为true。 如果服务器返回的内容类型是以下之一,则自动评估Ajax.Response#responseText的内容 -应用程序/ecmascript,应用程序/JavaScript,应用程序/x-ecmascript,应用程序/x-javascript,文本/ecmascript,文字/JavaScript,文本/x-ecmascript,或text/x-javascript 并且请求遵守SOP(简单来源策略)。如果您需要强制评估,请传递“force”。要完全防止它,请传递 false。 |
evalJSON | 默认值为true。 如果服务器返回的内容类型设置为application/json ,则自动评估Ajax.Response#responseText的内容并用它填充Ajax.Response#responseJSON。如果请求不遵守 SOP,则在评估之前对内容进行清理。如果您需要强制评估,请传递“force”。要完全防止它,请传递 false。 |
sanitizeJSON | 本地请求为false ,否则为true。 在评估之前清理Ajax.Response#responseText的内容。 |
常见回调
编号 | 回调&说明 |
---|---|
1. | onCreate 在初始化 Ajax.Request 对象时触发。这是在处理完参数和 URL 之后,但在第一次使用 XHR 对象的方法之前。 |
2. | onComplete 在请求生命周期的最后触发,一旦请求完成,就会调用特定于状态的回调,并处理可能的自动行为。 |
3. | onException 每当出现 XHR 错误时触发。具有自定义签名:第一个参数是请求者(即 Ajax.Request 实例),第二个是异常对象。 |
4. | onFailure 当请求完成且其状态代码存在但不在 2xy 系列中时调用。如果定义了特定于代码的回调,这将被跳过,并且发生在 onComplete 之前。 |
5. | onInteractive 不保证但只要请求者收到响应的一部分(但不是最后一部分)就会触发,如果它是在几个数据包中发送的。 |
6. | onLoaded 不保证,但一旦设置了底层 XHR 对象、打开连接并准备好发送其实际请求就会触发。 |
7. | onLoading 不保证,但在设置底层 XHR 对象并打开其连接时触发。 |
8. | onSuccess 当请求完成且其状态代码未定义或属于 2xy 系列时调用。如果定义了特定于代码的回调,则跳过该回调,并且发生在onComplete之前 |
9. | onUninitialized 不保证,但会在刚刚创建 XHR 对象时调用。 |
10. | onXYZ XYZ 是响应的 HTTP 状态代码。在响应刚刚完成时调用,状态代码正是我们在回调名称中使用的代码。阻止执行 onSuccess / onFailure。在 onComplete 之前发生。 |
响应者回调
编号 | 回调&说明 |
---|---|
1. | onCreate 每当创建来自 Ajax 命名空间的请求者对象时,在调整其参数之后和打开其 XHR 连接之前触发。这有两个参数:请求者对象和底层XHR 对象。 |
2. | onComplete 在请求生命周期的最后触发,一旦请求完成,就会调用特定于状态的回调,并处理可能的自动行为。 |
3. | onException 每当出现 XHR 错误时触发。具有自定义签名:第一个参数是请求者(即 Ajax.Request 实例),第二个是异常对象。 |
4. | onInteractive 不能保证,但只要请求者收到响应的一部分(但不是最后一部分),它就会被操纵,它应该在几个数据包中发送。 |
5. | onLoaded 不保证,但一旦设置了底层 XHR 对象、打开连接并准备好发送其实际请求就会触发。 |
6. | onLoading 不保证,但在设置底层 XHR 对象并打开其连接时触发。 |
7. | onUninitialized 不保证,但会在刚刚创建 XHR 对象时调用。 |
作者:terry,如若转载,请注明出处:https://www.web176.com/prototype_api/8308.html