YouTip LogoYouTip

Playwright Page Api

Page is the most commonly used class in Playwright, providing all methods for page interaction. * * * ## Navigation Methods | Method | Description | | --- | --- | | `page.goto(url, options?)` | Navigate to URL | | `page.goBack(options?)` | Go back | | `page.goForward(options?)` | Go forward | | `page.reload(options?)` | Refresh page | * * * ## Locator Methods | Method | Description | | --- | --- | | `page.getByRole(role, options?)` | Locate by ARIA role | | `page.getByText(text, options?)` | Locate by text content | | `page.getByLabel(text, options?)` | Locate by associated label | | `page.getByPlaceholder(text)` | Locate by placeholder | | `page.getByAltText(text)` | Locate by image alt attribute | | `page.getByTitle(text)` | Locate by title attribute | | `page.getByTestId(id)` | Locate by data-testid | | `page.locator(selector)` | CSS / XPath locator | | `page.frameLocator(selector)` | iframe locator | * * * ## Page Property Getters | Method | Description | | --- | --- | | `page.title()` | Get page title | | `page.url()` | Get current URL | | `page.content()` | Get full HTML content | | `page.viewportSize()` | Get viewport size | * * * ## Screenshot and PDF | Method | Description | | --- | --- | | `page.screenshot(options?)` | Take page screenshot | | `page.pdf(options?)` | Generate PDF (Chromium only) | | `page.video()` | Get video object | * * * ## Keyboard and Mouse | Property | Description | | --- | --- | | `page.keyboard` | Keyboard object | | `page.mouse` | Mouse object | | `page.touchscreen` | Touchscreen object | * * * ## JS Execution | Method | Description | | --- | --- | | `page.evaluate(fn, arg?)` | Execute JS in page context | | `page.evaluateHandle(fn, arg?)` | Execute JS and return JSHandle | | `page.addInitScript(script)` | Inject initialization script | | `page.addStyleTag(options?)` | Add style tag | | `page.addScriptTag(options?)` | Add script tag | | `page.exposeFunction(name, fn)` | Expose function to page | * * * ## Wait Methods | Method | Description | | --- | --- | | `page.waitForURL(url, options?)` | Wait for URL change | | `page.waitForLoadState(state?)` | Wait for load state | | `page.waitForTimeout(ms)` | Fixed wait | | `page.waitForEvent(event, options?)` | Wait for event | | `page.waitForResponse(urlOrPredicate, options?)` | Wait for network response | | `page.waitForRequest(urlOrPredicate, options?)` | Wait for network request | * * * ## Network and Routing | Method | Description | | --- | --- | | `page.route(url, handler)` | Intercept network request | | `page.unroute(url, handler?)` | Cancel interception | | `page.routeFromHAR(har, options?)` | Replay network from HAR file | * * * ## Events | Event | Description | | --- | --- | | `page.on('request', handler)` | Listen for requests | | `page.on('response', handler)` | Listen for responses | | `page.on('dialog', handler)` | Listen for dialogs | | `page.on('download', handler)` | Listen for downloads | | `page.on('popup', handler)` | Listen for popup pages | | `page.on('console', handler)` | Listen for console | | `page.on('pageerror', handler)` | Listen for page errors | | `page.on('close', handler)` | Listen for page close | * * * ## Frame Related | Method | Description | | --- | --- | | `page.mainFrame()` | Get main Frame | | `page.frames()` | Get all Frames | * * * ## Others | Method | Description | | --- | --- | | `page.context()` | Get parent BrowserContext | | `page.close()` | Close page | | `page.pause()` | Pause execution (for debugging) | | `page.setViewportSize(size)` | Set viewport size | | `page.bringToFront()` | Bring page to foreground | | `page.emulateMedia(options?)` | Emulate media features | | `page.clock` | Clock object (time simulation) | * * * ## PageAssertions (Auto-retry Assertions) | Assertion Method | Description | | --- | --- | | `expect(page).toHaveTitle(title)` | Assert page title | | `expect(page).toHaveURL(url)` | Assert page URL | | `expect(page).toHaveScreenshot(options?)` | Compare page screenshot |
← Network Input ApiPlaywright Extensions β†’