XMLHttpRequest(簡稱 XHR)是一組開放給 JavaScript、JScript、VBScript 等用戶端腳本語言使用的 API,讓程式能透過 HTTP 協定向伺服器傳送請求、接收 XML 或其他格式的資料。它最實用的價值在於:只更新網頁的局部內容,而不必重新載入整個頁面。
依照 MSDN 的說法,XmlHttp 提供用戶端與 HTTP 伺服器溝通的協議。程式可以透過 XmlHttp 物件(例如 MSXML2.XMLHTTP.3.0)送出請求,再利用 Microsoft XML DOM 解析回傳的結果。
今日主流瀏覽器幾乎都已內建對 XHR 的支援,但建立方式分成兩條路:
new ActiveXObject("Microsoft.XMLHTTP") 或新版常用的 Msxml2.XMLHTTP。new XMLHttpRequest()。因此實務上通常會寫成「先試原生、失敗再退回 ActiveX」的相容寫法,以同時照顧新舊瀏覽器。
onreadystatechange:readyState 變動時觸發的事件處理常式,可讀寫。readyState:回傳目前請求的狀態(唯讀)。responseBody:以無號位元組陣列回傳回應本文(唯讀)。responseStream:以 ADO Stream 物件形式回傳回應(唯讀)。responseText:以字串形式回傳回應內容(唯讀)。responseXML:將回應格式化為 XML Document 物件後回傳(唯讀)。status:回傳目前的 HTTP 狀態碼(唯讀)。statusText:回傳目前的 HTTP 狀態行文字(唯讀)。其中 onreadystatechange 屬於 W3C DOM 標準之外的擴充成員。
abort():取消目前的請求。getAllResponseHeaders():取得回應的所有 HTTP 標頭。getResponseHeader(name):取得指定的 HTTP 標頭。open(method, url, async):建立新請求,指定方法、URL 與驗證資訊。send(body):把請求送到伺服器並等待回應。setRequestHeader(name, value):設定單一請求標頭。原生 XMLHttpRequest 本身沒有額外的事件集合,開發者主要透過 onreadystatechange 加上 readyState === 4 與 status === 200 的判斷來掌握請求完成與成功的時機;較新的瀏覽器另提供 onload、onerror、ontimeout、onprogress 等更直覺的事件,可作為補充。