XMLHttpRequest参数详解

@拭目以待:首发于XMLHttpRequest参数详解

首先,先来一个简易的ajax:

var xhr = new XMLHttpRequest();
xhr.open('GET', 'http://www.lovejavascript.com/learnLinkManager/getLearnLinkList', true);
xhr.send(null);

就是这样一个简单的ajax请求就完成了,接下来对 XMLHttpRequest 对象及所拥有的方法、属性进行说明。

XMLHttpRequest():
这是个构造函数,用于初始化一个XMLHttpRequest对象。

方法

xhr.open(method, url, async, user, password):

作用: 通过XMLHttpRequest实例,打开一个请求。
参数:

  • method(String): 请求所使用的HTTP方法; 例如 "GET", "POST", "PUT", "DELETE"等. 如果下个参数是非HTTP(S)的URL,则忽略该参数
  • url(String): 请求访问的URL地址
  • async(Boolean): 配置是否为异步执行,默认值为true; 如果想了解更多请点击ajax的同步与异步
  • user(String): 授权参数
  • password(String): 授权参数
    注意: 在未调用send()前, 再次调用open()方法等同于abort()

xhr.send(data)
说明: 发送请求
参数:
data(String, Array, Object): 发送请求时所需要传递的参数,为空时传递null

xhr.abort();
说明:中止请求

xhr.getAllResponseHeaders();
说明:获取全部响应头信息
注意:需要在onreadystatechange事件函数中使用

xhr.getResponseHeader(headerStr);
说明:获取响应头信息
注意:需要在 onreadystatechange 事件函数中使用
参数:
headerStr: 响应头名称

属性

xhr.readyState
说明:当前请求的五种状态值,一般在事件函数 onreadystatechange 中作为条件判断,以下是五种状态值及对应说明。

  • 0未打开,xhr.open()方法还未被调用.
  • 1未发送, xhr.send()方法还未被调用.
  • 2已获取响应头,xhr.send()方法已经被调用, 响应头和响应状态已经返回.
  • 3正在下载响应体, xhr.响应体下载中; responseText中已经获取了部分数据.
  • 4请求完成, 整个请求过程已经完毕.

xhr.responseType
说明: 通知服务器,请求所期待反回的数据类型
不同的配置会影响接收返回数据的方式,常用的数据类型有两种,对应的接收属性为:
text => responseText
json => response
不建议配置该项,使用默认字符串进行接收,接收后在客户端自行转换格式。

xhr.timeout
说明: 通过该属性进行超时时长设置,单位为毫秒。超时后会触发 ontimeout 事件
注意: 当前请求为同步请求时,使用该属性会抛异常。

xhr.withCredentials
说明: 跨域请求是否提供凭据(cookie、HTTP认证及客户端SSL证明等)。想了解更多请查看ajax中的withCredentials使用效果。

xhr.upload
说明:该属性指向 XMLHttpRequestUpload 上传对象,通过在该对象上绑定事件来处获取相应的信息。除过 onreadystatechange 事件不可以绑定至 XMLHttpRequestUpload 以象,其它事件均可以绑定

想了解更多请查看带进度的简单上传

事件

xhr.onreadystatechange
说明: 监听属性 xhr.readyState ,在该值发生改变后触发并执行事件函数;
示例:

xhr.onreadystatechange = function() {
if (xhr.readyState !== 4) {
return;
}
if (xhr.status >= 200 && xhr.status < 300 || xhr.status === 304) {
// jquery success(XHR, TS)
options.success(xhr.response, xhr.status);
} else {
// jquery error(XHR, TS, statusText)
options.error(xhr, xhr.status, xhr.statusText);
}
};

xhr.onloadstart

说明: 监听开始事件,触发后执行事件函数
示例:

xhr.onloadstart = function(){
console.log('开始');
}

xhr.onprogress
说明: 监听数据传输进行中事件,触发后执行事件函数
示例:

xhr.onprogress = function(){
console.log('onprogress');
}

xhr.onabort
说明: 监听请求终止事件,触发后执行事件函数

示例:

xhr.onabort = function(){
console.log('请求终止');
}

xhr.onerror
说明: 监听请求失败事件,触发后执行事件函数
示例:

xhr.onerror = function(){
console.log('请求失败');
}

xhr.onload
说明: 监听请求成功事件,触发后执行事件函数
示例:

xhr.onload = function(){
console.log('请求成功');
}

xhr.ontimeout
说明: 监听请求延迟未完成事件,触发后执行事件函数
示例:

xhr.ontimeout = function(){
console.log('延迟未完成');
}

xhr.onloadend
说明: 监听请求完成事件,触发后执行事件函数
示例:

xhr.onloadend = function(){
console.log('请求完成');
}

顺带说下 XMLHttpRequest 最先是IE提出来的,IE对互联网贡献很大,只是被黑的太惨。

@拭目以待

个人站点:www.lovejavascript.com
表格管理插件:gridmanager.lovejavascript.com && github地址
QQ交流群 (452781895):How To Make Love
微信公众账号:loveJavascript

《野生前端工程师》专辑中所有文章均为@拭目以待 原创,转载请注明出处。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 199,902评论 5 468
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 84,037评论 2 377
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 146,978评论 0 332
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 53,867评论 1 272
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 62,763评论 5 360
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,104评论 1 277
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,565评论 3 390
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,236评论 0 254
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,379评论 1 294
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,313评论 2 317
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,363评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,034评论 3 315
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,637评论 3 303
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,719评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,952评论 1 255
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,371评论 2 346
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 41,948评论 2 341

推荐阅读更多精彩内容

  • Ajax和XMLHttpRequest 我们通常将Ajax等同于XMLHttpRequest,但细究起来它们两个是...
    changxiaonan阅读 2,214评论 0 2
  • 本文详细介绍了 XMLHttpRequest 相关知识,涉及内容: AJAX、XMLHTTP、XMLHttpReq...
    semlinker阅读 13,597评论 2 18
  • 看到标题时,有些同学可能会想:“我已经用xhr成功地发过很多个Ajax请求了,对它的基本操作已经算挺熟练了。” 我...
    前端渣渣阅读 5,744评论 1 12
  • AJAX 原生js操作ajax 1.创建XMLHttpRequest对象 var xhr = new XMLHtt...
    碧玉含香阅读 3,160评论 0 7
  • HTML HTML5标签 媒体查询head部分写法 Doctype作用? 严格模式与混杂模式如何区分?它们有何意义...
    Mayo_阅读 634评论 0 8