DIV CSS 佈局教程網

JavaScript 中的 AJAX:從 XMLHttpRequest 到跨瀏覽器相容實作
編輯:關於JavaScript     

AJAX 讓網頁能在不重新載入整頁的情況下與伺服器交換資料,是現代 Web 應用互動性的基礎。本文從建立 XMLHttpRequest 物件的相容寫法開始,走過一次完整的請求生命週期。

一、相容地取得 XMLHttpRequest 物件

標準瀏覽器直接有 window.XMLHttpRequest,舊版 IE 則要透過 ActiveX 建立,且不同 IE 版本對應不同的 ProgID。

var xhr = null;

if (window.XMLHttpRequest) {
  // 標準瀏覽器
  xhr = window.XMLHttpRequest;
} else if (window.ActiveXObject) {
  // 舊版 IE
  try {
    // 高版本,受 msxml3.dll 支援
    xhr = new ActiveXObject("Msxml2.XMLHTTP");
  } catch (e) {
    try {
      // 低版本,msxml 2.6 以下
      xhr = new ActiveXObject("Microsoft.XMLHTTP");
    } catch (e) {
      alert("瀏覽器無法建立 XMLHttpRequest 物件!");
    }
  }
}

在今天的環境中這段程式碼可以簡化成 var xhr = new XMLHttpRequest();。保留它主要是為了理解歷史脈絡,以及維護老系統時的參考。

二、完整的請求流程

// 1. 設定請求:方法、網址、是否非同步
xhr.open("POST", url, true);

// 2. 以表單格式送出時,需明確指定 Content-Type
xhr.setRequestHeader("Content-Type", "application/x-www-form-urlencoded");

// 3. 綁定狀態變化處理器
xhr.onreadystatechange = stateChangeHandler;

// 4. 送出主體(GET 請求傳 null)
xhr.send();
// 若要帶參數:xhr.send("name=clf");

三、狀態變化處理器

function stateChangeHandler() {
  // readyState 4 = 請求完成;status 200 = 成功
  if (xhr.readyState == 4 && xhr.status == 200) {
    var obj = document.getElementById("targetDiv");
    obj.innerHTML = xhr.responseText;
  }
}

四、readyState 的五個階段

理解這個值是除錯的關鍵:

值狀態說明
0UNSENT尚未呼叫 open()
1OPENEDopen() 已呼叫,尚未 send()
2HEADERS_RECEIVEDsend() 已呼叫,回應標頭已抵達
3LOADING正在接收回應本文
4DONE資料傳輸完成

注意 readyState 的拼字——全小寫的 s。原範例中寫成 xhr.readystate 雖然在 JS 中不會報錯,但因為屬性名區分大小寫,這個判斷永遠為 false,回呼函式會安靜地什麼都不做。這是 this 類拼寫錯誤特別難查的原因。

五、三種回應屬性

responseText:回應本文,永遠是字串。
responseXML:若回應的 Content-Type 是 XML,瀏覽器會自動解析成文件物件,可直接用 DOM 方法查詢。
response:可搭配 responseType 取得 "json"、"blob"、"arraybuffer" 等型別的資料。

六、錯誤處理不可省略

只判斷 status == 200 是不夠的。伺服器可能回傳 404、500,網路也可能直接中斷:

xhr.onreadystatechange = function () {
  if (xhr.readyState !== 4) { return; }

  if (xhr.status === 200) {
    document.getElementById("targetDiv").innerHTML = xhr.responseText;
  } else {
    console.error("請求失敗:", xhr.status, xhr.statusText);
  }
};

// 網路層級的錯誤(請求根本沒送達)
xhr.onerror = function () {
  console.error("網路錯誤");
};

七、現代寫法:fetch 與 async/await

原生 XMLHttpRequest 的 API 設計以回呼為中心,巢狀一多就很難讀。ES2015 之後的 fetch 回傳 Promise,語意清楚得多:

fetch(url, {
  method: 'POST',
  headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
  body: 'name=clf'
})
.then(function (response) {
  if (!response.ok) {
    throw new Error('HTTP ' + response.status);
  }
  return response.text();
})
.then(function (text) {
  document.getElementById("targetDiv").innerHTML = text;
})
.catch(function (err) {
  console.error(err);
});

若環境支援 async/await,可以寫得更接近同步程式碼的可讀性:

async function loadContent() {
  try {
    var response = await fetch(url);
    if (!response.ok) { throw new Error('HTTP ' + response.status); }
    var data = await response.json();
    render(data);
  } catch (err) {
    console.error(err);
  }
}

要留意 fetch 有兩個容易踩的點:一是它不會在 HTTP 錯誤狀態(4xx、5xx)時 reject,必須自己檢查 response.ok;二是它預設不帶 cookie,需要跨來源請求時得明確加上 credentials: 'include'。

八、實務上的其他考量

請求應加上逾時控制,避免使用者面對無限期的等待旋轉:xhr.timeout = 10000; 搭配 xhr.ontimeout,或用 AbortController 取消 fetch。此外,把使用者輸入直接塞進 innerHTML 會造成 XSS 風險,若內容可能含有標籤,應改用 textContent 或先做適當的轉義處理。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved