`mode`-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.
* Some parts of this feature may have varying levels of support.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die schreibgeschützte mode-Eigenschaft des Request-Interfaces enthält den Modus der Anfrage (z.B. cors, no-cors, same-origin oder navigate). Diese wird verwendet, um festzustellen, ob Cross-Origin-Anfragen zu gültigen Antworten führen und welche Eigenschaften der Antwort lesbar sind.
Um eine Anfrage mit einem spezifischen Modus zu erstellen, übergeben Sie den gewünschten Wert als RequestInit.mode-Option an den Request.Request()-Konstruktor.
Beachten Sie, dass das Setzen bestimmter Modi, insbesondere no-cors, Einschränkungen für die verwendbaren Anfragemethoden und Header mit sich bringt und JavaScript daran hindert, auf die Antwortheader oder den -körper zuzugreifen. Weitere Details finden Sie in der Dokumentation zu RequestInit.mode.
Wert
Einer der folgenden Werte:
same-origin-
Verbietet Cross-Origin-Anfragen. Wenn eine Anfrage an einen anderen Ursprung mit diesem Modus gestellt wird, führt dies zu einem Fehler.
no-cors-
Deaktiviert CORS für Cross-Origin-Anfragen. Die Antwort ist undurchsichtig, was bedeutet, dass ihre Header und ihr Körper für JavaScript nicht zugänglich sind.
cors-
Wenn die Anfrage Cross-Origin ist, wird der Mechanismus des Cross-Origin Resource Sharing (CORS) verwendet.
-
Ein Modus zur Unterstützung der Navigation. Der
navigate-Wert ist nur für die HTML-Navigation vorgesehen. Eine Navigationsanfrage wird nur während der Navigation zwischen Dokumenten erstellt.
Standardmodus
Anfragen können auf verschiedene Arten initiiert werden, und der Modus für eine Anfrage hängt von der speziellen Methode ab, mit der sie initiiert wurde.
Zum Beispiel wird, wenn ein Request-Objekt mit dem Request()-Konstruktor erstellt wird, der Wert der mode-Eigenschaft für diese Request auf cors gesetzt.
Für Anfragen, die nicht durch den Request()-Konstruktor erstellt werden, wird typischerweise no-cors als Modus verwendet; zum Beispiel für eingebettete Ressourcen, bei denen die Anfrage aus einem Markup heraus initiiert wird, es sei denn, das crossorigin-Attribut ist vorhanden. In den meisten Fällen wird die Anfrage im no-cors-Modus gestellt – das ist der Fall bei den <link>- oder <script>-Elementen (außer wenn sie mit Modulen verwendet werden) oder bei den <img>, <audio>, <video>, <object>, <embed> oder <iframe>-Elementen.
Beispiele
Im folgenden Snippet erstellen wir eine neue Anfrage mit dem Request()-Konstruktor (für eine Bilddatei im gleichen Verzeichnis wie das Skript) und speichern dann den Anfragemodus in einer Variablen:
const myRequest = new Request("flowers.jpg");
const myMode = myRequest.mode; // returns "cors" by default
Spezifikationen
| Specification |
|---|
| Fetch # ref-for-dom-request-mode② |