Neue Sitzung
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
Der Neue Sitzung Befehl der WebDriver API erstellt eine neue WebDriver-Sitzung mit dem Browser. Die im Antwortobjekt zurückgegebene Sitzungskennung ist für alle nachfolgenden Befehle erforderlich.
Syntax
| Methode | URI-Vorlage |
|---|---|
POST |
/session |
Nutzlast
capabilities-
Wird verwendet, um die Merkmale zu definieren, die der Treiber erfüllen muss, wenn eine neue Sitzung erstellt wird. Siehe Capabilities für verfügbare Optionen.
Antwort
Die Antwortnutzlast ist ein JSON-Objekt mit:
sessionId-
Die eindeutige Kennung der Sitzung.
capabilities-
Die ausgehandelten Merkmale der Sitzung.
Fehler
- Sitzung nicht erstellt
-
Eine neue Sitzung konnte nicht erstellt werden.
Beispiele
Starten einer neuen Sitzung
Mit einem WebDriver-Server, der auf localhost:4444 läuft, startet der folgende Befehl eine neue WebDriver-Sitzung, die Firefox als Browser anfordert:
curl -i -H "Content-Type: application/json" -d '{"capabilities": {"alwaysMatch": {"browserName": "firefox"}}}' http://localhost:4444/session
Die Ausgabe wird ähnlich wie folgt aussehen, wobei 27c8437e-5e42-43f9-a26f-2db0fd509ec1 die eindeutige Kennung dieser Sitzung ist:
HTTP/1.1 200 OK
content-type: application/json; charset=utf-8
{"value":{"sessionId":"27c8437e-5e42-43f9-a26f-2db0fd509ec1","capabilities":{"acceptInsecureCerts":false,"browserName":"firefox","browserVersion":"147.0.4","pageLoadStrategy":"normal","platformName":"mac","proxy":{},"setWindowRect":true,"strictFileInteractability":false,"timeouts":{"implicit":0,"pageLoad":300000,"script":30000}}}}
Spezifikationen
| Spezifikation |
|---|
| WebDriver # new-session |