XMLHttpRequest物件的status屬性代表目前HTTP請求的狀態,是一個長整數值。掌握這些狀態碼的含義,是撰寫健壯AJAX程式、精準處理各種回應的關鍵。以下依類別整理常見的HTTP狀態碼。
100:初始請求已被接受,客戶端應繼續送出其餘部分。(HTTP 1.1新增)
101:伺服器將依客戶端請求切換至另一種協議。(HTTP 1.1新增)
200:一切正常,GET與POST請求的應答文件會附在後方。
201:伺服器已建立文件,其URL位於Location標頭。
202:請求已接受,但處理尚未完成。
203:文件已正常回傳,但因採用副本,部分應答標頭可能並非權威資訊。(HTTP 1.1新增)
204:沒有新文件,瀏覽器應繼續顯示原文件。若使用者定期刷新,而伺服器判定文件仍夠新,此狀態碼相當實用。
205:沒有新內容,但瀏覽器應重置顯示內容,常用於強制清除表單輸入。(HTTP 1.1新增)
206:客戶端帶有Range標頭送出GET請求,伺服器已完成該部分內容。(HTTP 1.1新增)
300:請求的文件可在多處找到,位置已列於回傳文件中;若伺服器有優先選擇,應在Location標頭指明。
301:文件已永久搬移,新URL在Location標頭中提供,瀏覽器應自動前往。
302:類似301,但新URL視為暫時性替代。瀏覽器通常能自動前往新URL,因此相當實用。嚴格而言,只有在原始請求為GET時,瀏覽器才會自動導向。
303:類似301/302,但差別在於:若原始請求為POST,則Location標頭所指的文件應以GET方式擷取。(HTTP 1.1新增)
304:客戶端已有緩衝文件並發出條件式請求(通常帶有If-Modified-Since標頭),伺服器告知客戶端原緩衝文件仍可繼續使用。
305:請求的文件應透過Location標頭所指的代理伺服器擷取。(HTTP 1.1新增)
307:與302相同。由於許多瀏覽器會錯誤地對302進行導向,HTTP 1.1新增307以清楚區分:出現303時瀏覽器可跟隨GET與POST的導向;而出現307時,只能跟隨GET請求的導向。(HTTP 1.1新增)
400:請求出現語法錯誤。
401:存取被拒絕,客戶端試圖未經授權存取受密碼保護的頁面。應答會包含WWW-Authenticate標頭,瀏覽器據此顯示帳號密碼對話框。
404:找不到指定位置的資源,這是最常見的應答之一。
405:請求方法(GET、POST、HEAD、DELETE、PUT、TRACE等)對指定資源不適用。(HTTP 1.1新增)
406:資源已找到,但其MIME類型與客戶端Accept標頭指定的不相容。(HTTP 1.1新增)
407:需要代理伺服器身分驗證,類似401,表示客戶端須先通過代理授權。(HTTP 1.1新增)
408:在伺服器允許的等待時間內,客戶端一直未送出請求,之後可重複同一請求。(HTTP 1.1新增)
409:通常與PUT請求有關,因請求與資源目前狀態衝突而無法成功。(HTTP 1.1新增)
410:請求的文件已不再可用,且伺服器不知該導向何處。與404不同,410表示文件已永久離開該位置。(HTTP 1.1新增)
411:除非客戶端送出Content-Length標頭,否則伺服器無法處理請求。(HTTP 1.1新增)
412:請求標頭中指定的部分前提條件失敗。(HTTP 1.1新增)
413:請求實體過大,超過伺服器目前願意處理的大小。(HTTP 1.1新增)
414:請求URI過長。(HTTP 1.1新增)
415:不支援的媒體類型。
416:伺服器無法滿足請求中指定的Range標頭。(HTTP 1.1新增)
417:執行失敗。
423:鎖定錯誤。
500:伺服器遇到意料之外的情況,無法完成請求。
501:伺服器不支援完成請求所需的功能。
502:伺服器作為閘道或代理時,從下一台伺服器收到非法應答。
503:服務暫時無法使用,伺服器因維護或負載過重而未回應。例如資料庫連線池已滿時可能回傳503,並可附上Retry-After標頭。
504:閘道逾時,由作為代理或閘道的伺服器使用,表示無法及時從遠端取得應答。(HTTP 1.1新增)
505:伺服器不支援請求中指定的HTTP版本。(HTTP 1.1新增)
熟悉這些狀態碼,能幫助你在AJAX程式中精準判斷請求結果,給出合適的回饋或錯誤處理。