Request: destination-Eigenschaft
Baseline
Weitgehend verfügbar
*
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juni 2018 browserübergreifend verfügbar.
* Einige Teile dieser Funktion werden möglicherweise unterschiedlich gut unterstützt.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die schreibgeschützte Eigenschaft destination der Schnittstelle Request gibt einen String zurück, der den Typ des angeforderten Inhalts beschreibt.
Der String muss einer der Werte audio, audioworklet, document, embed, fencedframe, font, frame, iframe, image, json, manifest, object, paintworklet, report, script, sharedworker, speculationrules, style, text, track, video, worker oder xslt oder der leere String sein. Der leere String ist der Standardwert.
Der User-Agent verwendet destination beispielsweise, um zu bestimmen, welche Regeln für CORS gelten oder wie komplexe Codepfade durchlaufen werden, die die Verarbeitung bestimmter Anfragetypen beeinflussen.
Diese Ziele unterscheiden sich erheblich in ihrer Funktionsweise. Bei einigen wird der empfangene Inhalt gespeichert, um ihn später zu verarbeiten. Andere sind skriptbasiert: In diesem Fall werden die empfangenen Daten an ein Skript übergeben, indem es aufgerufen wird.
Zu den skriptbasierten Zielen gehören <script>-Elemente sowie alle auf Worklet basierenden Ziele (einschließlich Unterklassen wie AudioWorklet) und die auf Worker basierenden Ziele, darunter ServiceWorker und SharedWorker.
Wert
Ein String, der den Typ des angeforderten Inhalts angibt. Dieser Typ ist wesentlich weiter gefasst als die üblichen Dokumenttypwerte (etwa "document" oder "manifest") und kann kontextbezogene Angaben wie "image", "worker" oder "audioworklet" enthalten.
Mögliche Werte sind:
""-
Der leere String ist der Standardwert und wird für Ziele verwendet, denen kein eigener Wert zugeordnet ist. Dies ist unter anderem der Wert für Anfragen, die mit den folgenden APIs gestellt werden:
"audio"-
Das Ziel sind Audiodaten.
"audioworklet"-
Das Ziel sind Daten, die zur Verwendung durch ein Audio-Worklet 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.
"speculationrules"-
Das Ziel ist ein JSON-Dokument mit Speculation Rules.
"style"-
Das Ziel ist ein Stylesheet.
"text"-
Das Ziel ist eine Textdatei.
"track"-
Das Ziel ist ein HTML-
<track>-Element. "video"-
Das Ziel sind Videodaten.
"worker"-
Das Ziel ist ein Worker.
"xslt"-
Das Ziel ist eine XSLT-Transformation.
Beispiele
Im folgenden Codeausschnitt erstellen wir mit dem Request()-Konstruktor eine neue Anfrage für eine Bilddatei im selben Verzeichnis wie das Skript und speichern anschließend das Ziel der Anfrage:
const myRequest = new Request("flowers.jpg");
const myDestination = myRequest.destination; // returns the empty string by default
Spezifikationen
| Spezifikation |
|---|
| Fetch # ref-for-dom-request-destination① |