請求:destination 屬性
Baseline 廣泛可用 *
注意:此功能在 Web Workers 中可用。
Request 介面的只讀屬性 destination 返回一個字串,用於描述所請求內容的型別。
該字串必須是 audio、audioworklet、document、embed、fencedframe、font、frame、iframe、image、json、manifest、object、paintworklet、report、script、sharedworker、speculationrules、style、track、video、worker 或 xslt 字串之一,或者為空字串(這是預設值)。
destination 屬性用於 使用者代理,例如,幫助確定遵循哪個規則集以用於 CORS 目的,或者如何導航會影響特定型別請求處理方式的複雜程式碼路徑。
這些 destination 的操作方式有很大差異。有些是資料接收器,接收到的資料將被儲存以供以後處理。其他一些是基於指令碼的,在這種情況下,透過呼叫指令碼並傳遞資料來將接收到的資料傳遞給指令碼。基於指令碼的 destination 包括 <script> 元素,以及任何 Worklet 類 destination(包括子類,如 AudioWorklet),以及 Worker 類 destination,包括 ServiceWorker 和 SharedWorker。
值
一個字串,指示請求所請求內容的型別。此型別比常規文件型別值(如 "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。
-
目標是 shared worker。
"speculationrules"Experimental-
目標是 speculation rules JSON 文件。
"style"-
目標是樣式
"track"-
目標是 HTML
<track>。 "video"-
目標是影片資料。
"worker"-
目標是 worker。
"xslt"-
目標是 XSLT 轉換。
示例
在下面的程式碼片段中,我們使用 Request() 建構函式建立一個新的請求(針對指令碼所在目錄中的一個影像檔案),然後儲存請求的 destination。
const myRequest = new Request("flowers.jpg");
const myDestination = myRequest.destination; // returns the empty string by default
規範
| 規範 |
|---|
| Fetch # ref-for-dom-request-destination① |
瀏覽器相容性
載入中…