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:

js
const request = new Request("flowers.jpg");
const credentials = request.credentials; // returns "same-origin" by default

Spezifikationen

Specification
Fetch
# ref-for-dom-request-credentials②

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
credentials
Default value same-origin

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support

Siehe auch