AJAX 选项 | Prototype教程

返回到:Prototype AJAX 教程

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

返回到:Prototype AJAX 教程

作者:terry,如若转载,请注明出处:https://www.web176.com/prototype_api/8308.html

(0)
打赏 支付宝 支付宝 微信 微信
terryterry
上一篇 2023年1月25日
下一篇 2023年1月26日

相关推荐

发表回复

登录后才能评论