Cookie hinzufügen
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 Add Cookie Befehl der WebDriver API fügt einen einzelnen Cookie zum Cookie-Speicher des aktiven Dokuments im aktuellen Browsing-Kontext hinzu. Dies entspricht im Wesentlichen dem Setzen von Document.cookie in JavaScript.
Syntax
| Methode | URI-Vorlage |
|---|---|
POST |
/session/{session id}/cookie |
URL-Parameter
session id-
Kennung der Sitzung.
Nutzlast
Die Eingabe ist ein JSON-Objekt mit einem einzelnen cookie-Schlüssel, dessen Wert ein Cookie-Objekt mit den folgenden Feldern ist:
name-
Der Name des Cookies.
value-
Der Cookie-Wert.
pathOptional-
Der Cookie-Pfad. Standardmäßig
"/". domainOptional-
Die Domain, in der der Cookie sichtbar ist. Standardmäßig die Domain des aktuellen Browsing-Kontext-Dokuments.
secureOptional-
Ob der Cookie ein sicherer Cookie ist. Standardmäßig
false. httpOnlyOptional-
Ob der Cookie ein HTTP-only-Cookie ist. Standardmäßig
false. expiryOptional-
Die Ablauffrist des Cookies in Sekunden seit der Unix-Epoche. Dieser Wert muss eine Zahl im Bereich von 0 bis 2^53 − 1 sein. Wenn weggelassen, wird der Cookie als Sitzungscookie behandelt.
sameSiteOptional-
Die Same-Site-Policy des Cookies. Mögliche Werte sind
"Lax","Strict"und"None". Standardmäßig"None", wenn weggelassen.
Rückgabewert
null, wenn erfolgreich.
Fehler
Ungültiges Argument-
Das
cookie-Objekt fehlt, ist kein JSON-Objekt, es fehlt ein erforderliches Feld oder eines seiner Felder erfüllt die Typ- oder Wertbeschränkungen nicht. -
Versuch, einen Cookie auf einer anderen Domain als der Domain des aktuellen Browsing-Kontext-Dokuments zu setzen.
Kein solches Fenster-
Das
window-Objekt wurde verworfen, was darauf hinweist, dass die Registerkarte oder das Fenster geschlossen wurde. -
Das Remote-Ende konnte den Cookie nicht zum Cookie-Speicher hinzufügen.
Unerwartetes geöffnetes Alert-
Eine Benutzeraufforderung, wie
window.alert, blockiert die Ausführung des Befehls, bis sie behandelt wird. Ungültige Sitzungs-ID-
Die angegebene Sitzung existiert nicht.
Beispiele
Hinzufügen eines Cookies
Mit einem WebDriver-Server, der unter localhost:4444 läuft, wird angenommen, dass eine aktive Sitzung nach https://example.org navigiert ist. Um einen Cookie hinzuzufügen, senden Sie das Cookie-Objekt als Anfrage-Nutzlast, wobei Sie ID durch die sessionId aus der Neue Sitzung-Antwort ersetzen:
curl -i -H "Content-Type: application/json" \
-d '{"cookie": {"name": "session_token", "value": "abc123", "secure": true, "sameSite": "Strict"}}' \
http://localhost:4444/session/ID/cookie
Der Server antwortet mit einem Nullwert, um den Erfolg anzuzeigen:
HTTP/1.1 200 OK
content-type: application/json; charset=utf-8
{"value":null}
Spezifikationen
| Spezifikation |
|---|
| WebDriver # add-cookie |