browsingContext.load event

The browsingContext.load event of the browsingContext module fires when a cross-document navigation has fully completed in a context.

Event data

The params field in the event notification is an object with the following fields:

context

A string that contains the ID of the context in which the document has fully loaded.

A string that contains the UUID that uniquely identifies this navigation. If the navigation was started using the browsingContext.navigate or browsingContext.reload command, this ID matches the navigation value in the command's response. The same ID is shared by all events related to this navigation, including other navigation events in the browsingContext module and events in the network module.

timestamp

A non-negative integer that represents the time when the event was fired, as milliseconds elapsed since the epoch.

url

A string that contains the URL of the document that has fully loaded.

Description

In the lifecycle of a successful navigation, this event fires after browsingContext.domContentLoaded and is the final event in the sequence.

At this point, the document and all its subresources have finished loading, equivalent to the load event firing.

If you set wait to "complete" for the browsingContext.navigate and browsingContext.reload commands, they return as soon as browsingContext.load fires.

Examples

Receiving an event when a document has fully loaded

Assume you have a WebDriver BiDi connection and an active session with a subscription to browsingContext.load.

Suppose you use browsingContext.navigate to load https://example.com, passing the context ID you obtain from browsingContext.getTree.

The browser first fires browsingContext.navigationStarted, browsingContext.navigationCommitted, and browsingContext.domContentLoaded events (you don't receive those notifications because the subscription in this example is only to browsingContext.load).

Once the document and all its subresources have finished loading, the browser sends the following notification, where the context value matches the context ID you passed to browsingContext.navigate:

json
{
  "type": "event",
  "method": "browsingContext.load",
  "params": {
    "context": "5e5e96e8-5247-4f22-9b35-a4a2d841cbaa",
    "navigation": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
    "timestamp": 1782343062410,
    "url": "https://example.com"
  }
}

Specifications

Specification
WebDriver BiDi
# event-browsingContext-load

Browser compatibility

See also