session.status-Befehl
Der session.status Befehl des session Moduls liefert Informationen darüber, ob der Browser in der Lage ist, neue BiDi-Sitzungen zu erstellen. Zudem kann er beliebige Metainformationen enthalten.
Da dieser Befehl verwendet wird, um den Status des Browsers vor der Erstellung einer neuen Sitzung zu überprüfen, wird er ohne eine bereits aktive Sitzung ausgeführt. (In BiDi wird ein solcher Befehl als statischer Befehl bezeichnet.)
Syntax
{
"method": "session.status",
"params": {}
}
Parameter
Keine. Es muss jedoch das params-Feld enthalten und auf ein leeres Objekt ({}) gesetzt werden.
Rückgabewert
Die folgenden Felder im result-Objekt der Antwort beschreiben den aktuellen Status des Browsers:
message-
Ein String mit Informationen über den aktuellen Status des Browsers.
ready-
Ein Boolean, der angibt, ob der Browser bereit ist, neue Sitzungen zu erstellen.
true: Der Browser ist bereit, eine neue Sitzung zu erstellen.false: Der Browser kann keine neuen Sitzungen akzeptieren, da bereits eine aktive Sitzung vorliegt oder der Browser sich in einem Zustand befindet, in dem die Erstellung einer Sitzung fehlschlagen würde.
Beispiele
Überprüfen des Browser-Status vor der Erstellung einer Sitzung
Mit einer hergestellten WebDriver BiDi-Verbindung senden Sie die folgende Nachricht, um zu prüfen, ob der Browser bereit ist, eine neue Sitzung zu erstellen:
{
"id": 1,
"method": "session.status",
"params": {}
}
Wenn der Browser verfügbar ist, antwortet er mit:
{
"id": 1,
"type": "success",
"result": {
"ready": true,
"message": ""
}
}
Wenn der Browser bereits eine aktive Sitzung hat, könnte die Antwort wie folgt aussehen:
{
"id": 1,
"type": "success",
"result": {
"ready": false,
"message": "Session already started"
}
}
Spezifikationen
| Spezifikation |
|---|
| WebDriver BiDi # command-session-status |
Browser-Kompatibilität
Siehe auch
session.newBefehlsession.endBefehl