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.

• Java
• Ruby
• JavaScript
• Kotlin

Open a new tab

Creates a new browsing context in a new tab.

• Java
• Ruby
• JavaScript
• Kotlin

    @Test

Use existing window handle

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

• Java
• Ruby
• JavaScript
• Kotlin

    @BeforeEach

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.

• Java
• Ruby
• JavaScript
• Kotlin

    }

    @Test

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.

• Java
• Ruby
• JavaScript
• Kotlin

    }

    @Test

Navigate to a URL

• Java
• Ruby
• JavaScript
• Kotlin

    @Test
    void testCreateATabWithAReferenceContext() {
        BrowsingContext

Navigate to a URL with readiness state

• Java
• Ruby
• JavaScript
• Kotlin

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

        Assertions.assertNotNull(browsingContext.getId());

Get browsing context tree

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

• Java
• Ruby
• JavaScript
• Kotlin

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

        Assertions.assertNotNull(browsingContext.getId());
        Assertions.assertNotNull(info.getNavigationId());
        Assertions.assertTrue(info.getUrl().contains("/bidi/logEntryAdded.html"));

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.

• Java
• Ruby
• JavaScript
• Kotlin

        Assertions.assertEquals(1, contextInfoList.size());
        BrowsingContextInfo info = contextInfoList.get(0);
        Assertions.assertEquals(1, info.getChildren().size());

Get All Top level browsing contexts

• Java
• Ruby
• JavaScript
• Kotlin

        List<BrowsingContextInfo> contextInfoList = parentWindow.getTree(0);

        Assertions.assertEquals(1, contextInfoList.size());
        BrowsingContextInfo info = contextInfoList.get(0);

Close a tab/window

• Java
• Ruby
• JavaScript
• Kotlin

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

        List<BrowsingContextInfo> contextInfoList = window1.getTopLevelContexts();