Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

Named Cookie Abrufen

Eingeschränkt verfügbar

Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.

Want more browser support for this feature? Tell us why.

Der Named Cookie Abrufen Befehl der WebDriver API gibt das Cookie mit dem angegebenen Namen zurück, das mit dem aktiven Dokument des aktuellen Browsing-Kontexts verknüpft ist.

Syntax

Methode URI-Vorlage
GET /session/{session id}/cookie/{name}

URL-Parameter

session id

Identifikator der Sitzung.

name

Der Name des abzurufenden Cookies.

Rückgabewert

Ein einzelnes Cookie-Objekt mit den folgenden Feldern:

name

Der Name des Cookies.

value

Der Wert des Cookies.

path

Der Pfad des Cookies.

domain

Die Domain, für die das Cookie sichtbar ist.

secure

Ob das Cookie ein sicheres Cookie ist.

httpOnly

Ob das Cookie ein HTTP-only Cookie ist.

expiry

Die Ablaufzeit des Cookies in Sekunden seit dem Unix-Epoch. Für Sitzungs-Cookies weggelassen.

sameSite

Die same-site policy des Cookies. Mögliche Werte sind "Lax", "Strict" und "None". Standardmäßig "None", wenn weggelassen.

Fehler

Es wurde kein Cookie mit dem angegebenen name unter den zugehörigen Cookies des aktiven Dokuments des aktuellen Browsing-Kontexts gefunden.

No such window

Das window-Objekt wurde verworfen, was darauf hinweist, dass die Registerkarte oder das Fenster geschlossen wurde.

Unexpected alert open

Eine Benutzeraufforderung, wie window.alert, blockiert die Ausführung des Befehls, bis sie behandelt wird.

Invalid session id

Die angegebene Sitzung existiert nicht.

Beispiele

Mit einem WebDriver-Server, der auf localhost:4444 läuft, nehmen Sie an, dass eine aktive Sitzung zu einer Seite navigiert ist, die ein session_token Cookie gesetzt hat. Um es abzurufen, hängen Sie den Cookienamen an den Endpunkt an und ersetzen Sie ID mit der sessionId aus der New Session Antwort:

bash
curl -i http://localhost:4444/session/ID/cookie/session_token

Der Server antwortet mit dem übereinstimmenden Cookie-Objekt:

http
HTTP/1.1 200 OK
content-type: application/json; charset=utf-8

{"value":{"name":"session_token","value":"abc123","path":"/","domain":"example.org","secure":true,"httpOnly":false,"sameSite":"Strict"}}

Spezifikationen

Spezifikation
WebDriver
# get-named-cookie

Browser-Kompatibilität

Siehe auch