ブラウジングコンテキスト

コマンド

このセクションでは、ブラウジングコンテキストコマンドに関連する API について説明します。

新しいウィンドウを開く

新しいウィンドウで新しいブラウジングコンテキストを作成します。

    void testCreateAWindow() {
        BrowsingContext browsingContext = new BrowsingContext(driver, WindowType.WINDOW);
        Assertions.assertNotNull(browsingContext.getId());
    }

GitHub で完全な例を見る

例を追加

Selenium v4.8

    const browsingContext = await BrowsingContext(driver, {
      type: 'window',
    })

GitHub で完全な例を見る

例を追加

新しいタブを開く

新しいタブで新しいブラウジングコンテキストを作成します。

Selenium v4.8

    void testCreateATab() {
        BrowsingContext browsingContext = new BrowsingContext(driver, WindowType.TAB);
        Assertions.assertNotNull(browsingContext.getId());
    }

GitHub で完全な例を見る

例を追加

Selenium v4.8

    const browsingContext = await BrowsingContext(driver, {
      type: 'tab',
    })

GitHub で完全な例を見る

例を追加

既存のウィンドウハンドルを使用する

既存のタブ/ウィンドウのブラウジングコンテキストを作成してコマンドを実行します。

Selenium v4.8

    void testCreateABrowsingContextForGivenId() {
        String id = driver.getWindowHandle();
        BrowsingContext browsingContext = new BrowsingContext(driver, id);
        Assertions.assertEquals(id, browsingContext.getId());
    }

GitHub で完全な例を見る

例を追加

Selenium v4.8

    const id = await driver.getWindowHandle()
    const browsingContext = await BrowsingContext(driver, {
      browsingContextId: id,
    })

GitHub で完全な例を見る

例を追加

参照ブラウジングコンテキストでウィンドウを開く

参照ブラウジングコンテキストは、トップレベルブラウジングコンテキストです。この API を使用すると、新しいウィンドウの作成に使用される参照ブラウジングコンテキストを渡すことができます。実装はオペレーティングシステムに依存します。

Selenium v4.8

    void testCreateAWindowWithAReferenceContext() {
        BrowsingContext
                browsingContext =
                new BrowsingContext(driver, WindowType.WINDOW, driver.getWindowHandle());
        Assertions.assertNotNull(browsingContext.getId());
    }

GitHub で完全な例を見る

例を追加

Selenium v4.8

    const browsingContext = await BrowsingContext(driver, {
      type: 'window',
      referenceContext: await driver.getWindowHandle(),
    })

GitHub で完全な例を見る

例を追加

参照ブラウジングコンテキストでタブを開く

参照ブラウジングコンテキストは、トップレベルブラウジングコンテキストです。この API を使用すると、新しいタブの作成に使用される参照ブラウジングコンテキストを渡すことができます。実装はオペレーティングシステムに依存します。

Selenium v4.8

    void testCreateATabWithAReferenceContext() {
        BrowsingContext
                browsingContext =
                new BrowsingContext(driver, WindowType.TAB, driver.getWindowHandle());
        Assertions.assertNotNull(browsingContext.getId());
    }

GitHub で完全な例を見る

例を追加

Selenium v4.8

    const browsingContext = await BrowsingContext(driver, {
      type: 'tab',
      referenceContext: await driver.getWindowHandle(),
    })

GitHub で完全な例を見る

例を追加

URL に移動

Selenium v4.8

    void testNavigateToAUrl() {
        BrowsingContext browsingContext = new BrowsingContext(driver, WindowType.TAB);

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

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

GitHub で完全な例を見る

例を追加

Selenium v4.8

    let info = await browsingContext.navigate('https://selenium.dokyumento.jp/selenium/web/bidi/logEntryAdded.html')

GitHub で完全な例を見る

例を追加

準備状態を指定して URL に移動

Selenium v4.8

    void testNavigateToAUrlWithReadinessState() {
        BrowsingContext browsingContext = new BrowsingContext(driver, WindowType.TAB);

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

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

GitHub で完全な例を見る

例を追加

Selenium v4.8

    const info = await browsingContext.navigate(
      'https://selenium.dokyumento.jp/selenium/web/bidi/logEntryAdded.html',
      'complete'
    )

GitHub で完全な例を見る

例を追加

ブラウジングコンテキストツリーを取得

親ブラウジングコンテキストから派生するすべてのブラウジングコンテキストのツリー（親ブラウジングコンテキストを含む）を提供します。

Selenium v4.8

    void testGetTreeWithAChild() {
        String referenceContextId = driver.getWindowHandle();
        BrowsingContext parentWindow = new BrowsingContext(driver, referenceContextId);

        parentWindow.navigate("https://selenium.dokyumento.jp/selenium/web/iframes.html", ReadinessState.COMPLETE);

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

        Assertions.assertEquals(1, contextInfoList.size());
        BrowsingContextInfo info = contextInfoList.get(0);
        Assertions.assertEquals(1, info.getChildren().size());
        Assertions.assertEquals(referenceContextId, info.getId());
        Assertions.assertTrue(info.getChildren().get(0).getUrl().contains("formPage.html"));
    }

GitHub で完全な例を見る

例を追加

Selenium v4.8

    const browsingContextId = await driver.getWindowHandle()
    const parentWindow = await BrowsingContext(driver, {
      browsingContextId: browsingContextId,
    })
    await parentWindow.navigate('https://selenium.dokyumento.jp/selenium/web/iframes.html', 'complete')

    const contextInfo = await parentWindow.getTree()

GitHub で完全な例を見る

例を追加

深さを指定してブラウジングコンテキストツリーを取得

親ブラウジングコンテキストから派生するすべてのブラウジングコンテキストのツリー（親ブラウジングコンテキストを含む）を、渡された深さの値まで提供します。

Selenium v4.8

    void testGetTreeWithDepth() {
        String referenceContextId = driver.getWindowHandle();
        BrowsingContext parentWindow = new BrowsingContext(driver, referenceContextId);

        parentWindow.navigate("https://selenium.dokyumento.jp/selenium/web/iframes.html", ReadinessState.COMPLETE);

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

        Assertions.assertEquals(1, contextInfoList.size());
        BrowsingContextInfo info = contextInfoList.get(0);
        Assertions.assertNull(info.getChildren()); // since depth is 0
        Assertions.assertEquals(referenceContextId, info.getId());
    }

GitHub で完全な例を見る

例を追加

Selenium v4.8

    const browsingContextId = await driver.getWindowHandle()
    const parentWindow = await BrowsingContext(driver, {
      browsingContextId: browsingContextId,
    })
    await parentWindow.navigate('https://selenium.dokyumento.jp/selenium/web/iframes.html', 'complete')

    const contextInfo = await parentWindow.getTree(0)

GitHub で完全な例を見る

例を追加

すべてのトップレベルブラウジングコンテキストを取得

Selenium v4.8

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

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

        Assertions.assertEquals(2, contextInfoList.size());
    }

GitHub で完全な例を見る

例を追加

Selenium v4.20.0

    const id = await driver.getWindowHandle()
    const window1 = await BrowsingContext(driver, {
      browsingContextId: id,
    })
    await BrowsingContext(driver, { type: 'window' })
    const res = await window1.getTopLevelContexts()

GitHub で完全な例を見る

例を追加

タブ/ウィンドウを閉じる

Selenium v4.8

    void testCloseAWindow() {
        BrowsingContext window1 = new BrowsingContext(driver, WindowType.WINDOW);
        BrowsingContext window2 = new BrowsingContext(driver, WindowType.WINDOW);

        window2.close();

        Assertions.assertThrows(BiDiException.class, window2::getTree);
    }

    @Test
    void testCloseATab() {
        BrowsingContext tab1 = new BrowsingContext(driver, WindowType.TAB);
        BrowsingContext tab2 = new BrowsingContext(driver, WindowType.TAB);

        tab2.close();

        Assertions.assertThrows(BiDiException.class, tab2::getTree);
    }

GitHub で完全な例を見る

例を追加

Selenium v4.8

    const window1 = await BrowsingContext(driver, {type: 'window'})
    const window2 = await BrowsingContext(driver, {type: 'window'})

    await window2.close()

GitHub で完全な例を見る

例を追加

ブラウジングコンテキストをアクティブにする

Selenium v4.14.1

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

        window1.activate();

GitHub で完全な例を見る

例を追加

Selenium v4.15

    const window1 = await BrowsingContext(driver, {
      browsingContextId: id,
    })

GitHub で完全な例を見る

    await window1.activate()

GitHub で完全な例を見る

例を追加

ブラウジングコンテキストをリロード

Selenium v4.13.0

        BrowsingContext browsingContext = new BrowsingContext(driver, WindowType.TAB);

        browsingContext.navigate("https://selenium.dokyumento.jp/selenium/web/bidi/logEntryAdded.html", ReadinessState.COMPLETE);

        NavigationResult reloadInfo = browsingContext.reload(ReadinessState.INTERACTIVE);

GitHub で完全な例を見る

例を追加

Selenium v4.15

    await browsingContext.reload(undefined, 'complete')

GitHub で完全な例を見る

例を追加

ユーザープロンプトを処理

Selenium v4.13.0

        BrowsingContext browsingContext = new BrowsingContext(driver, driver.getWindowHandle());

        driver.get("https://selenium.dokyumento.jp/selenium/web/alerts.html");

        driver.findElement(By.id("prompt-with-default")).click();

        String userText = "Selenium automates browsers";
        browsingContext.handleUserPrompt(true, userText);

GitHub で完全な例を見る

例を追加

Selenium v4.15

    await browsingContext.handleUserPrompt(true, userText)

GitHub で完全な例を見る

例を追加

スクリーンショットをキャプチャ

Selenium v4.13.0

        BrowsingContext browsingContext = new BrowsingContext(driver, driver.getWindowHandle());

        driver.get("https://selenium.dokyumento.jp/selenium/web/alerts.html");

        String screenshot = browsingContext.captureScreenshot();

GitHub で完全な例を見る

例を追加

Selenium v4.15

    const response = await browsingContext.captureScreenshot()

GitHub で完全な例を見る

例を追加

ビューポートのスクリーンショットをキャプチャ

Selenium v4.14.0

        BrowsingContext browsingContext = new BrowsingContext(driver, driver.getWindowHandle());

        driver.get("https://selenium.dokyumento.jp/selenium/web/coordinates_tests/simple_page.html");

        WebElement element = driver.findElement(By.id("box"));
        Rectangle elementRectangle = element.getRect();

        String screenshot =
                browsingContext.captureBoxScreenshot(
                        elementRectangle.getX(), elementRectangle.getY(), 5, 5);

GitHub で完全な例を見る

例を追加

Selenium v4.15

    const browsingContext = await BrowsingContext(driver, {
      browsingContextId: id,
    })

    const response = await browsingContext.captureBoxScreenshot(5, 5, 10, 10)

GitHub で完全な例を見る

例を追加

要素のスクリーンショットをキャプチャ

Selenium v4.14.0

        BrowsingContext browsingContext = new BrowsingContext(driver, driver.getWindowHandle());

        driver.get("https://selenium.dokyumento.jp/selenium/web/formPage.html");
        WebElement element = driver.findElement(By.id("checky"));

        String screenshot = browsingContext.captureElementScreenshot(((RemoteWebElement) element).getId());

GitHub で完全な例を見る

例を追加

Selenium v4.15

    const response = await browsingContext.captureElementScreenshot(elementId)

GitHub で完全な例を見る

例を追加

ビューポートを設定

Selenium v4.14.1

        BrowsingContext browsingContext = new BrowsingContext(driver, driver.getWindowHandle());
        driver.get("https://selenium.dokyumento.jp/selenium/web/formPage.html");

        browsingContext.setViewport(250, 300, 5);

GitHub で完全な例を見る

例を追加

Selenium v4.15

    await browsingContext.setViewport(250, 300)

GitHub で完全な例を見る

例を追加

ページを印刷

Selenium v4.14.1

        BrowsingContext browsingContext = new BrowsingContext(driver, driver.getWindowHandle());

        driver.get("https://selenium.dokyumento.jp/selenium/web/formPage.html");
        PrintOptions printOptions = new PrintOptions();

        String printPage = browsingContext.print(printOptions);

GitHub で完全な例を見る

例を追加

Selenium v4.10

    const result = await browsingContext.printPage({
      orientation: 'landscape',
      scale: 1,
      background: true,
      width: 30,
      height: 30,
      top: 1,
      bottom: 1,
      left: 1,
      right: 1,
      shrinkToFit: true,
      pageRanges: ['1-2'],
    })

GitHub で完全な例を見る

例を追加

戻る

Selenium v4.16.0

        BrowsingContext browsingContext = new BrowsingContext(driver, driver.getWindowHandle());
        browsingContext.navigate("https://selenium.dokyumento.jp/selenium/web/formPage.html", ReadinessState.COMPLETE);

        wait.until(visibilityOfElementLocated(By.id("imageButton"))).submit();
        wait.until(titleIs("We Arrive Here"));

        browsingContext.back();

GitHub で完全な例を見る

例を追加

Selenium v4.17

    await browsingContext.back()

GitHub で完全な例を見る

例を追加

進む

Selenium v4.16.0

    void canNavigateForwardInTheBrowserHistory() {
        BrowsingContext browsingContext = new BrowsingContext(driver, driver.getWindowHandle());
        browsingContext.navigate("https://selenium.dokyumento.jp/selenium/web/formPage.html", ReadinessState.COMPLETE);

        wait.until(visibilityOfElementLocated(By.id("imageButton"))).submit();
        wait.until(titleIs("We Arrive Here"));

        browsingContext.back();
        Assertions.assertTrue(driver.getPageSource().contains("We Leave From Here"));

        browsingContext.forward();

GitHub で完全な例を見る

例を追加

Selenium v4.17

    await browsingContext.forward()

GitHub で完全な例を見る

例を追加

履歴をたどる

Selenium v4.16.0

        BrowsingContext browsingContext = new BrowsingContext(driver, driver.getWindowHandle());
        browsingContext.navigate("https://selenium.dokyumento.jp/selenium/web/formPage.html", ReadinessState.COMPLETE);

        wait.until(visibilityOfElementLocated(By.id("imageButton"))).submit();
        wait.until(titleIs("We Arrive Here"));

        browsingContext.traverseHistory(-1);

GitHub で完全な例を見る

例を追加

Selenium v4.17

    await browsingContext.traverseHistory(-1)

GitHub で完全な例を見る

例を追加

イベント

このセクションでは、ブラウジングコンテキストイベントに関連する API について説明します。

ブラウジングコンテキスト作成イベント

Selenium v4.10

    try (BrowsingContextInspector inspector = new BrowsingContextInspector(driver)) {
        CompletableFuture<BrowsingContextInfo> future = new CompletableFuture<>();

        inspector.onBrowsingContextCreated(future::complete);

        String windowHandle = driver.switchTo().newWindow(WindowType.WINDOW).getWindowHandle();

        BrowsingContextInfo browsingContextInfo = future.get(5, TimeUnit.SECONDS);

GitHub で完全な例を見る

例を追加

Selenium v4.9.2

    const browsingContextInspector = await BrowsingContextInspector(driver)
    await browsingContextInspector.onBrowsingContextCreated((entry) => {
      contextInfo = entry
    })

    await driver.switchTo().newWindow('window')

GitHub で完全な例を見る

例を追加

DOM コンテンツロードイベント

Selenium v4.10

            String windowHandle = driver.switchTo().newWindow(WindowType.TAB).getWindowHandle();

            BrowsingContextInfo browsingContextInfo = future.get(5, TimeUnit.SECONDS);

            Assertions.assertEquals(windowHandle, browsingContextInfo.getId());
        }
    }

    @Test
    void canListenToDomContentLoadedEvent()

GitHub で完全な例を見る

例を追加

Selenium v4.9.2

    const browsingContextInspector = await BrowsingContextInspector(driver)
    let navigationInfo = null
    await browsingContextInspector.onDomContentLoaded((entry) => {
      navigationInfo = entry
    })

    const browsingContext = await BrowsingContext(driver, {
      browsingContextId: await driver.getWindowHandle(),
    })
    await browsingContext.navigate('https://selenium.dokyumento.jp/selenium/web/bidi/logEntryAdded.html', 'complete')

GitHub で完全な例を見る

例を追加

ブラウジングコンテキストロードイベント

Selenium v4.10

        try (BrowsingContextInspector inspector = new BrowsingContextInspector(driver)) {
            CompletableFuture<NavigationInfo> future = new CompletableFuture<>();
            inspector.onBrowsingContextLoaded(future::complete);

            BrowsingContext context = new BrowsingContext(driver, driver.getWindowHandle());
            context.navigate("https://selenium.dokyumento.jp/selenium/web/bidi/logEntryAdded.html", ReadinessState.COMPLETE);

            NavigationInfo navigationInfo = future.get(5, TimeUnit.SECONDS);

GitHub で完全な例を見る

例を追加

Selenium v4.9.2

    const browsingContextInspector = await BrowsingContextInspector(driver)

    await browsingContextInspector.onBrowsingContextLoaded((entry) => {
      navigationInfo = entry
    })
    const browsingContext = await BrowsingContext(driver, {
      browsingContextId: await driver.getWindowHandle(),
    })
    await browsingContext.navigate('https://selenium.dokyumento.jp/selenium/web/bidi/logEntryAdded.html', 'complete')

GitHub で完全な例を見る

例を追加

ナビゲーション開始イベント

Selenium v4.15

        try (BrowsingContextInspector inspector = new BrowsingContextInspector(driver)) {
            CompletableFuture<NavigationInfo> future = new CompletableFuture<>();
            inspector.onNavigationStarted(future::complete);

            BrowsingContext context = new BrowsingContext(driver, driver.getWindowHandle());
            context.navigate("https://selenium.dokyumento.jp/selenium/web/bidi/logEntryAdded.html", ReadinessState.COMPLETE);

            NavigationInfo navigationInfo = future.get(5, TimeUnit.SECONDS);

GitHub で完全な例を見る

例を追加

フラグメントナビゲーションイベント

Selenium v4.15

        try (BrowsingContextInspector inspector = new BrowsingContextInspector(driver)) {
            CompletableFuture<NavigationInfo> future = new CompletableFuture<>();

            BrowsingContext context = new BrowsingContext(driver, driver.getWindowHandle());
            context.navigate("https://selenium.dokyumento.jp/selenium/web/linked_image.html", ReadinessState.COMPLETE);

            inspector.onFragmentNavigated(future::complete);

            context.navigate("https://selenium.dokyumento.jp/selenium/web/linked_image.html#linkToAnchorOnThisPage", ReadinessState.COMPLETE);

            NavigationInfo navigationInfo = future.get(5, TimeUnit.SECONDS);

GitHub で完全な例を見る

例を追加

Selenium v4.15.0

    const browsingContextInspector = await BrowsingContextInspector(driver)

    const browsingContext = await BrowsingContext(driver, {
      browsingContextId: await driver.getWindowHandle(),
    })
    await browsingContext.navigate('https://selenium.dokyumento.jp/selenium/web/linked_image.html', 'complete')

    await browsingContextInspector.onFragmentNavigated((entry) => {
      navigationInfo = entry
    })

    await browsingContext.navigate('https://selenium.dokyumento.jp/selenium/web/linked_image.html#linkToAnchorOnThisPage', 'complete')

GitHub で完全な例を見る

例を追加

ユーザープロンプトオープンイベント

Selenium v4.15

        try (BrowsingContextInspector inspector = new BrowsingContextInspector(driver)) {
            CompletableFuture<NavigationInfo> future = new CompletableFuture<>();

            BrowsingContext context = new BrowsingContext(driver, driver.getWindowHandle());
            context.navigate("https://selenium.dokyumento.jp/selenium/web/linked_image.html", ReadinessState.COMPLETE);

            inspector.onFragmentNavigated(future::complete);

            context.navigate("https://selenium.dokyumento.jp/selenium/web/linked_image.html#linkToAnchorOnThisPage", ReadinessState.COMPLETE);

            NavigationInfo navigationInfo = future.get(5, TimeUnit.SECONDS);

GitHub で完全な例を見る

例を追加

ユーザープロンプトクローズイベント

Selenium v4.15

        try (BrowsingContextInspector inspector = new BrowsingContextInspector(driver)) {
            CompletableFuture<UserPromptClosed> future = new CompletableFuture<>();

            BrowsingContext context = new BrowsingContext(driver, driver.getWindowHandle());
            inspector.onUserPromptClosed(future::complete);

            driver.get("https://selenium.dokyumento.jp/selenium/web/alerts.html");

            driver.findElement(By.id("prompt")).click();

            context.handleUserPrompt(true, "selenium");

            UserPromptClosed userPromptClosed = future.get(5, TimeUnit.SECONDS);
            Assertions.assertEquals(context.getId(), userPromptClosed.getBrowsingContextId());

GitHub で完全な例を見る

例を追加

ブラウジングコンテキスト破棄イベント

Selenium v4.18

        try (BrowsingContextInspector inspector = new BrowsingContextInspector(driver)) {
            CompletableFuture<BrowsingContextInfo> future = new CompletableFuture<>();

            inspector.onBrowsingContextDestroyed(future::complete);

            String windowHandle = driver.switchTo().newWindow(WindowType.WINDOW).getWindowHandle();

            driver.close();

            BrowsingContextInfo browsingContextInfo = future.get(5, TimeUnit.SECONDS);

            Assertions.assertEquals(windowHandle, browsingContextInfo.getId());

GitHub で完全な例を見る

例を追加

Selenium v4.18.0

    const browsingContextInspector = await BrowsingContextInspector(driver)
    await browsingContextInspector.onBrowsingContextDestroyed((entry) => {
      contextInfo = entry
    })

    await driver.switchTo().newWindow('window')

    const windowHandle = await driver.getWindowHandle()
    await driver.close()

GitHub で完全な例を見る

例を追加

最終更新日：2024年8月4日： refactor(js): update code samples to use mocha and fix line numbers (d4adebb67ba)

SeleniumConf 2025 の登録受付開始 | 3月26～28日 | 会場でお会いしましょう！今すぐ登録！

ブラウジングコンテキスト

コマンド

新しいウィンドウを開く

新しいタブを開く

既存のウィンドウハンドルを使用する

参照ブラウジングコンテキストでウィンドウを開く

参照ブラウジングコンテキストでタブを開く

URL に移動

準備状態を指定して URL に移動

ブラウジングコンテキストツリーを取得

深さを指定してブラウジングコンテキストツリーを取得

すべてのトップレベルブラウジングコンテキストを取得

タブ/ウィンドウを閉じる

ブラウジングコンテキストをアクティブにする

ブラウジングコンテキストをリロード

ユーザープロンプトを処理

スクリーンショットをキャプチャ

ビューポートのスクリーンショットをキャプチャ

要素のスクリーンショットをキャプチャ

ビューポートを設定

ページを印刷

戻る

進む

履歴をたどる

イベント

ブラウジングコンテキスト作成イベント

DOM コンテンツロードイベント

ブラウジングコンテキストロードイベント

ナビゲーション開始イベント

フラグメントナビゲーションイベント

ユーザープロンプトオープンイベント

ユーザープロンプトクローズイベント

ブラウジングコンテキスト破棄イベント

開発パートナー

Selenium レベルスポンサー

Selenium プロジェクトを支援する