Playwright is a framework for Web Testing and Automation. It allows testing Chromium, Firefox and WebKit with a single API.
TypeScript automationchromechromiume2e-testingelectronend-to-end-testingfirefoxjavascriptplaywrighttesttest-automationtestingtesting-toolswebwebkit
docs(api): add Python usage examples for the remaining expect_* methods (#41709)
Simon Knott05e4bc1eb50a
diff --git a/docs/src/api/class-browsercontext.md b/docs/src/api/class-browsercontext.mdindex e4f2379cd9..a5679cf5a9 100644--- a/docs/src/api/class-browsercontext.md+++ b/docs/src/api/class-browsercontext.md@@ -1719,6 +1719,24 @@ Will throw an error if the page is closed before the [`event: BrowserContext.con* langs: python- returns: <[EventContextManager]<[ConsoleMessage]>>+**Usage**++```python async+async with context.expect_console_message() as message_info:+ await page.get_by_role("button").click()++message = await message_info.value+print(message.text)+```++```python sync+with context.expect_console_message() as message_info:+ page.get_by_role("button").click()++message = message_info.value+print(message.text)+```+### param: BrowserContext.waitForConsoleMessage.action = %%-csharp-wait-for-event-action-%%* since: v1.34@@ -1818,6 +1836,24 @@ Will throw an error if the context closes before new [Page] is created.* langs: python- returns: <[EventContextManager]<[Page]>>+**Usage**++```python async+async with context.expect_page() as page_info:+ await page.get_by_text("Open new tab").click()++new_page = await page_info.value+print(await new_page.title())+```++```python sync+with context.expect_page() as page_info:+ page.get_by_text("Open new tab").click()++new_page = page_info.value+print(new_page.title())+```+### param: BrowserContext.waitForPage.action = %%-csharp-wait-for-event-action-%%* since: v1.12diff --git a/docs/src/api/class-page.md b/docs/src/api/class-page.mdindex 7cf23b7663..913fc56185 100644--- a/docs/src/api/class-page.md+++ b/docs/src/api/class-page.md@@ -4616,6 +4616,24 @@ Will throw an error if the page is closed before the [`event: Page.console`] eve* langs: python- returns: <[EventContextManager]<[ConsoleMessage]>>+**Usage**++```python async+async with page.expect_console_message() as message_info:+ await page.get_by_role("button").click()++message = await message_info.value+print(message.text)+```++```python sync+with page.expect_console_message() as message_info:+ page.get_by_role("button").click()++message = message_info.value+print(message.text)+```+### param: Page.waitForConsoleMessage.action = %%-csharp-wait-for-event-action-%%* since: v1.12@@ -4752,6 +4770,24 @@ Will throw an error if the page is closed before the file chooser is opened.* langs: python- returns: <[EventContextManager]<[FileChooser]>>+**Usage**++```python async+async with page.expect_file_chooser() as fc_info:+ await page.get_by_text("Upload").click()++file_chooser = await fc_info.value+await file_chooser.set_files("myfile.pdf")+```++```python sync+with page.expect_file_chooser() as fc_info:+ page.get_by_text("Upload").click()++file_chooser = fc_info.value+file_chooser.set_files("myfile.pdf")+```+### param: Page.waitForFileChooser.action = %%-csharp-wait-for-event-action-%%* since: v1.12@@ -5111,6 +5147,24 @@ Will throw an error if the page is closed before the popup event is fired.* langs: python- returns: <[EventContextManager]<[Page]>>+**Usage**++```python async+async with page.expect_popup() as popup_info:+ await page.get_by_text("Open popup").click()++popup = await popup_info.value+print(await popup.title())+```++```python sync+with page.expect_popup() as popup_info:+ page.get_by_text("Open popup").click()++popup = popup_info.value+print(popup.title())+```+### param: Page.waitForPopup.action = %%-csharp-wait-for-event-action-%%* since: v1.12@@ -5253,6 +5307,24 @@ Will throw an error if the page is closed before the [`event: Page.requestFinish* langs: python- returns: <[EventContextManager]<[Request]>>+**Usage**++```python async+async with page.expect_request_finished() as request_info:+ await page.get_by_text("Trigger request").click()++request = await request_info.value+print(request.url)+```++```python sync+with page.expect_request_finished() as request_info:+ page.get_by_text("Trigger request").click()++request = request_info.value+print(request.url)+```+### param: Page.waitForRequestFinished.action = %%-csharp-wait-for-event-action-%%* since: v1.12@@ -5657,6 +5729,24 @@ Will throw an error if the page is closed before the WebSocket event is fired.* langs: python- returns: <[EventContextManager]<[WebSocket]>>+**Usage**++```python async+async with page.expect_websocket() as ws_info:+ await page.get_by_text("Connect").click()++ws = await ws_info.value+print(ws.url)+```++```python sync+with page.expect_websocket() as ws_info:+ page.get_by_text("Connect").click()++ws = ws_info.value+print(ws.url)+```+### param: Page.waitForWebSocket.action = %%-csharp-wait-for-event-action-%%* since: v1.12@@ -5689,6 +5779,24 @@ Will throw an error if the page is closed before the worker event is fired.* langs: python- returns: <[EventContextManager]<[Worker]>>+**Usage**++```python async+async with page.expect_worker() as worker_info:+ await page.get_by_text("Start worker").click()++worker = await worker_info.value+print(worker.url)+```++```python sync+with page.expect_worker() as worker_info:+ page.get_by_text("Start worker").click()++worker = worker_info.value+print(worker.url)+```+### param: Page.waitForWorker.action = %%-csharp-wait-for-event-action-%%* since: v1.12diff --git a/docs/src/api/class-websocket.md b/docs/src/api/class-websocket.mdindex 354de8f874..d242d6e67f 100644--- a/docs/src/api/class-websocket.md+++ b/docs/src/api/class-websocket.md@@ -77,6 +77,24 @@ value. Will throw an error if the webSocket is closed before the event is fired.* langs: python- returns: <[EventContextManager]>+**Usage**++```python async+async with ws.expect_event("framereceived") as event_info:+ await page.get_by_text("Send message").click()++payload = await event_info.value+print(payload)+```++```python sync+with ws.expect_event("framereceived") as event_info:+ page.get_by_text("Send message").click()++payload = event_info.value+print(payload)+```+### param: WebSocket.waitForEvent.event* since: v1.8- `event` <[string]>