XMLHTTPRequest


XMLHTTPRequest

求助编辑

百科名片

XMLHttpRequest可以提供不重新加载页面的情况下更新网页,在页面加载后在客户端向服务器请求数据,在页面加载后在服务器端接受数据,在后台向客户端发送数据。XMLHttpRequest 对象提供了对 HTTP 协议的完全的访问,包括做出POST 和 HEAD 请求以及普通的 GET 请求的能力。XMLHttpRequest 可以同步或异步返回 Web 服务器的响应,并且能以文本或者一个 DOM 文档形式返回内容。尽管名为 XMLHttpRequest,它并不限于和 XML 文档一起使用:它可以接收任何形式的文本文档。XMLHttpRequest对象是名为 AJAX 的 Web 应用程序架构的一项关键功能。

对象

浏览器支持

  XMLHttpRequest得到了所有现代浏览器较好的支持。唯一的浏览器依赖性涉及 XMLHttpRequest 对象的创建。在 IE 5 和 IE 6 中,必须使用特定于 IE 的 ActiveXObject() 构造函数。正如在 XMLHttpRequest 对象 这一节所介绍的。

W3C标准化

  XMLHttpRequest对象还没有标准化,但是W3C 已经开始了标准化的工作,本手册介绍的内容都是基于标准化的工作草案。

  当前的XMLHttpRequest 实现已经相当一致。但是和标准有细微的不同。例如,一个实现可能返回 null,而标准要求是空字符串,或者实现可能把 readyState 设置为 3 而不保证所有的响应头部都可用。

编辑本段

属性

readyState

  HTTP 请求的状态.当一个 XMLHttpRequest 初次创建时,这个属性的值从 0 开始,直到接收到完整的HTTP 响应,这个值增加到 4。

  5 个状态中每一个都有一个相关联的非正式的名称,下表列出了状态、名称和含义:

  状态 名称 描述

0 Uninitialized 初始化状态。XMLHttpRequest 对象已创建或已被 abort() 方法重置。

1 Open open() 方法已调用,但是 send() 方法未调用。请求还没有被发送。

2 Send Send() 方法已调用,HTTP 请求已发送到 Web 服务器。未接收到响应。

3 Receiving 所有响应头部都已经接收到。响应体开始接收但未完成。

4 Loaded HTTP 响应已经完全接收。

  readyState 的值不会递减,除非当一个请求在处理过程中的时候调用了 abort() 或 open() 方法。每次这个属性的值增加的时候,都会触发onreadystatechange 事件句柄。

responseText

  目前为止从服务器接收到的响应体(不包括头部),或者如果还没有接收到数据的话,就是空字符串。

  如果readyState 小于 3,这个属性就是一个空字符串。当 readyState 为 3,这个属性返回目前已经接收的响应部分。如果 readyState 为 4,这个属性保存了完整的响应体。

  如果响应包含了为响应体指定字符编码的头部,就使用该编码。否则,假定使用 Unicode UTF-8。

responseXML

  对请求的响应,解析为XML 并作为 Document 对象返回。

statu

  由服务器返回的 HTTP状态代码,如 200 表示成功,而 404 表示 "Not Found" 错误。当 readyState 小于 3 的时候读取这一属性会导致一个异常。

statusText

  这个属性用名称而不是数字指定了请求的 HTTP 的状态代码。也就是说,当状态为 200 的时候它是"OK",当状态为 404 的时候它是 "Not Found"。和 status 属性一样,当 readyState 小于 3 的时候读取这一属性会导致一个异常。

编辑本段

事件句柄

onreadystatechange

  每次readyState 属性改变的时候调用的事件句柄函数。当 readyState 为 3 时,它也可能调用多次。

编辑本段

方法

abort()

  取消当前响应,关闭连接并且结束任何未决的网络活动。

  这个方法把XMLHttpRequest 对象重置为readyState 为 0 的状态,并且取消所有未决的网络活动。例如,如果请求用了太长时间,而且响应不再必要的时候,可以调用这个方法。

getAllResponseHeaders()

  把 HTTP 响应头部作为未解析的字符串返回。

  如果readyState 小于 3,这个方法返回 null。否则,它返回服务器发送的所有 HTTP 响应的头部。头部作为单个的字符串返回,一行一个头部。每行用换行符"\r\n" 隔开。

getResponseHeader()

  返回指定的 HTTP 响应头部的值。其参数是要返回的 HTTP 响应头部的名称。可以使用任何大小写来制定这个头部名字,和响应头部的比较是不区分大小写的。

  该方法的返回值是指定的HTTP 响应头部的值,如果没有接收到这个头部或者 readyState 小于 3 则为空字符串。如果接收到多个有指定名称的头部,这个头部的值被连接起来并返回,使用逗号和空格分隔开各个头部的值。

open()

  初始化 HTTP 请求参数,例如 URL 和 HTTP 方法,但是并不发送请求。

send()

  发送 HTTP 请求,使用传递给 open() 方法的参数,以及传递给该方法的可选请求体。

setRequestHeader()

  向一个打开但未发送的请求设置或添加一个 HTTP 请求。

编辑本段

XMLHttpRequest.open()

  初始化 HTTP 请求参数

语法

  open(method,url, async, username, password)method 参数是用于请求的 HTTP 方法。值包括 GET、POST 和 HEAD。

  url 参数是请求的主体。大多数浏览器实施了一个同源安全策略,并且要求这个URL 与包含脚本的文本具有相同的主机名和端口。

  async 参数指示请求使用应该异步地执行。如果这个参数是 false,请求是同步的,后续对 send() 的调用将阻塞,直到响应完全接收。如果这个参数是 true 或省略,请求是异步的,且通常需要一个onreadystatechange 事件句柄。

  username 和 password 参数是可选的,为 url 所需的授权提供认证资格。如果指定了,它们会覆盖 url 自己指定的任何资格。

说明

  这个方法初始化请求参数以供 send() 方法稍后使用。它把 readyState 设置为 1,删除之前指定的所有请求头部,以及之前接收的所有响应头部,并且把 responseText、responseXML、status 以及 statusText 参数设置为它们的默认值。当 readyState 为 0 的时候(当XMLHttpRequest 对象刚创建或者abort() 方法调用后)以及当readyState 为 4 时(已经接收响应时),调用这个方法是安全的。当针对任何其他状态调用的时候,open() 方法的行为是为指定的。

  除了保存供 send()方法使用的请求参数,以及重置XMLHttpRequest 对象以便复用,open() 方法没有其他的行为。要特别注意,当这个方法调用的时候,实现通常不会打开一个到 Web 服务器的网络连接。

编辑本段

XMLHttpRequest.send()

  发送一个 HTTP 请求

语法

  send(body)如果通过调用 open() 指定的 HTTP 方法是 POST 或 PUT,body 参数指定了请求体,作为一个字符串或者 Document 对象。如果请求体不适必须的话,这个参数就为 null。对于任何其他方法,这个参数是不可用的,应该为 null(有些实现不允许省略该参数)。

说明

  这个方法导致一个HTTP 请求发送。如果之前没有调用open(),或者更具体地说,如果readyState 不是 1,send() 抛出一个异常。否则,它发送一个 HTTP 请求,该请求由以下几部分组成:

  之前调用 open() 时指定的 HTTP 方法、URL 以及认证资格(如果有的话)。 之前调用 setRequestHeader() 时指定的请求头部(如果有的话)。传递给这个方法的 body 参数。 一旦请求发布了,send() 把 readyState 设置为 2,并触发onreadystatechange 事件句柄。

  如果之前调用的open() 参数 async 为 false,这个方法会阻塞并不会返回,直到 readyState 为 4 并且服务器的响应被完全接收。否则,如果 async 参数为 true,或者这个参数省略了,send()立即返回,并且正如后面所介绍的,服务器响应将在一个后台线程中处理。

  如果服务器响应带有一个HTTP 重定向,send() 方法或后台线程自动遵从重定向。当所有的 HTTP 响应头部已经接收,send() 或后台线程把 readyState 设置为 3 并触发 onreadystatechange 事件句柄。如果响应较长,send() 或后台线程可能在状态 3 中触发onreadystatechange 事件句柄:这可以作为一个下载进度指示器。最后,当响应完成,send() 或后台线程把 readyState 设置为 4,并最后一次触发事件句柄。

编辑本段

XMLHttpRequest.setRequestHeader()

语法

  setRequestHeader(name,value)name 参数是要设置的头部的名称。这个参数不应该包括空白、冒号或换行。

  value 参数是头部的值。这个参数不应该包括换行。

说明

  setRequestHeader()方法指定了一个 HTTP 请求的头部,它应该包含在通过后续 send() 调用而发布的请求中。这个方法只有当 readyState 为 1 的时候才能调用,例如,在调用了 open() 之后,但在调用 send() 之前。

  如果带有指定名称的头部已经被指定了,这个头部的新值就是:之前指定的值,加上逗号、空白以及这个调用指定的值。

  如果 open() 调用指定了认证资格,XMLHttpRequest 自动发送一个适当的 Authorization 请求头部。但是,你可以使用 setRequestHeader() 来添加这个头部。类似地,如果 Web 服务器已经保存了和传递给 open() 的 URL 相关联的 cookie,适当的 Cookie 或 Cookie2 头部也自动地包含到请求中。可以通过调用 setRequestHeader() 来把这些 cookie 添加到头部。XMLHttpRequest 也可以为 User-Agent 头部提供一个默认值。如果它这么做,你为该头部指定的任何值都会添加到这个默认值后面。

  有些请求头部由XMLHttpRequest 自动设置而不是由这个方法设置,以符合 HTTP 协议。这包括如下和代理相关的头部:

  HostConnection Keep-Alive Accept-charset Accept-Encoding If-Modified-SinceIf-None-Match If-Range Range


优质内容筛选与推荐>>
1、家庭记事本开发进度4
2、打印单据,A4纸,每个单据占一个A4纸,两个单据之间不挨着
3、OC Block网上转载
4、JS去除空格方法记录
5、Codeforces Round #426 B


长按二维码向我转账

受苹果公司新规定影响,微信 iOS 版的赞赏功能被关闭,可通过二维码转账支持公众号。

    阅读
    好看
    已推荐到看一看
    你的朋友可以在“发现”-“看一看”看到你认为好看的文章。
    已取消,“好看”想法已同步删除
    已推荐到看一看 和朋友分享想法
    最多200字,当前共 发送

    已发送

    朋友将在看一看看到

    确定
    分享你的想法...
    取消

    分享想法到看一看

    确定
    最多200字,当前共

    发送中

    网络异常,请稍后重试

    微信扫一扫
    关注该公众号