一、簡介
CORS需要瀏覽器和服務(wù)器同時支持。目前所有瀏覽器都已支持,IE不能低于IE10。
對于開發(fā)者來說,CORS通信與同源的AJAX通信沒有差別,代碼完全一樣,整個CORS通信過程都是瀏覽器自動完成,不需要用戶參與。瀏覽器一旦發(fā)現(xiàn)AJAX請求跨源,就會自動添加一些附加的頭信息,有時還會多出一次附加的請求,但用戶不會有感覺。
因此,實(shí)現(xiàn)CORS通信的關(guān)鍵是服務(wù)器。只要服務(wù)器實(shí)現(xiàn)了CORS接口,就可以實(shí)現(xiàn)跨域通信。
二、兩種請求
瀏覽器將CORS請求分為兩類:簡單請求(simple request)和非簡單請求(not-so-simple request)。
同時滿足以下兩個條件則為簡單請求:
(1) 請求方法是以下三種方法之一:
HEAD
GET
POST
(2)HTTP的頭信息不超出以下幾種字段:
Accept
Accept-Language
Content-Language
Last-Event-ID
Content-Type:只限于三個值application/x-www-form-urlencoded、multipart/form-data、text/plain
凡是不同時滿足上面兩個條件,就屬于非簡單請求。瀏覽器對這兩種請求的處理,是不一樣的。
三、簡單請求
3.1 基本流程
對于簡單請求,瀏覽器直接發(fā)出CORS請求。具體來說,就是在頭信息中增加一個Origin字段。
上面的頭信息中,Origin字段用來說明,本次請求來自哪個源(協(xié)議+域名+端口)。服務(wù)器根據(jù)這個值,決定是否同意這次請求。
如果Origin指定的源不在許可范圍內(nèi),服務(wù)器會返回一個正常的HTTP回應(yīng)。瀏覽器發(fā)現(xiàn),這個回應(yīng)的頭信息沒有包含Access-Control-Allow-Origin字段,就知道出錯了并拋出一個錯誤,被XMLHttpRequest的onerror毀掉函數(shù)捕獲。注意,這種錯誤無法通過狀態(tài)碼識別,因?yàn)镠TTP回應(yīng)的狀態(tài)碼有可能是200。
如果Origin指定的域名在許可范圍內(nèi),服務(wù)器返回的響應(yīng),會多出幾個頭信息字段。
Access-Control-Allow-Origin:http://api.bob.com
Access-Control-Allow-Credentials:true
Access-Control-Expose-Headers:FooBar
Content-Type:text/html; charset=utf-8
上面的頭信息之中,有三個與CORS請求相關(guān)的字段,都以Access-Control-開頭。
(1)Access-Control-Allow-Origin
該字段是必須的。它的值要么是請求時Origin字段的值,要么是一個*,表示接受任意域名的請求。
(2)Access-Control-Allow-Credentials
該字段可選。它的值是一個布爾值,表示是否允許發(fā)送Cookie。默認(rèn)情況下,Cookie不包括在CORS請求之中。設(shè)為true,即表示服務(wù)器明確許可,Cookie可以包含在請求中,一起發(fā)給服務(wù)器。這個值也只能設(shè)為true,如果服務(wù)器不要瀏覽器發(fā)送Cookie,刪除該字段即可。
(3)Access-Control-Expose-Headers
該字段可選。CORS請求時,XMLHttpRequest對象的getResponseHeader()方法只能拿到6個基本字段:Cache-Control、Content-Language、Content-Type、Expires、Last-Modified、Pragma。如果想拿到其他字段,就必須在Access-Control-Expose-Headers里面指定。上面的例子指定,getResponseHeader('FooBar')可以返回FooBar字段的值。
3.2 withCredentials 屬性
上面說到,CORS請求默認(rèn)不發(fā)送Cookie和HTTP認(rèn)證信息。如果要把Cookie發(fā)到服務(wù)器,一方面要服務(wù)器同意,指定Access-Control-Allow-Credentials字段。
Access-Control-Allow-Credentials:true
另一方面,開發(fā)者必須在AJAX請求中打開withCredentials屬性。
varxhr=newXMLHttpRequest();xhr.withCredentials=true;
否則,即使服務(wù)器同意發(fā)送Cookie,瀏覽器也不會發(fā)送。或者,服務(wù)器要求設(shè)置Cookie,瀏覽器也不會處理。
但是,如果省略withCredentials設(shè)置,有的瀏覽器還是會一起發(fā)送Cookie。這時,可以顯式關(guān)閉withCredentials。
xhr.withCredentials=false;
需要注意的是,如果要發(fā)送Cookie,Access-Control-Allow-Origin就不能設(shè)為星號,必須指定明確的、與請求網(wǎng)頁一致的域名。同時,Cookie依然遵循同源政策,只有用服務(wù)器域名設(shè)置的Cookie才會上傳,其他域名的Cookie并不會上傳,且(跨源)原網(wǎng)頁代碼中的document.cookie也無法讀取服務(wù)器域名下的Cookie。