| 方法 | 說明 |
|---|---|
abort() | 停止目前的請求 |
getAllResponseHeaders() | 把 HTTP 請求的所有回應標頭以「名稱/值」形式返回 |
getResponseHeader("header") | 返回指定標頭的字串值 |
open("method", "url", [async], [username], [password]) | 建立對伺服器的呼叫。method 可為 get、post、put 等;url 可為相對或絕對路徑;後三個為選擇性參數 |
send(content) | 向伺服器發送請求 |
setRequestHeader("header", "value") | 把指定標頭設為所提供的值。必須在 open() 之後呼叫 |
| 屬性 | 說明 |
|---|---|
onreadystatechange | 每次狀態改變時觸發的事件處理器,通常指定一個 JavaScript 函式 |
readyState | 請求的狀態,有五個可能值(見下表) |
responseText | 伺服器的回應,以字串表示 |
responseXML | 伺服器的回應,以 XML 表示,此物件通常可解析為 DOM |
status | 伺服器 HTTP 狀態碼(200 = OK,404 = Not Found,等) |
statusText | HTTP 狀態碼對應的文字("OK"、"Not Found" 等) |
| 值 | 狀態 | 說明 |
|---|---|---|
| 0 | 未初始化 | 尚未呼叫 open() |
| 1 | 載入中 | 已呼叫 open(),尚未送出 |
| 2 | 已送出 | send() 已呼叫,等待回應 |
| 3 | 接收中 | 正在接收回應內容 |
| 4 | 已完成 | 回應已完整抵達 |
實務上只有在 readyState === 4 且 status === 200 時才該處理回應內容。
| 屬性 | 說明 |
|---|---|
childNodes | 返回當前元素所有子節點的集合 |
firstChild | 返回當前元素的第一個子節點 |
lastChild | 返回當前元素的最後一個子節點 |
nextSibling | 返回緊跟在當前元素後面的節點 |
nodeValue | 表示節點值的讀寫屬性 |
parentNode | 返回元素的父節點 |
previousSibling | 返回緊鄰當前元素之前的節點 |
注意:XML 中標籤之間的換行與空白會被視為文字節點,因此 firstChild 拿到的往往不是你想像的那個元素。實務上會改用 firstElementChild 或先檢查 nodeType。
| 方法 | 說明 |
|---|---|
document.getElementById(id) | 取得文件中具有指定唯一 ID 的元素 |
getElementsByTagName(name) | 返回當前元素中指定標籤名的子元素集合 |
hasChildNodes() | 返回布林值,指示元素是否有子節點 |
getAttribute(name) | 返回由 name 指定的屬性值 |
| 屬性 / 方法 | 說明 |
|---|---|
document.createElement(tagName) | 建立指定標籤名的元素。傳入 "DIV" 就會產生一個 DIV 元素 |
document.createTextNode(text) | 建立一個包含靜態文字的文字節點 |
element.appendChild(childNode) | 把指定節點加入為當前節點的最後一個子節點,例如為 select 增加一個 option |
element.getAttribute(name) | 取得元素中 name 屬性的值 |
element.setAttribute(name, value) | 設定元素中 name 屬性的值 |
element.insertBefore(newNode, targetNode) | 把 newNode 作為子節點插入到 targetNode 之前 |
element.removeAttribute(name) | 從元素中刪除名為 name 的屬性 |
element.removeChild(childNode) | 從元素中刪除子節點 childNode |
element.replaceChild(newNode, oldNode) | 以 newNode 取代 oldNode |
element.hasChildNodes() | 返回布林值,指示元素是否有子節點 |
這張表反映了 Ajax 早期的樣貌。今天寫前端時,有幾件事值得知道:
response.json() 或 JSON.parse(xhr.responseText) 處理即可,不必再走 DOM 解析。children、firstElementChild、nextElementSibling,可避開文字節點的干擾。