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 destination schreibgeschützte Eigenschaft des Request-Interfaces gibt einen String zurück, der den Typ 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, speculationrules, style, text, track, video, worker oder xslt, oder der leere String, welcher der Standardwert ist.
Die destination wird vom user agent verwendet, um zum Beispiel festzustellen, welches Regelwerk für CORS-Zwecke befolgt werden soll oder um durch komplizierte Codepfade zu navigieren, die beeinflussen, wie bestimmte Typen von Anfragen verarbeitet werden.
Diese Ziele variieren erheblich in ihrer Funktionsweise. Einige sind Datenbehälter, in denen die empfangenen Daten zur späteren Verarbeitung gespeichert werden. Andere sind skriptbasiert, in diesem Fall werden die empfangenen Daten einem Skript übergeben, indem es aufgerufen wird und die Daten weitergeleitet werden.
Skriptbasierte 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 Typ des Inhalts angibt, nach dem die Anfrage fragt. Dieser Typ ist viel breiter als die üblichen Dokumenttypwerte (wie "document" oder "manifest") und kann kontextuelle Hinweise wie "image", "worker" oder "audioworklet" enthalten.
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 über die folgenden APIs gestellt werden (unter anderem):
"audio"-
Das Ziel sind Audiodaten.
"audioworklet"-
Das Ziel sind Daten, die für die Verwendung durch ein Audio Worklet angefordert 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 Speculation Rules JSON-Dokument.
"style"-
Das Ziel ist ein Stil
"text"-
Das Ziel ist eine Textdatei.
"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 Beispiel erstellen wir eine neue Anfrage mit dem Request()-Konstruktor (für eine Bilddatei im selben Verzeichnis wie das Skript) und speichern dann die destination 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① |