Request: destination プロパティ

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2017.

destinationRequest インターフェイスの読み取り専用プロパティで、リクエストされたコンテンツの種類を記述した文字列を返します。

この文字列は、 audio, audioworklet, document, embed, fencedframe, font, frame, iframe, image, json, manifest, object, paintworklet, report, script, sharedworker, style, track, video, worker, xslt、または空文字列(既定値)の何れかでなければなりません。

この destinationユーザーエージェントによって使用され、例えば、 CORS のためにどのルールに従うべきか、あるいは特定の型の入力がどのように処理されるかに影響する複雑なコードパスをどのようにナビゲートするかを決定するのに役に立ちます。

これらの出力先によって、その処理方法は大きく異なります。あるものはデータを受け取るもので、受け取ったデータは後で処理するために格納さ れます。他にもスクリプトベースのものがあり、その場合は受け取ったデータはスクリプトを呼び出してデータを渡すことで配信されます。スクリプトベースの出力先には <script> 要素、 Worklet ベースの出力先(AudioWorklet などのサブクラスも含む)、 Worker ベースの出力先(ServiceWorkerSharedWorker など)が含まれます。

リクエストが要求したコンテンツの型を示す文字列。この型は通常の文書型の値("document""manifest")よりもはるかに広く、"image""worker""audioworklet" などのコンテキストに応じた手がかりを含んだものである可能性があります。

使用可能な値は以下の通りです。

""

空文字列は既定値であり、独自の値を持たない出力先に対して使用されます。これは、以下の API(その他多数)を使用してリクエストが行われた場合の値です。

"audio"

対象は音声データです。

"audioworklet"

対象は、音声ワークレットを使用するために取得されるデータです。

"document"

対象は文書(HTML または XML)です。

"embed"

対象は埋め込みコンテンツです。

"fencedframe"

対象はフェンスフレームです。

"font"

対象はフォントです。

"image"

対象は画像です。

"json"

対象は JSON ファイルです。

"manifest"

対象はマニフェストです。

"object"

対象はオブジェクトです。

"paintworklet"

対象は描画ワークレットです。

"report"

対象はレポートです。

"script"

対象はスクリプトです。

"serviceworker"

対象はサービスワーカーです。

"sharedworker"

対象は共有ワーカーです。

"style"

対象はスタイルです。

"track"

対象は HTML の <track> です。

"video"

対象は動画データです。

"worker"

対象はワーカーです。

"xslt"

対象は XSLT 変換です。

以下のスニペットでは、Request()コンストラクターを使用して新しいリクエストを作成し(スクリプトと同じディレクトリーの画像ファイルに対して)、リクエスト出力先を保存しています。

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

仕様書

Specification
Fetch Standard
# ref-for-dom-request-destination①

ブラウザーの互換性

BCD tables only load in the browser

関連情報