請求:destination 屬性

Baseline 廣泛可用 *

此功能已成熟,可在多種裝置和瀏覽器版本上執行。自 ⁨2018 年 6 月⁩ 起在所有瀏覽器中可用。

* 此特性的某些部分可能存在不同級別的支援。

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

Request 介面的只讀屬性 destination 返回一個字串,用於描述所請求內容的型別。

該字串必須是 audioaudioworkletdocumentembedfencedframefontframeiframeimagejsonmanifestobjectpaintworkletreportscriptsharedworkerspeculationrulesstyletrackvideoworkerxslt 字串之一,或者為空字串(這是預設值)。

destination 屬性用於 使用者代理,例如,幫助確定遵循哪個規則集以用於 CORS 目的,或者如何導航會影響特定型別請求處理方式的複雜程式碼路徑。

這些 destination 的操作方式有很大差異。有些是資料接收器,接收到的資料將被儲存以供以後處理。其他一些是基於指令碼的,在這種情況下,透過呼叫指令碼並傳遞資料來將接收到的資料傳遞給指令碼。基於指令碼的 destination 包括 <script> 元素,以及任何 Worklet 類 destination(包括子類,如 AudioWorklet),以及 Worker 類 destination,包括 ServiceWorkerSharedWorker

一個字串,指示請求所請求內容的型別。此型別比常規文件型別值(如 "document""manifest")更廣泛,並且可能包括上下文線索,如 "image""worker""audioworklet"

可能的值是

""

空字串是預設值,用於沒有自己值的 destination。當使用以下 API(以及其他 API)發出請求時,就是此值:

"audio"

目標是音訊資料。

"audioworklet"

目標是為音訊 worklet 提取的資料。

"document"

目標是文件(HTML 或 XML)。

"embed"

目標是嵌入式內容。

"fencedframe"

目標是 fenced frame

"font"

目標是字型。

"image"

目標是影像。

"json"

目標是 JSON 檔案。

"manifest"

目標是 manifest。

"object"

目標是 object。

"paintworklet"

目標是 paint worklet。

"report"

目標是 report。

"script"

目標是 script。

"serviceworker"

目標是 service worker。

"sharedworker"

目標是 shared worker。

"speculationrules" Experimental

目標是 speculation rules JSON 文件。

"style"

目標是樣式

"track"

目標是 HTML <track>

"video"

目標是影片資料。

"worker"

目標是 worker。

"xslt"

目標是 XSLT 轉換。

示例

在下面的程式碼片段中,我們使用 Request() 建構函式建立一個新的請求(針對指令碼所在目錄中的一個影像檔案),然後儲存請求的 destination。

js
const myRequest = new Request("flowers.jpg");
const myDestination = myRequest.destination; // returns the empty string by default

規範

規範
Fetch
# ref-for-dom-request-destination①

瀏覽器相容性

另見