Request: credentials-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.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die schreibgeschützte credentials-Eigenschaft des Request-Interfaces spiegelt den Wert wider, der dem Request()-Konstruktor in der credentials-Option gegeben wurde. Sie bestimmt, ob der Browser Anmeldeinformationen mit der Anfrage sendet und ob die Set-Cookie-Antwortheader berücksichtigt werden.
Anmeldeinformationen sind Cookies, TLS-Clientzertifikate oder Authentifizierungsheader, die einen Benutzernamen und ein Passwort enthalten.
Weitere Details finden Sie unter Einschließen von Anmeldeinformationen.
Wert
Ein String mit einem der folgenden Werte:
omit-
Niemals Anmeldeinformationen in der Anfrage senden oder in der Antwort einschließen.
same-origin-
Nur Anmeldeinformationen für gleiche Herkunft-Anfragen senden und einschließen.
include-
Anmeldeinformationen immer einschließen, auch bei Cross-Origin-Anfragen.
Beispiele
Im folgenden Ausschnitt erstellen wir eine neue Anfrage mit dem Request()-Konstruktor (für eine Bilddatei im gleichen Verzeichnis wie das Skript) und speichern dann die Anmeldeinformationen der Anfrage in einer Variablen:
const request = new Request("flowers.jpg");
const request = request.request; // returns "same-origin" by default
Spezifikationen
| Specification |
|---|
| Fetch Standard # ref-for-dom-request-credentials② |
Browser-Kompatibilität
BCD tables only load in the browser