browsingContext.contextDestroyed-Ereignis

Ereignisdaten

Das params-Feld in der Ereignisbenachrichtigung ist ein Kontextobjekt mit den folgenden Feldern, 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 Client-Fensters enthält, das diesen Kontext enthielt.

context

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

originalOpener

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

parent

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

url

Ein String, der die URL des Kontextes enthält, einschließlich des Fragments, zum Zeitpunkt, als er entfernt wurde.

userContext

Ein String, der die ID des Benutzerkontexts enthält, der mit diesem Kontext verbunden ist.

Beschreibung

Wenn das Abonnement mit dem Parameter contexts auf bestimmte Kontexte begrenzt war, wird die ID des entfernten Kontextes nach der Auslösung des Ereignisses automatisch aus dem Gültigkeitsbereich dieses Abonnements entfernt.

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

Beispiele

Ereignis erhalten, wenn ein Tab geschlossen wird

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

Wenn Ihr Automatisierungsskript einen Tab mit browsingContext.close schließt, sendet der Browser die 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
  }
}

Ereignis erhalten, wenn ein Tab mit Kinderframes geschlossen wird

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

Angenommen, ein Tab mit zwei <iframe>s wird geschlossen. Der Browser sendet die 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