メインコンテンツへスキップ

ページ

ページ​

各BrowserContextは複数のページを持つことができます。Pageは、ブラウザコンテキスト内の単一のタブまたはポップアップウィンドウを指します。URLにナビゲートしたり、ページコンテンツと対話したりするために使用されます。

page = context.new_page()

# Navigate explicitly, similar to entering a URL in the browser.
page.goto('http://example.com')
# Fill an input.
page.locator('#search').fill('query')

# Navigate implicitly by clicking a link.
page.locator('#submit').click()
# Expect a new url.
print(page.url)

複数ページ​

各ブラウザコンテキストは複数のページ（タブ）をホストできます。

  • 各ページは、フォーカスされたアクティブなページのように動作します。ページを手前に表示する必要はありません。
  • コンテキスト内のページは、ビューポートサイズ、カスタムネットワークルート、ブラウザロケールなどのコンテキストレベルのエミュレーションを尊重します。
# create two pages
page_one = context.new_page()
page_two = context.new_page()

# get pages of a browser context
all_pages = context.pages

新しいページの処理​

ブラウザコンテキストのpageイベントは、そのコンテキストで作成された新しいページを取得するために使用できます。これは、target="_blank"リンクによって開かれた新しいページを処理するために使用できます。

# Get page after a specific action (e.g. clicking a link)
with context.expect_page() as new_page_info:
    page.get_by_text("open new tab").click() # Opens a new tab
new_page = new_page_info.value

# Interact with the new page normally
new_page.get_by_role("button").click()
print(new_page.title())

新しいページをトリガーするアクションが不明な場合は、次のパターンを使用できます。

# Get all new pages (including popups) in the context
def handle_page(page):
    page.wait_for_load_state()
    print(page.title())

context.on("page", handle_page)

ポップアップの処理​

ページがポップアップを開いた場合（例：target="_blank"リンクによって開かれたページ）、ページのpopupイベントをリッスンすることで、その参照を取得できます。

このイベントは、browserContext.on('page')イベントに加えて発生しますが、このページに関連するポップアップに対してのみです。

# Get popup after a specific action (e.g., click)
with page.expect_popup() as popup_info:
    page.get_by_text("open the popup").click()
popup = popup_info.value

# Interact with the popup normally
popup.get_by_role("button").click()
print(popup.title())

ポップアップをトリガーするアクションが不明な場合は、次のパターンを使用できます。

# Get all popups when they open
def handle_popup(popup):
    popup.wait_for_load_state()
    print(popup.title())

page.on("popup", handle_popup)