Ajax的XMLHttpRequest对象的属性和方法

属性

  • readyState属性
    标识XMLHttpRequest对象的状态,有五种值
说明
0 未初始化状态:对象创建,但未初始化
1 准备发送状态:此时,已经调用了XMLHttpRequest对象的open()方法,并且该对象已经准备好将一个请求发送到服务器
2 已发送状态:此时,已通过调用send()方法把一个请求发送到服务器,但还没有收到一个响应
3 正在接收状态:此时,已经接收到HTTP响应头部信息,但是消息体部分还没有完全接收到
4 完成响应状态:此时,已完成了HttpResponse响应的接收
  • responseText属性
    该属性包含客户端接收到的HTTP响应的文本内容。当readyState属性为0、1、2时,该属性包含空字符串; 当readyState值为3时,响应中包含客户端还未完成的响应信息; 当readyState值为4时,该属性才包含完整的响应信息。

  • responseXML属性
    只有当readyState属性值为4,并且响应头部的Content-Type的MIME类型被指定为XML (text/xml或者application/xml)时,该属性才有值并且被解析为一个XML文档,否则该属性值为null。如果回传的XML文档结构不良或者未完成响应回传,该属性也为空。

  • status属性
    描述HTTP状态码。注意,仅当readyState值为3(正在接收)或4(已加载)时,才能访问此属性。否则,试图读取时,将引发异常。

  • statusText属性
    描述HTTP状态码文本。跟status的注意事项一样,必须readyState为3或4。

方法

  • onreadystatechange事件
    当readyState属性值发生改变,就会触发此事件。一般都通过此事件来触发回传处理函数。

  • open()方法
    XMLHttpRequest对象是通过调用open(method, uri, async, username, password)方法来进行初始化的。调用该方法会得到一个可以用来进行发送(send()方法)的对象。此时,readyState状态会被设为1(准备发送状态)。方法参数解释如下:
    (1)method参数是必须提供的,用于指定用来发送请求的HTTP方法(GET, POST, PUT, DELETE或HEAD)。按照HTTP规范,该参数要大写。
    (2)uri用来指定请求的URL,该地址会被自动解析为绝对地址。
    (3)async参数用来指定请求是否是异步的,默认值为true。发同步请求,设为false
    (4)如果需要服务器验证访问用户的情况,可以设置username和password

  • send()方法
    必须在调用了open方法,即readyState的值为1,对象处理可发送状态时,才可以调用send()方法,将请求发送出去。
    当open()方法的参数async为true时,send()方法调用后立即返回,否则将等待请求返回。
    调用了send()方法到接收到响应之前,readyState的值将被设为2;一旦接收到响应,被设为3;直到响应接收完成,readyState的值才会被设为4。
    send()可使用一个可选参数,用于传递POST数据到服务器。参数可以不传或直接用null。
    一般情况下,在调用send()方法之前,应该设置Content-Type头部信息。如果send(data)方法中的data参数的类型为DOMString,那么数据将被编码为UTF-8。如果数据是Document类型,那么将使用由data.xmlEncoding指定的编码串行化该数据。

  • abort()方法
    该方法可以暂停一个HttpRequest的请求发送或者HttpResponse的接收,并将XMLHttpRequest对象设置为初始化状态。

  • setRequestHeader()方法
    用来设置请求的头部信息。需要在调用了open()方法之后调用此方法,否则会报异常。setRequestHeader(header, value)包含两个参数:前一个是键名称,后面是键值。

  • getResponseHeader()方法
    用于检索响应的头部值,仅当readyState属性值是3或4时,才可以调用此方法;否则,返回一个空字符串。
    此外,还可以通过getAllResponseHeaders()方法获取所有的HttpResponse的头部信息。

示例

var xhr = new XMLHttpRequest();
var �data = {            
    name: 'leyuan' 
};         
xhr.open('POST', url);     
xhr.setRequestHeader('Content-Type', 'application/json; charset=utf-8');         
xhr.onreadystatechange = function () {                        
    if (xhr.readyState == 4 && xhr.status == 200) {                 
        // request success. do something.         
    }
};         
xhr.send(data);

你可能感兴趣的:(Ajax的XMLHttpRequest对象的属性和方法)