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
nameunter 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
>Cookie nach Name abrufen
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:
curl -i http://localhost:4444/session/ID/cookie/session_token
Der Server antwortet mit dem übereinstimmenden Cookie-Objekt:
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> |