Anfrage: 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.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die destination schreibgeschützte Eigenschaft des Request-Interfaces gibt einen Zeichenfolgenwert zurück, der den Typ des angeforderten Inhalts beschreibt.
Der Zeichenfolgenwert muss einer der folgenden sein: audio, audioworklet, document, embed, fencedframe, font, frame, iframe, image, json, manifest, object, paintworklet, report, script, sharedworker, speculationrules, style, track, video, worker oder xslt, oder die leere Zeichenfolge, die der Standardwert ist.
Die destination wird vom Benutzeragenten verwendet, um beispielsweise zu bestimmen, welche Regelmenge für CORS-Zwecke befolgt werden soll oder wie komplexe Codepfade navigiert werden, die beeinflussen, wie bestimmte Arten von Anfragen verarbeitet werden.
Diese Ziele unterscheiden sich erheblich in ihrer Funktionsweise. Einige sind Datenspeicher, 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 übergeben, indem es aufgerufen wird.
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
Eine Zeichenfolge, die den Typ des Inhalts angibt, der von der Anfrage angefordert wird. Dieser Typ ist weitaus breiter als die üblichen Dokumenttyp-Werte (wie "document" oder "manifest") und kann kontextuelle Hinweise wie "image" oder "worker" oder "audioworklet" enthalten.
Mögliche Werte sind:
""-
Die leere Zeichenfolge 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 sind Audiodaten.
"audioworklet"-
Das Ziel sind Daten, die für die Nutzung durch eine 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 Nicht standardisiert-
Das Ziel ist ein speculation rules JSON-Dokument.
"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…