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 Juni 2018.
* Some parts of this feature may have varying levels of support.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die destination schreibgeschützte Eigenschaft der Request-Schnittstelle gibt einen String zurück, der den angeforderten Inhaltstyp beschreibt.
Der String muss einer der folgenden Werte sein: audio, audioworklet, document, embed, fencedframe, font, frame, iframe, image, json, manifest, object, paintworklet, report, script, sharedworker, speculationrules, style, track, video, worker oder xslt. Der leere String ist der Standardwert.
Die destination wird vom User-Agent verwendet, um beispielsweise zu bestimmen, welche Regelmenge für CORS-Zwecke anzuwenden ist oder wie schwierig zu navigierende Codewege behandelt werden, die beeinflussen, wie bestimmte Anfragetypen gehandhabt werden.
Diese Zielorte unterscheiden sich erheblich in ihrer Funktionsweise. Einige sind Datenempfänger, bei denen die empfangenen Daten zur späteren Verarbeitung gespeichert werden. Andere sind skriptbasiert, wobei die empfangenen Daten an ein Skript weitergegeben werden, indem es aufgerufen wird und die Daten übergeben werden.
Skriptbasierte Zielorte umfassen <script>-Elemente sowie alle auf Worklet basierenden Zielorte (einschließlich Unterklassen wie AudioWorklet) und die auf Worker basierenden Zielorte, einschließlich ServiceWorker und SharedWorker.
Wert
Ein String, der den Inhaltstyp angibt, den die Anfrage anfordert. Dieser Typ ist viel breiter als die üblichen Dokumenttyp-Werte (wie "document" oder "manifest") und kann kontextbezogene Hinweise wie "image" oder "worker" oder "audioworklet" beinhalten.
Mögliche Werte sind:
""-
Der leere String ist der Standardwert und wird für Zielorte verwendet, die keinen eigenen Wert haben. Dies ist der Wert, wenn Anfragen mit den folgenden APIs gestellt werden (unter anderem):
"audio"-
Das Ziel ist Audiodaten.
"audioworklet"-
Das Ziel sind Daten, die für die 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"Experimentell-
Das Ziel ist ein JSON-Dokument mit Speculation Rules.
"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 Schnipsel erstellen wir eine neue Anfrage mit dem Request() Konstruktor (für eine Bilddatei im selben Verzeichnis wie das Skript) und speichern dann das Ziel 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① |
Browser-Kompatibilität
Loading…