Browsing Context

This section contains the APIs related to browsing context commands.

Open a new window

Creates a new browsing context in a new window.

    @Test
Check code on GitHub

Add Example

Add Example

Add Example

Open a new tab

Creates a new browsing context in a new tab.

    void testCreateAWindowWithAReferenceContext() {
Check code on GitHub

Add Example

Add Example

Add Example

Use existing window handle

Creates a browsing context for the existing tab/window to run commands.

    }
Check code on GitHub

Add Example

Add Example

Add Example

Open a window with a reference browsing context

A reference browsing context is a top-level browsing context. The API allows to pass the reference browsing context, which is used to create a new window. The implementation is operating system specific.


    @Test
    void testCreateAWindow() {
Check code on GitHub

Add Example

Add Example

Add Example

Open a tab with a reference browsing context

A reference browsing context is a top-level browsing context. The API allows to pass the reference browsing context, which is used to create a new tab. The implementation is operating system specific.


    @Test
    void testCreateATab() {
Check code on GitHub

Add Example

Add Example

Add Example

    void testCreateATabWithAReferenceContext() {
        BrowsingContext
                browsingContext =
Check code on GitHub

Add Example

Add Example

Add Example

        NavigationResult info = browsingContext.navigate("https://www.selenium.dev/selenium/web/bidi/logEntryAdded.html");

        Assertions.assertNotNull(browsingContext.getId());
        Assertions.assertNull(info.getNavigationId());
Check code on GitHub

Add Example

Add Example

Add Example

Get browsing context tree

Provides a tree of all browsing contexts descending from the parent browsing context, including the parent browsing context.

                ReadinessState.COMPLETE);

        Assertions.assertNotNull(browsingContext.getId());
        Assertions.assertNull(info.getNavigationId());
        Assertions.assertTrue(info.getUrl().contains("/bidi/logEntryAdded.html"));
    }
Check code on GitHub

Add Example

Add Example

Add Example

Get browsing context tree with depth

Provides a tree of all browsing contexts descending from the parent browsing context, including the parent browsing context upto the depth value passed.

        Assertions.assertEquals(1, contextInfoList.size());
        BrowsingContextInfo info = contextInfoList.get(0);
        Assertions.assertEquals(1, info.getChildren().size());
        Assertions.assertEquals(referenceContextId, info.getId());
Check code on GitHub

Add Example

Add Example

Add Example

Get All Top level browsing contexts


        Assertions.assertEquals(1, contextInfoList.size());
        BrowsingContextInfo info = contextInfoList.get(0);
        Assertions.assertNull(info.getChildren()); // since depth is 0
Check code on GitHub

Add Example

Add Example

Add Example

Close a tab/window

        BrowsingContext window2 = new BrowsingContext(driver, WindowType.WINDOW);

        List<BrowsingContextInfo> contextInfoList = window1.getTopLevelContexts();
Check code on GitHub

Add Example

Add Example

Add Example

Last modified May 15, 2023: Java use Base Test class where possible (#1384) (1722cc599d)