browsingContext.contextDestroyed Ereignis

Ereignisdaten

Das params-Feld in der Ereignisbenachrichtigung ist ein Kontextobjekt mit den folgenden Eigenschaften, die den entfernten Kontext und dessen Unterbaum beschreiben:

children

Ein Array von Kontextobjekten, das Kindkontexte darstellt. Dieses Ereignis enthält den vollständigen Unterbaum der entfernten Kindkontexte (maxDepth ist null). Ein leeres Array zeigt an, dass der Kontext keine Kinder hatte.

clientWindow

Ein String, der die ID des Clientfensters enthält, das diesen Kontext enthielt.

context

Ein String, der die ID des entfernten Kontexts enthält.

originalOpener

Ein String, der die ID des Kontexts enthält, der diesen Kontext ursprünglich geöffnet hat. Der Wert ist null, wenn der Kontext direkt geöffnet wurde (nicht durch einen anderen Kontext).

parent

Ein String, der die ID des Elternkontextes enthält. Der Wert ist null, wenn der Kontext keinen Eltern hatte (das heißt, es war ein Top-Level-Kontext). Dieses Feld ist nur für den Top-Level-Kontext in den Ereignisdaten vorhanden.

url

Ein String, der die URL des Kontexts, einschließlich des Fragments, zum Zeitpunkt seiner Entfernung enthält.

userContext

Ein String, der die ID des Benutzerkontextes enthält, der mit diesem Kontext verknüpft ist.

Beschreibung

Wenn das Abonnement mit dem contexts-Parameter auf bestimmte Kontexte beschränkt war, wird die ID des entfernten Kontexts nach der Ausgabe des Ereignisses automatisch aus dem Bereich dieses Abonnements entfernt.

War der entfernte Kontext der einzige Kontext im Bereich des Abonnements, wird das Abonnement selbst automatisch entfernt.

Beispiele

Empfang eines Ereignisses, wenn ein Tab geschlossen wird

Angenommen, Sie haben eine WebDriver BiDi-Verbindung, eine aktive Sitzung und ein Abonnement auf browsingContext.contextDestroyed aktiv.

Wenn Ihr Automatisierungsskript einen Tab mit browsingContext.close schließt, sendet der Browser folgende Benachrichtigung:

{
  "type": "event",
  "method": "browsingContext.contextDestroyed",
  "params": {
    "context": "93ee5bd6-d256-4608-a002-9a8995cc0e5f",
    "children": [],
    "originalOpener": null,
    "url": "https://example.com/",
    "userContext": "default",
    "clientWindow": "08c697a1-2664-447d-9c88-52bcee3bb386",
    "parent": null
  }
}

Empfang eines Ereignisses, wenn ein Tab mit eingebetteten Rahmen geschlossen wird

Angenommen, Sie haben eine WebDriver BiDi-Verbindung, eine aktive Sitzung und ein Abonnement auf browsingContext.contextDestroyed aktiv.

Angenommen, ein Tab, das zwei <iframe>s enthält, wird geschlossen. Der Browser sendet folgende Benachrichtigung, die den vollständigen Unterbaum im children-Feld enthält:

{
  "type": "event",
  "method": "browsingContext.contextDestroyed",
  "params": {
    "context": "93ee5bd6-d256-4608-a002-9a8995cc0e5f",
    "children": [
      {
        "context": "6442450945",
        "children": [],
        "originalOpener": null,
        "url": "https://example.com/frame1.html",
        "userContext": "default",
        "clientWindow": "08c697a1-2664-447d-9c88-52bcee3bb386"
      },
      {
        "context": "15032385537",
        "children": [],
        "originalOpener": null,
        "url": "https://example.com/frame2.html",
        "userContext": "default",
        "clientWindow": "08c697a1-2664-447d-9c88-52bcee3bb386"
      }
    ],
    "originalOpener": null,
    "url": "https://example.com/",
    "userContext": "default",
    "clientWindow": "08c697a1-2664-447d-9c88-52bcee3bb386",
    "parent": null
  }
}

Spezifikationen

Browser-Kompatibilität

Siehe auch

• browsingContext.contextCreated Ereignis
• browsingContext.close Befehl
• browsingContext.getTree Befehl
• session.subscribe Befehl