Prototype 1.6 边学边译 -- Ajax Ajax.Response

最新推荐文章于 2026-06-25 15:56:12 发布

翻译最新推荐文章于 2026-06-25 15:56:12 发布 · 2.8k 阅读

标签

#prototype #ajax #xmlhttprequest #null #string

Prototype 1.6 专栏收录该内容

18 篇文章

订阅专栏

本文详细介绍了Ajax.Response对象，它是Ajax请求回调中的第一个参数。文章解释了该对象如何封装原始XmlHttpRequest对象，解决跨浏览器问题，并提供了对JSON的支持。此外，还列举了Ajax.Response对象的属性和方法。

开发板推荐：天空星STM32F407VET6开发板

超高性价比 STM32主控 | 超高主频 | 一板兼容百芯 | 比赛神器 | 沉金彩色丝印

点击查看

Ajax.Response
1.6

该对象被传递到所有 Ajax 请求回调中作为第一个参数。

这是一个针对原始 XmlHttpRequest 对象（或与之相对应的 ActiveX 控件）的封装。它解决了跨浏览器的问题，并且通过 responseJSON 和 headerJSON 属性增加了对 JSON 的支持。
译注：Ajax.Request 其实也是封装 XmlHttpRequest。从命名上可以看出， Ajax.Request 用于处理请求，而 Ajax.Response 用于处理响应。

`Ajax.Response` 对象的属性

属性	类型	描述
`status`	`Number`	服务器发回的状态代码。
`statusText`	`String`	服务器发回的 HTTP 状态文本。
`readyState`	`Number`	请求的当前状态。`0` 对应 `"Uninitialized"`，`1` 对应 `"Loading"`，`2` 对应 `"Loaded"`，`3` 对应 `"Interactive"`，`4` 对应 `"Complete"`。译注：详细描述见：状态代码
`responseText`	`String`	响应的文本主体内容。
`responseXML`	`document 对象`或 `null`	如果请求的 content-type 值被设置为 `application/xml`，该属性获取响应文本内容作为 XML 呈现，否则为 `null`。
`responseJSON`	`Object`, `Array` 或 `null`	如果请求的 content-type 值被设置为 `application/json`，该属性获取响应文本内容并转换为相应的数组或对象。否则为 `null`。
`headerJSON`	`Object`, `Array` 或 `null`	如果响应头中包含 `X-JSON` 头，则自动将其内容转换为对象或数组。否则为 `null`。这个属性常用于少量数据的处理。
`request`	`Object`	请求对象本身（一个 `Ajax.Request` 或 `Ajax.Updater` 的实例）。
`transport`	`Object`	原始的 `xmlHttpRequest` 对象引用。

`Ajax.Response` 对象的方法

方法	返回类型	描述
`getHeader(name)`	`String` 或 `null`	如果存在指定的头，则返回其值，否则为 `null`。未定义头时，它不会像原生的 XHR 对象一样抛出异常。
`getAllHeaders()`	`String` 或 `null`	返回包含所有响应头的字符串，头与头之间用换行符（`/r/n`）分隔（译注：每个 Http 头名称和值用冒号分隔）。当不存在响应头时，它不会像原生的 XHR 对象一样抛出异常。
`getResponseHeader(name)`	`String`	如果存在指定的头，则返回其值。否则抛出一个异常。这仅只是对 `XmlHttpRequest` 对象 `getResponseHeader` 方法的简单封装。推荐使用更简捷的 `getHeader` 方法。
`getAllResponseHeaders()`	`String`	返回包含所有响应头的字符串，头与头之间用换行符（`/r/n`）分隔。当不存在任何响应头时，抛出异常。这仅只是对 `XmlHttpRequest` 对象 `getAllResponseHeaders` 方法的简单封装。推荐使用更简捷的 `getAllHeaders` 方法。