Request: destination-Eigenschaft
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.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die destination schreibgeschützte
Eigenschaft der Request Schnittstelle gibt einen String zurück,
der die Art des angeforderten Inhalts beschreibt.
Der String muss einer der folgenden sein: audio, audioworklet,
document, embed, fencedframe, font, frame,
iframe, image, json, manifest, object,
paintworklet, report, script, sharedworker,
style, track, video, worker
oder xslt, oder der leere String, der der Standardwert ist.
Das destination wird vom User-Agent verwendet, um beispielsweise
zu bestimmen, welche Regelsets für CORS-Zwecke befolgt werden sollen, oder wie komplizierte Codepfade
navigiert werden, die beeinflussen, wie bestimmte Anfragen behandelt werden.
Diese Ziele unterscheiden sich erheblich in ihrer Funktionsweise. Einige sind Datenbehälter,
in denen die empfangenen Daten zur späteren Verarbeitung gespeichert werden. Andere basieren auf Skripten,
in diesem Fall werden die empfangenen Daten an ein Skript geliefert, indem es aufgerufen wird und die Daten
weitergereicht werden. Skript-basierte Ziele umfassen <script>-Elemente sowie
alle auf Worklet basierenden Ziele (einschließlich Unterklassen wie
AudioWorklet) und die auf Worker
basierenden Ziele, einschließlich ServiceWorker und
SharedWorker.
Wert
Ein String, der den Inhaltstyp angibt, der durch die Anfrage angefordert wird. Dieser Typ ist viel breiter als die
üblichen Dokumenttypparameter (wie "document" oder "manifest") und kann kontextuelle Hinweise wie
"image" oder "worker" oder "audioworklet" umfassen.
Mögliche Werte sind:
""-
Der leere String ist der Standardwert und wird für Ziele verwendet, die keinen eigenen Wert haben. Dies ist der Wert, wenn Anfragen mit den folgenden APIs (unter anderem) gestellt werden:
"audio"-
Das Ziel ist Audiodaten.
"audioworklet"-
Das Ziel sind Daten, die für die Verwendung durch ein Audioworklet abgerufen werden.
"document"-
Das Ziel ist ein Dokument (HTML oder XML).
"embed"-
Das Ziel ist eingebetteter Inhalt.
"fencedframe"-
Das Ziel ist ein fenced frame.
"font"-
Das Ziel ist eine Schriftart.
"image"-
Das Ziel ist ein Bild.
"json"-
Das Ziel ist eine JSON-Datei.
"manifest"-
Das Ziel ist ein Manifest.
"object"-
Das Ziel ist ein Objekt.
"paintworklet"-
Das Ziel ist ein Paint Worklet.
"report"-
Das Ziel ist ein Bericht.
"script"-
Das Ziel ist ein Skript.
"serviceworker"-
Das Ziel ist ein Service Worker.
-
Das Ziel ist ein Shared Worker.
"style"-
Das Ziel ist ein Stil.
"track"-
Das Ziel ist ein HTML
<track>. "video"-
Das Ziel sind Videodaten.
"worker"-
Das Ziel ist ein Worker.
"xslt"-
Das Ziel ist eine XSLT-Transformation.
Beispiele
Im folgenden Snippet erstellen wir eine neue Anfrage mit dem
Request()-Konstruktor (für eine Bilddatei im gleichen
Verzeichnis wie das Skript), dann speichern wir das destination der Anfrage:
const myRequest = new Request("flowers.jpg");
const myDestination = myRequest.destination; // returns the empty string by default
Spezifikationen
| Specification |
|---|
| Fetch # ref-for-dom-request-destination① |