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: Dieses Feature ist verfügbar in Web Workers.

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:

js
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

Siehe auch