这是 共享一组通用选项和回调的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
