Request: credentials 屬性

Baseline 已廣泛支援

此特性已得到良好確立,可跨多種裝置和瀏覽器版本使用。自 2017 年 3 月起,所有瀏覽器均支援此特性。

注意:此功能在 Web Workers 中可用。

Request 介面的只讀屬性 credentials 反映了在 Request() 建構函式中為 credentials 選項提供的值。它決定了瀏覽器是否會發送憑據隨請求傳送,以及是否會響應 Set-Cookie 響應頭。

憑據包括 cookie、TLS 客戶端證書或包含使用者名稱和密碼的身份驗證頭。

有關更多詳細資訊,請參閱 包含憑據

一個字串,其值可能為以下之一:

omit

從不在請求中傳送憑據,也不在響應中包含憑據。

same-origin

僅對同源請求傳送和包含憑據。這是預設值。

include

始終包含憑據,即使對於跨域請求也是如此。

示例

在下面的程式碼片段中,我們使用 Request() 建構函式建立了一個新請求(針對與指令碼位於同一目錄下的影像檔案),然後將請求憑據儲存在一個變數中

js
const request = new Request("flowers.jpg");
const credentials = request.credentials; // returns "same-origin" by default

規範

規範
Fetch
# ref-for-dom-request-credentials②

瀏覽器相容性

另見