Anfrage: 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 der Request-Schnittstelle spiegelt den im Request()-Konstruktor angegebenen Wert im credentials-Option wider. Sie bestimmt, ob der Browser Anmeldeinformationen mit der Anfrage sendet sowie ob Set-Cookie-Antwortheader berücksichtigt werden.
Anmeldeinformationen sind Cookies, TLS-Client-Zertifikate 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-
Anmeldeinformationen nur für gleichherzige Anfragen senden und einschließen.
include-
Immer Anmeldeinformationen einschließen, auch für Cross-Origin-Anfragen.
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 Anmeldeinformationen der Anfrage in einer Variable:
const request = new Request("flowers.jpg");
const credentials = request.credentials; // returns "same-origin" by default
Spezifikationen
| Specification |
|---|
| Fetch Standard # ref-for-dom-request-credentials② |
Browser-Kompatibilität
BCD tables only load in the browser