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, und kann zusätzlich beliebige Meta-Informationen enthalten.

Da dieser Befehl verwendet wird, um den Status des Browsers vor dem Erstellen 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

json

{
  "method": "session.status",
  "params": {}
}

Parameter

Keine. Sie müssen jedoch das params-Feld einfügen und auf ein leeres Objekt ({}) setzen.

Rückgabewert

Das result-Objekt in der Antwort mit den folgenden Feldern:

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 besteht oder er sich in einem Zustand befindet, in dem das Erstellen einer Sitzung fehlschlagen würde.

message

Ein String mit Informationen über den aktuellen Status des Browsers.

Beispiele

Überprüfen des Browserstatus vor der Erstellung einer Sitzung

Nachdem eine WebDriver BiDi Verbindung hergestellt wurde, senden Sie die folgende Nachricht, um zu überprüfen, ob der Browser bereit ist, eine neue Sitzung zu erstellen:

json

{
  "id": 1,
  "method": "session.status",
  "params": {}
}

Wenn der Browser verfügbar ist, antwortet er mit:

json

{
  "id": 1,
  "type": "success",
  "result": {
    "ready": true,
    "message": ""
  }
}

Falls der Browser bereits eine aktive Sitzung hat, könnte die Antwort wie folgt aussehen:

json

{
  "id": 1,
  "type": "success",
  "result": {
    "ready": false,
    "message": "Session already started"
  }
}

Spezifikationen

Specification
WebDriver BiDi # command-session-status

Browser-Kompatibilität

Siehe auch

session.new Befehl
session.end Befehl

Help improve MDN

Learn how to contribute Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden