XMLHttpRequest
使用XMLHttpRequest (XHR)对象可以与服务器交互。您可以从URL获取数据,而无需让整个的页面刷新。这使得Web页面可以只更新页面的局部,而不影响用户的操作。XMLHttpRequest在 Ajax 编程中被大量使用。
目录
XMLHttpRequest.onreadystatechange
XMLHttpRequestEventTarget.ontimeout
XMLHttpRequest.withCredentials
XMLHttpRequest.mozBackgroundRequest
XMLHttpRequest.getAllResponseHeaders()
XMLHttpRequest.getResponseHeader()
XMLHttpRequest.overrideMimeType()
XMLHttpRequest.setRequestHeader()
-
构造方法
XMLHttpRequest()
构造函数初始化一个 XMLHttpRequest
对象。必须在所有其他方法被调用前调用构造函数。
-
属性
-
此接口继承了
XMLHttpRequestEventTarget
和EventTarget
的属性。
XMLHttpRequest.onreadystatechange
当readyState属性发生变化时调用的EventHandler
。
XMLHttpRequest.readyState
只读
返回 一个unsigned short 即无符号短整型,请求的状态码。
XMLHttpRequest.response
返回ArrayBuffer
、Blob
、Document
、DOMString
},具体是哪种类型取决于XMLHttpRequest.responseType
的值。其中包含响应体body。
XMLHttpRequest.responseText
返回一个DOMString
,该DOMString
}包含对请求的响应,如果请求未成功或尚未发送,则返回null。
XMLHttpRequest.responseType
定义响应类型的枚举值。
XMLHttpRequest.responseURL
返回响应的序列化URL,如果URL为空,则返回空字符串。
XMLHttpRequest.responseXML
返回一个Document
,其中包含该请求的响应,如果请求未成功、尚未发送或不能解析为XML或HTML,则返回null。
XMLHttpRequest.status
返回 unsigned short 即无符号短整型请求响应状态。
XMLHttpRequest.statusText
返回一个DOMString
},其中包含HTTP服务器返回的响应状态。与 XMLHTTPRequest.status
不同的是,它包括响应状态的整个文本(例如,“200 OK”)。
XMLHttpRequest.timeout
unsigned long 即无符号长整型,表示该请求的最大请求时间(毫秒),超过该时间请求会自动结束。
XMLHttpRequestEventTarget.ontimeout
当请求超时调用的EventHandler
。{ { gecko_minversion_inline(" 12.0 ")} }
XMLHttpRequest.upload
XMLHttpRequestUpload
,表示上传过程。
XMLHttpRequest.withCredentials
Boolean
,用来指定跨域的请求是否应该使用证书(如cookie或授权header头)。
XMLHttpRequest.channel
nsIChannel
,对象在执行请求时使用的通道。
XMLHttpRequest.mozAnon
一个布尔值,如果为真,请求将在没有cookie和身份验证header头的情况下发送。
XMLHttpRequest.mozSystem
一个布尔值,如果为真,则在请求时不会强制执行同源策略。
XMLHttpRequest.mozBackgroundRequest
一个布尔值,它指示对象是否是后台服务器端的请求
-
方法
XMLHttpRequest.abort()
如果请求已经被发送,则立刻中止请求.
XMLHttpRequest.getAllResponseHeaders()
以字符串的形式返回所有用CRLF分隔的响应头,如果没有收到响应,则返回null。
XMLHttpRequest.getResponseHeader()
返回包含指定响应头的字符串,如果响应尚未收到或响应中不存在该报头,则返回null。
XMLHttpRequest.open()
初始化一个请求。该方法只能JavaScript代码中使用,若要在native code中初始化请求,请使用openRequest()。
XMLHttpRequest.overrideMimeType()
重写由服务器返回的MIME type。
XMLHttpRequest.send()
发送请求。如果请求是异步的(默认),那么该方法将在请求发送后立即返回。
XMLHttpRequest.setRequestHeader()
设置HTTP请求头的值。您必须在open()之后、send()之前调用setRequestHeader()这个方法。
举例:
function load(){
var request = new XMLHttpRequest();
request.open("GET","https://developer.mozilla.org/zh-CN/docs/Web/API/XMLHttpRequest/response",true);
request.onload=()=>{console.log(request.responseText)};
request.onerror = ()=>{alert('There was a network error.')};
request.send();
}