***

title: Playwright Page
description: Complete Page method reference for the Playwright driver.
----------------------------------------------------------------------

All `Page` methods available when using the **Playwright** driver.

Access via `runtime.page` after launching a Playwright runtime.

<Accordion title="How these methods work over HTTP">
  Every method below is a remote call. The SDK translates it into a structured step sent to a single endpoint:

  ```
  POST /v1/workspaces/{workspaceId}/execute
  ```

  ```json
  {
    "runtime": "my-browser",
    "steps": [
      {
        "call": "page.goto",
        "args": ["https://example.com"]
      }
    ]
  }
  ```

  The `call` field maps directly to the method name. `args` is a JSON array of the method's arguments. You can batch multiple steps in one request.
</Accordion>

## Navigation

### goto(url, options?)

Navigate to a URL.

```ts
await runtime.page.goto('...');
```

| Parameter | Type                    | Required | Description |
| --------- | ----------------------- | -------- | ----------- |
| `url`     | `string`                | Yes      | —           |
| `options` | `PlaywrightGotoOptions` | No       | —           |

**Returns** `PlaywrightResponse \| null`
— The main resource response, or null if navigating to about:blank.

[Upstream docs](https://playwright.dev/docs/api/class-page#page-goto)

***

### reload(options?)

Reload the page.

```ts
await runtime.page.reload();
```

| Parameter | Type                          | Required | Description |
| --------- | ----------------------------- | -------- | ----------- |
| `options` | `PlaywrightNavigationOptions` | No       | —           |

**Returns** `PlaywrightResponse \| null`

[Upstream docs](https://playwright.dev/docs/api/class-page#page-reload)

***

### goBack(options?)

Navigate back in history.

```ts
await runtime.page.goBack();
```

| Parameter | Type                          | Required | Description |
| --------- | ----------------------------- | -------- | ----------- |
| `options` | `PlaywrightNavigationOptions` | No       | —           |

**Returns** `PlaywrightResponse \| null`

[Upstream docs](https://playwright.dev/docs/api/class-page#page-go-back)

***

### goForward(options?)

Navigate forward in history.

```ts
await runtime.page.goForward();
```

| Parameter | Type                          | Required | Description |
| --------- | ----------------------------- | -------- | ----------- |
| `options` | `PlaywrightNavigationOptions` | No       | —           |

**Returns** `PlaywrightResponse \| null`

[Upstream docs](https://playwright.dev/docs/api/class-page#page-go-forward)

***

### waitForURL(url, options?)

Wait for the main frame to navigate to the given URL.

```ts
await runtime.page.waitForURL(/* url */);
```

| Parameter | Type                                             | Required | Description |
| --------- | ------------------------------------------------ | -------- | ----------- |
| `url`     | `string \| RegExp \| ((url: URL) =&gt; boolean)` | Yes      | —           |
| `options` | `PlaywrightWaitForURLOptions`                    | No       | —           |

[Upstream docs](https://playwright.dev/docs/api/class-page#page-wait-for-url)

***

### waitForLoadState(state?, options?)

Wait for the required load state to be reached.

<Note>
  State can be 'load', 'domcontentloaded', or 'networkidle'.
</Note>

```ts
await runtime.page.waitForLoadState();
```

| Parameter | Type                                | Required | Description |
| --------- | ----------------------------------- | -------- | ----------- |
| `state`   | `LoadState`                         | No       | —           |
| `options` | `PlaywrightWaitForLoadStateOptions` | No       | —           |

[Upstream docs](https://playwright.dev/docs/api/class-page#page-wait-for-load-state)

***

### waitForNavigation(options?)

Wait for the main frame navigation and return the main resource response.

<Note>
  Deprecated: This method is inherently racy. Use page.waitForURL() instead.
</Note>

```ts
await runtime.page.waitForNavigation();
```

| Parameter | Type                                 | Required | Description |
| --------- | ------------------------------------ | -------- | ----------- |
| `options` | `PlaywrightWaitForNavigationOptions` | No       | —           |

**Returns** `PlaywrightResponse \| null`

[Upstream docs](https://playwright.dev/docs/api/class-page#page-wait-for-navigation)

***

## Page Info

### title()

Get the page title.

```ts
await runtime.page.title();
```

**Returns** `string`

[Upstream docs](https://playwright.dev/docs/api/class-page#page-title)

***

### url()

Get the current URL.

```ts
await runtime.page.url();
```

**Returns** `string`

[Upstream docs](https://playwright.dev/docs/api/class-page#page-url)

***

### content()

Get the full HTML content of the page.

```ts
await runtime.page.content();
```

**Returns** `string`

[Upstream docs](https://playwright.dev/docs/api/class-page#page-content)

***

### setContent(html, options?)

Set the HTML content of the page.

```ts
await runtime.page.setContent('...');
```

| Parameter | Type                          | Required | Description |
| --------- | ----------------------------- | -------- | ----------- |
| `html`    | `string`                      | Yes      | —           |
| `options` | `PlaywrightSetContentOptions` | No       | —           |

[Upstream docs](https://playwright.dev/docs/api/class-page#page-set-content)

***

### setViewportSize(viewportSize)

Set the viewport size.

```ts
await runtime.page.setViewportSize(/* PlaywrightViewportSize */);
```

| Parameter      | Type                     | Required | Description |
| -------------- | ------------------------ | -------- | ----------- |
| `viewportSize` | `PlaywrightViewportSize` | Yes      | —           |

[Upstream docs](https://playwright.dev/docs/api/class-page#page-set-viewport-size)

***

### viewportSize()

Get the viewport size.

```ts
runtime.page.viewportSize();
```

**Returns** `PlaywrightViewportSize \| null`

[Upstream docs](https://playwright.dev/docs/api/class-page#page-viewport-size)

***

### isClosed()

Check if the page is closed.

```ts
runtime.page.isClosed();
```

**Returns** `boolean`

[Upstream docs](https://playwright.dev/docs/api/class-page#page-is-closed)

***

## Actions

### click(selector, options?)

Click on an element matching the selector.

<Note>
  Deprecated: Use locator.click() instead.
</Note>

```ts
await runtime.page.click('...');
```

| Parameter  | Type                     | Required | Description |
| ---------- | ------------------------ | -------- | ----------- |
| `selector` | `string`                 | Yes      | —           |
| `options`  | `PlaywrightClickOptions` | No       | —           |

[Upstream docs](https://playwright.dev/docs/api/class-page#page-click)

***

### dblclick(selector, options?)

Double-click on an element matching the selector.

<Note>
  Deprecated: Use locator.dblclick() instead.
</Note>

```ts
await runtime.page.dblclick('...');
```

| Parameter  | Type                        | Required | Description |
| ---------- | --------------------------- | -------- | ----------- |
| `selector` | `string`                    | Yes      | —           |
| `options`  | `PlaywrightDblclickOptions` | No       | —           |

[Upstream docs](https://playwright.dev/docs/api/class-page#page-dblclick)

***

### fill(selector, value, options?)

Fill an input element with the given value.

<Note>
  Deprecated: Use locator.fill() instead.
</Note>

```ts
await runtime.page.fill('...', '...');
```

| Parameter  | Type                    | Required | Description |
| ---------- | ----------------------- | -------- | ----------- |
| `selector` | `string`                | Yes      | —           |
| `value`    | `string`                | Yes      | —           |
| `options`  | `PlaywrightFillOptions` | No       | —           |

[Upstream docs](https://playwright.dev/docs/api/class-page#page-fill)

***

### type(selector, text, options?)

Type text into an element (sends keydown, keypress/input, keyup events for each character).

<Note>
  Deprecated: Use locator.pressSequentially() instead.
</Note>

```ts
await runtime.page.type('...', '...');
```

| Parameter  | Type                    | Required | Description |
| ---------- | ----------------------- | -------- | ----------- |
| `selector` | `string`                | Yes      | —           |
| `text`     | `string`                | Yes      | —           |
| `options`  | `PlaywrightTypeOptions` | No       | —           |

[Upstream docs](https://playwright.dev/docs/api/class-page#page-type)

***

### press(selector, key, options?)

Focus an element and press a key combination.

<Note>
  Deprecated: Use locator.press() instead.
</Note>

```ts
await runtime.page.press('...', '...');
```

| Parameter  | Type                     | Required | Description |
| ---------- | ------------------------ | -------- | ----------- |
| `selector` | `string`                 | Yes      | —           |
| `key`      | `string`                 | Yes      | —           |
| `options`  | `PlaywrightPressOptions` | No       | —           |

[Upstream docs](https://playwright.dev/docs/api/class-page#page-press)

***

### hover(selector, options?)

Hover over an element.

<Note>
  Deprecated: Use locator.hover() instead.
</Note>

```ts
await runtime.page.hover('...');
```

| Parameter  | Type                     | Required | Description |
| ---------- | ------------------------ | -------- | ----------- |
| `selector` | `string`                 | Yes      | —           |
| `options`  | `PlaywrightHoverOptions` | No       | —           |

[Upstream docs](https://playwright.dev/docs/api/class-page#page-hover)

***

### focus(selector, options?)

Focus on an element.

<Note>
  Deprecated: Use locator.focus() instead.
</Note>

```ts
await runtime.page.focus('...');
```

| Parameter  | Type                     | Required | Description |
| ---------- | ------------------------ | -------- | ----------- |
| `selector` | `string`                 | Yes      | —           |
| `options`  | `PlaywrightFocusOptions` | No       | —           |

[Upstream docs](https://playwright.dev/docs/api/class-page#page-focus)

***

### tap(selector, options?)

Tap on an element (for touch devices).

<Note>
  Deprecated: Use locator.tap() instead.
</Note>

```ts
await runtime.page.tap('...');
```

| Parameter  | Type                   | Required | Description |
| ---------- | ---------------------- | -------- | ----------- |
| `selector` | `string`               | Yes      | —           |
| `options`  | `PlaywrightTapOptions` | No       | —           |

[Upstream docs](https://playwright.dev/docs/api/class-page#page-tap)

***

### check(selector, options?)

Check a checkbox or radio button.

<Note>
  Deprecated: Use locator.check() instead.
</Note>

```ts
await runtime.page.check('...');
```

| Parameter  | Type                     | Required | Description |
| ---------- | ------------------------ | -------- | ----------- |
| `selector` | `string`                 | Yes      | —           |
| `options`  | `PlaywrightCheckOptions` | No       | —           |

[Upstream docs](https://playwright.dev/docs/api/class-page#page-check)

***

### uncheck(selector, options?)

Uncheck a checkbox.

<Note>
  Deprecated: Use locator.uncheck() instead.
</Note>

```ts
await runtime.page.uncheck('...');
```

| Parameter  | Type                     | Required | Description |
| ---------- | ------------------------ | -------- | ----------- |
| `selector` | `string`                 | Yes      | —           |
| `options`  | `PlaywrightCheckOptions` | No       | —           |

[Upstream docs](https://playwright.dev/docs/api/class-page#page-uncheck)

***

### setChecked(selector, checked, options?)

Set the checked state of a checkbox.

<Note>
  Deprecated: Use locator.setChecked() instead.
</Note>

```ts
await runtime.page.setChecked('...', true);
```

| Parameter  | Type                          | Required | Description |
| ---------- | ----------------------------- | -------- | ----------- |
| `selector` | `string`                      | Yes      | —           |
| `checked`  | `boolean`                     | Yes      | —           |
| `options`  | `PlaywrightSetCheckedOptions` | No       | —           |

[Upstream docs](https://playwright.dev/docs/api/class-page#page-set-checked)

***

### selectOption(selector, values, options?)

Select one or more options in a \<select> element.

<Note>
  Deprecated: Use locator.selectOption() instead.
</Note>

```ts
await runtime.page.selectOption('...', /* values */);
```

| Parameter  | Type                                                   | Required | Description |
| ---------- | ------------------------------------------------------ | -------- | ----------- |
| `selector` | `string`                                               | Yes      | —           |
| `values`   | `string \| SelectOption \| (string \| SelectOption)[]` | Yes      | —           |
| `options`  | `PlaywrightSelectOptionOptions`                        | No       | —           |

**Returns** `string[]`

[Upstream docs](https://playwright.dev/docs/api/class-page#page-select-option)

***

### setInputFiles(selector, files, options?)

Set input files for a file input element.

<Note>
  Deprecated: Use locator.setInputFiles() instead.
</Note>

```ts
await runtime.page.setInputFiles('...', /* files */);
```

| Parameter  | Type                                                 | Required | Description |
| ---------- | ---------------------------------------------------- | -------- | ----------- |
| `selector` | `string`                                             | Yes      | —           |
| `files`    | `string \| string[] \| FilePayload \| FilePayload[]` | Yes      | —           |
| `options`  | `PlaywrightSetInputFilesOptions`                     | No       | —           |

[Upstream docs](https://playwright.dev/docs/api/class-page#page-set-input-files)

***

### dispatchEvent(selector, type, eventInit?, options?)

Dispatch a DOM event on an element.

<Note>
  Deprecated: Use locator.dispatchEvent() instead.
</Note>

```ts
await runtime.page.dispatchEvent('...', '...');
```

| Parameter   | Type                             | Required | Description |
| ----------- | -------------------------------- | -------- | ----------- |
| `selector`  | `string`                         | Yes      | —           |
| `type`      | `string`                         | Yes      | —           |
| `eventInit` | `Record&lt;string, unknown&gt;`  | No       | —           |
| `options`   | `PlaywrightDispatchEventOptions` | No       | —           |

[Upstream docs](https://playwright.dev/docs/api/class-page#page-dispatch-event)

***

### dragAndDrop(source, target, options?)

Drag an element to another element.

```ts
await runtime.page.dragAndDrop('...', '...');
```

| Parameter | Type                           | Required | Description |
| --------- | ------------------------------ | -------- | ----------- |
| `source`  | `string`                       | Yes      | —           |
| `target`  | `string`                       | Yes      | —           |
| `options` | `PlaywrightDragAndDropOptions` | No       | —           |

[Upstream docs](https://playwright.dev/docs/api/class-page#page-drag-and-drop)

***

## Queries

### \$(selector)

Query for a single element. Alias for page.querySelector().

<Note>
  Deprecated: Use locator() instead.
</Note>

```ts
await runtime.page.$('...');
```

| Parameter  | Type     | Required | Description |
| ---------- | -------- | -------- | ----------- |
| `selector` | `string` | Yes      | —           |

**Returns** `RemotePlaywrightElementHandle \| null`

[Upstream docs](https://playwright.dev/docs/api/class-page#page-query-selector)

***

### \$\$(selector)

Query for all matching elements. Alias for page.querySelectorAll().

<Note>
  Deprecated: Use locator() instead.
</Note>

```ts
await runtime.page.$$('...');
```

| Parameter  | Type     | Required | Description |
| ---------- | -------- | -------- | ----------- |
| `selector` | `string` | Yes      | —           |

**Returns** `RemotePlaywrightElementHandle[]`

[Upstream docs](https://playwright.dev/docs/api/class-page#page-query-selector-all)

***

### querySelector(selector)

Query for a single element.

<Note>
  Deprecated: Use locator() instead.
</Note>

```ts
await runtime.page.querySelector('...');
```

| Parameter  | Type     | Required | Description |
| ---------- | -------- | -------- | ----------- |
| `selector` | `string` | Yes      | —           |

**Returns** `RemotePlaywrightElementHandle \| null`

[Upstream docs](https://playwright.dev/docs/api/class-page#page-query-selector)

***

### querySelectorAll(selector)

Query for all matching elements.

<Note>
  Deprecated: Use locator() instead.
</Note>

```ts
await runtime.page.querySelectorAll('...');
```

| Parameter  | Type     | Required | Description |
| ---------- | -------- | -------- | ----------- |
| `selector` | `string` | Yes      | —           |

**Returns** `RemotePlaywrightElementHandle[]`

[Upstream docs](https://playwright.dev/docs/api/class-page#page-query-selector-all)

***

### locator(selector, options?)

Create a locator for the given selector.

```ts
runtime.page.locator('...');
```

| Parameter  | Type                       | Required | Description |
| ---------- | -------------------------- | -------- | ----------- |
| `selector` | `string`                   | Yes      | —           |
| `options`  | `PlaywrightLocatorOptions` | No       | —           |

**Returns** `RemotePlaywrightLocator`

[Upstream docs](https://playwright.dev/docs/api/class-page#page-locator)

***

### getByRole(role, options?)

Locate elements by their ARIA role, ARIA attributes, and accessible name.

```ts
runtime.page.getByRole('...');
```

| Parameter | Type                         | Required | Description |
| --------- | ---------------------------- | -------- | ----------- |
| `role`    | `string`                     | Yes      | —           |
| `options` | `PlaywrightGetByRoleOptions` | No       | —           |

**Returns** `RemotePlaywrightLocator`

[Upstream docs](https://playwright.dev/docs/api/class-page#page-get-by-role)

***

### getByText(text, options?)

Locate elements containing the given text.

```ts
runtime.page.getByText(/* text */);
```

| Parameter | Type                         | Required | Description |
| --------- | ---------------------------- | -------- | ----------- |
| `text`    | `string \| RegExp`           | Yes      | —           |
| `options` | `PlaywrightGetByTextOptions` | No       | —           |

**Returns** `RemotePlaywrightLocator`

[Upstream docs](https://playwright.dev/docs/api/class-page#page-get-by-text)

***

### getByLabel(text, options?)

Locate form controls by the text of their associated labels.

```ts
runtime.page.getByLabel(/* text */);
```

| Parameter | Type                          | Required | Description |
| --------- | ----------------------------- | -------- | ----------- |
| `text`    | `string \| RegExp`            | Yes      | —           |
| `options` | `PlaywrightGetByLabelOptions` | No       | —           |

**Returns** `RemotePlaywrightLocator`

[Upstream docs](https://playwright.dev/docs/api/class-page#page-get-by-label)

***

### getByPlaceholder(text, options?)

Locate input elements by their placeholder text.

```ts
runtime.page.getByPlaceholder(/* text */);
```

| Parameter | Type                                | Required | Description |
| --------- | ----------------------------------- | -------- | ----------- |
| `text`    | `string \| RegExp`                  | Yes      | —           |
| `options` | `PlaywrightGetByPlaceholderOptions` | No       | —           |

**Returns** `RemotePlaywrightLocator`

[Upstream docs](https://playwright.dev/docs/api/class-page#page-get-by-placeholder)

***

### getByAltText(text, options?)

Locate elements by their alt text.

```ts
runtime.page.getByAltText(/* text */);
```

| Parameter | Type                            | Required | Description |
| --------- | ------------------------------- | -------- | ----------- |
| `text`    | `string \| RegExp`              | Yes      | —           |
| `options` | `PlaywrightGetByAltTextOptions` | No       | —           |

**Returns** `RemotePlaywrightLocator`

[Upstream docs](https://playwright.dev/docs/api/class-page#page-get-by-alt-text)

***

### getByTitle(text, options?)

Locate elements by their title attribute.

```ts
runtime.page.getByTitle(/* text */);
```

| Parameter | Type                          | Required | Description |
| --------- | ----------------------------- | -------- | ----------- |
| `text`    | `string \| RegExp`            | Yes      | —           |
| `options` | `PlaywrightGetByTitleOptions` | No       | —           |

**Returns** `RemotePlaywrightLocator`

[Upstream docs](https://playwright.dev/docs/api/class-page#page-get-by-title)

***

### getByTestId(testId)

Locate elements by their data-testid attribute.

```ts
runtime.page.getByTestId(/* testId */);
```

| Parameter | Type               | Required | Description |
| --------- | ------------------ | -------- | ----------- |
| `testId`  | `string \| RegExp` | Yes      | —           |

**Returns** `RemotePlaywrightLocator`

[Upstream docs](https://playwright.dev/docs/api/class-page#page-get-by-test-id)

***

### frameLocator(selector)

Create a frame locator for the given selector.

```ts
runtime.page.frameLocator('...');
```

| Parameter  | Type     | Required | Description |
| ---------- | -------- | -------- | ----------- |
| `selector` | `string` | Yes      | —           |

**Returns** `RemotePlaywrightLocator`

[Upstream docs](https://playwright.dev/docs/api/class-page#page-frame-locator)

***

## Content

### getAttribute(selector, name, options?)

Get an attribute value from an element.

<Note>
  Deprecated: Use locator.getAttribute() instead.
</Note>

```ts
await runtime.page.getAttribute('...', '...');
```

| Parameter  | Type                                     | Required | Description |
| ---------- | ---------------------------------------- | -------- | ----------- |
| `selector` | `string`                                 | Yes      | —           |
| `name`     | `string`                                 | Yes      | —           |
| `options`  | `{ strict?: boolean; timeout?: number }` | No       | —           |

**Returns** `string \| null`

[Upstream docs](https://playwright.dev/docs/api/class-page#page-get-attribute)

***

### textContent(selector, options?)

Get the text content of an element.

<Note>
  Deprecated: Use locator.textContent() instead.
</Note>

```ts
await runtime.page.textContent('...');
```

| Parameter  | Type                                     | Required | Description |
| ---------- | ---------------------------------------- | -------- | ----------- |
| `selector` | `string`                                 | Yes      | —           |
| `options`  | `{ strict?: boolean; timeout?: number }` | No       | —           |

**Returns** `string \| null`

[Upstream docs](https://playwright.dev/docs/api/class-page#page-text-content)

***

### innerText(selector, options?)

Get the inner text of an element.

<Note>
  Deprecated: Use locator.innerText() instead.
</Note>

```ts
await runtime.page.innerText('...');
```

| Parameter  | Type                                     | Required | Description |
| ---------- | ---------------------------------------- | -------- | ----------- |
| `selector` | `string`                                 | Yes      | —           |
| `options`  | `{ strict?: boolean; timeout?: number }` | No       | —           |

**Returns** `string`

[Upstream docs](https://playwright.dev/docs/api/class-page#page-inner-text)

***

### innerHTML(selector, options?)

Get the inner HTML of an element.

<Note>
  Deprecated: Use locator.innerHTML() instead.
</Note>

```ts
await runtime.page.innerHTML('...');
```

| Parameter  | Type                                     | Required | Description |
| ---------- | ---------------------------------------- | -------- | ----------- |
| `selector` | `string`                                 | Yes      | —           |
| `options`  | `{ strict?: boolean; timeout?: number }` | No       | —           |

**Returns** `string`

[Upstream docs](https://playwright.dev/docs/api/class-page#page-inner-html)

***

### inputValue(selector, options?)

Get the input value of an element.

<Note>
  Deprecated: Use locator.inputValue() instead.
</Note>

```ts
await runtime.page.inputValue('...');
```

| Parameter  | Type                                     | Required | Description |
| ---------- | ---------------------------------------- | -------- | ----------- |
| `selector` | `string`                                 | Yes      | —           |
| `options`  | `{ strict?: boolean; timeout?: number }` | No       | —           |

**Returns** `string`

[Upstream docs](https://playwright.dev/docs/api/class-page#page-input-value)

***

## State Checks

### isVisible(selector, options?)

Check if an element is visible.

<Note>
  Deprecated: Use locator.isVisible() instead.
</Note>

```ts
await runtime.page.isVisible('...');
```

| Parameter  | Type                                     | Required | Description |
| ---------- | ---------------------------------------- | -------- | ----------- |
| `selector` | `string`                                 | Yes      | —           |
| `options`  | `{ strict?: boolean; timeout?: number }` | No       | —           |

**Returns** `boolean`

[Upstream docs](https://playwright.dev/docs/api/class-page#page-is-visible)

***

### isHidden(selector, options?)

Check if an element is hidden.

<Note>
  Deprecated: Use locator.isHidden() instead.
</Note>

```ts
await runtime.page.isHidden('...');
```

| Parameter  | Type                                     | Required | Description |
| ---------- | ---------------------------------------- | -------- | ----------- |
| `selector` | `string`                                 | Yes      | —           |
| `options`  | `{ strict?: boolean; timeout?: number }` | No       | —           |

**Returns** `boolean`

[Upstream docs](https://playwright.dev/docs/api/class-page#page-is-hidden)

***

### isEnabled(selector, options?)

Check if an element is enabled.

<Note>
  Deprecated: Use locator.isEnabled() instead.
</Note>

```ts
await runtime.page.isEnabled('...');
```

| Parameter  | Type                                     | Required | Description |
| ---------- | ---------------------------------------- | -------- | ----------- |
| `selector` | `string`                                 | Yes      | —           |
| `options`  | `{ strict?: boolean; timeout?: number }` | No       | —           |

**Returns** `boolean`

[Upstream docs](https://playwright.dev/docs/api/class-page#page-is-enabled)

***

### isDisabled(selector, options?)

Check if an element is disabled.

<Note>
  Deprecated: Use locator.isDisabled() instead.
</Note>

```ts
await runtime.page.isDisabled('...');
```

| Parameter  | Type                                     | Required | Description |
| ---------- | ---------------------------------------- | -------- | ----------- |
| `selector` | `string`                                 | Yes      | —           |
| `options`  | `{ strict?: boolean; timeout?: number }` | No       | —           |

**Returns** `boolean`

[Upstream docs](https://playwright.dev/docs/api/class-page#page-is-disabled)

***

### isEditable(selector, options?)

Check if an element is editable.

<Note>
  Deprecated: Use locator.isEditable() instead.
</Note>

```ts
await runtime.page.isEditable('...');
```

| Parameter  | Type                                     | Required | Description |
| ---------- | ---------------------------------------- | -------- | ----------- |
| `selector` | `string`                                 | Yes      | —           |
| `options`  | `{ strict?: boolean; timeout?: number }` | No       | —           |

**Returns** `boolean`

[Upstream docs](https://playwright.dev/docs/api/class-page#page-is-editable)

***

### isChecked(selector, options?)

Check if a checkbox is checked.

<Note>
  Deprecated: Use locator.isChecked() instead.
</Note>

```ts
await runtime.page.isChecked('...');
```

| Parameter  | Type                                     | Required | Description |
| ---------- | ---------------------------------------- | -------- | ----------- |
| `selector` | `string`                                 | Yes      | —           |
| `options`  | `{ strict?: boolean; timeout?: number }` | No       | —           |

**Returns** `boolean`

[Upstream docs](https://playwright.dev/docs/api/class-page#page-is-checked)

***

## Waiting

### waitForSelector(selector, options?)

Wait for a selector to appear in the DOM.

<Note>
  Deprecated: Use locator-based methods or web assertions instead.
</Note>

```ts
await runtime.page.waitForSelector('...');
```

| Parameter  | Type                               | Required | Description |
| ---------- | ---------------------------------- | -------- | ----------- |
| `selector` | `string`                           | Yes      | —           |
| `options`  | `PlaywrightWaitForSelectorOptions` | No       | —           |

**Returns** `RemotePlaywrightElementHandle \| null`

[Upstream docs](https://playwright.dev/docs/api/class-page#page-wait-for-selector)

***

### waitForTimeout(timeout)

Wait for the specified timeout.

<Note>
  Discouraged: Use time-based assertions or auto-waiting instead.
</Note>

```ts
await runtime.page.waitForTimeout(0);
```

| Parameter | Type     | Required | Description |
| --------- | -------- | -------- | ----------- |
| `timeout` | `number` | Yes      | —           |

[Upstream docs](https://playwright.dev/docs/api/class-page#page-wait-for-timeout)

***

### waitForFunction(pageFunction, arg?, options?)

Wait for a function to return a truthy value.

<Note>
  Note: Returns a serialized handle reference. Full JSHandle support not yet available.
</Note>

```ts
await runtime.page.waitForFunction('...');
```

| Parameter      | Type                               | Required | Description |
| -------------- | ---------------------------------- | -------- | ----------- |
| `pageFunction` | `Function \| string`               | Yes      | —           |
| `arg`          | `unknown`                          | No       | —           |
| `options`      | `PlaywrightWaitForFunctionOptions` | No       | —           |

**Returns** `unknown`

[Upstream docs](https://playwright.dev/docs/api/class-page#page-wait-for-function)

***

### waitForEvent(event, optionsOrPredicate?)

Wait for a specific event to fire.

```ts
await runtime.page.waitForEvent(/* K */);
```

| Parameter            | Type                                                                                                                                                                   | Required | Description |
| -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | ----------- |
| `event`              | `K`                                                                                                                                                                    | Yes      | —           |
| `optionsOrPredicate` | `{ predicate?: (event: PageEvents[K]) =&gt; boolean \| Promise&lt;boolean&gt;; timeout?: number } \| ((event: PageEvents[K]) =&gt; boolean \| Promise&lt;boolean&gt;)` | No       | —           |

**Returns** `PageEvents[K]`

[Upstream docs](https://playwright.dev/docs/api/class-page#page-wait-for-event)

***

### waitForRequest(urlOrPredicate, options?)

Wait for a specific request.

```ts
await runtime.page.waitForRequest(/* urlOrPredicate */);
```

| Parameter        | Type                                                                                         | Required | Description |
| ---------------- | -------------------------------------------------------------------------------------------- | -------- | ----------- |
| `urlOrPredicate` | `string \| RegExp \| ((request: PlaywrightRequest) =&gt; boolean \| Promise&lt;boolean&gt;)` | Yes      | —           |
| `options`        | `{ timeout?: number }`                                                                       | No       | —           |

**Returns** `PlaywrightRequest`

[Upstream docs](https://playwright.dev/docs/api/class-page#page-wait-for-request)

***

### waitForResponse(urlOrPredicate, options?)

Wait for a specific response.

```ts
await runtime.page.waitForResponse(/* urlOrPredicate */);
```

| Parameter        | Type                                                                                           | Required | Description |
| ---------------- | ---------------------------------------------------------------------------------------------- | -------- | ----------- |
| `urlOrPredicate` | `string \| RegExp \| ((response: PlaywrightResponse) =&gt; boolean \| Promise&lt;boolean&gt;)` | Yes      | —           |
| `options`        | `{ timeout?: number }`                                                                         | No       | —           |

**Returns** `PlaywrightResponse`

[Upstream docs](https://playwright.dev/docs/api/class-page#page-wait-for-response)

***

## Screenshots & PDF

### screenshot(options?)

Take a screenshot of the page.

```ts
await runtime.page.screenshot();
```

| Parameter | Type                          | Required | Description |
| --------- | ----------------------------- | -------- | ----------- |
| `options` | `PlaywrightScreenshotOptions` | No       | —           |

**Returns** `Buffer`

[Upstream docs](https://playwright.dev/docs/api/class-page#page-screenshot)

***

### pdf(options?)

Generate a PDF of the page (Chromium only).

```ts
await runtime.page.pdf();
```

| Parameter | Type                   | Required | Description |
| --------- | ---------------------- | -------- | ----------- |
| `options` | `PlaywrightPDFOptions` | No       | —           |

**Returns** `Buffer`

[Upstream docs](https://playwright.dev/docs/api/class-page#page-pdf)

***

## Evaluation

### evaluate(pageFunction, arg?)

Evaluate JavaScript in the page context.

```ts
await runtime.page.evaluate('...');
```

| Parameter      | Type                 | Required | Description |
| -------------- | -------------------- | -------- | ----------- |
| `pageFunction` | `Function \| string` | Yes      | —           |
| `arg`          | `unknown`            | No       | —           |

**Returns** `R`

[Upstream docs](https://playwright.dev/docs/api/class-page#page-evaluate)

***

### evaluateHandle(pageFunction, arg?)

Evaluate JavaScript and return a handle to the result.

```ts
await runtime.page.evaluateHandle('...');
```

| Parameter      | Type                 | Required | Description |
| -------------- | -------------------- | -------- | ----------- |
| `pageFunction` | `Function \| string` | Yes      | —           |
| `arg`          | `unknown`            | No       | —           |

**Returns** `RemotePlaywrightJSHandle`

[Upstream docs](https://playwright.dev/docs/api/class-page#page-evaluate-handle)

***

### \$eval(selector, pageFunction, arg?)

Find an element matching the selector and evaluate a function on it.

<Note>
  Deprecated: This method does not wait for the element to pass actionability checks. Use locator.evaluate() instead.
</Note>

```ts
await runtime.page.$eval('...', '...');
```

| Parameter      | Type                 | Required | Description |
| -------------- | -------------------- | -------- | ----------- |
| `selector`     | `string`             | Yes      | —           |
| `pageFunction` | `Function \| string` | Yes      | —           |
| `arg`          | `unknown`            | No       | —           |

**Returns** `T`

[Upstream docs](https://playwright.dev/docs/api/class-page#page-eval-on-selector)

***

### \$\$eval(selector, pageFunction, arg?)

Find all elements matching the selector and evaluate a function on the array of elements.

<Note>
  Deprecated: This method does not wait for elements to pass actionability checks. Use locator.evaluateAll() instead.
</Note>

```ts
await runtime.page.$$eval('...', '...');
```

| Parameter      | Type                 | Required | Description |
| -------------- | -------------------- | -------- | ----------- |
| `selector`     | `string`             | Yes      | —           |
| `pageFunction` | `Function \| string` | Yes      | —           |
| `arg`          | `unknown`            | No       | —           |

**Returns** `T`

[Upstream docs](https://playwright.dev/docs/api/class-page#page-eval-on-selector-all)

***

## Lifecycle

### close(options?)

Close the page.

```ts
await runtime.page.close();
```

| Parameter | Type                            | Required | Description |
| --------- | ------------------------------- | -------- | ----------- |
| `options` | `{ runBeforeUnload?: boolean }` | No       | —           |

[Upstream docs](https://playwright.dev/docs/api/class-page#page-close)

***

### bringToFront()

Bring page to front (activate tab).

```ts
await runtime.page.bringToFront();
```

[Upstream docs](https://playwright.dev/docs/api/class-page#page-bring-to-front)

***

## Other

### emulateMedia(options?)

Emulate media type, color scheme, etc.

```ts
await runtime.page.emulateMedia();
```

| Parameter | Type                            | Required | Description |
| --------- | ------------------------------- | -------- | ----------- |
| `options` | `PlaywrightEmulateMediaOptions` | No       | —           |

[Upstream docs](https://playwright.dev/docs/api/class-page#page-emulate-media)

***

### mainFrame()

Get the main frame.

```ts
await runtime.page.mainFrame();
```

**Returns** `RemotePlaywrightFrame`

[Upstream docs](https://playwright.dev/docs/api/class-page#page-main-frame)

***

### frames()

Get all frames attached to the page.

```ts
await runtime.page.frames();
```

**Returns** `RemotePlaywrightFrame[]`

[Upstream docs](https://playwright.dev/docs/api/class-page#page-frames)

***

### frame(frameSelector)

Get a frame by name or URL.

```ts
await runtime.page.frame(/* frameSelector */);
```

| Parameter       | Type                                                                                | Required | Description |
| --------------- | ----------------------------------------------------------------------------------- | -------- | ----------- |
| `frameSelector` | `string \| { name?: string; url?: string \| RegExp \| ((url: URL) =&gt; boolean) }` | Yes      | —           |

**Returns** `RemotePlaywrightFrame \| null`

[Upstream docs](https://playwright.dev/docs/api/class-page#page-frame)

***

### route(url, handler, options?)

Route requests matching the URL pattern.

```ts
await runtime.page.route(/* url */, /* PlaywrightRouteHandler */);
```

| Parameter | Type                                             | Required | Description |
| --------- | ------------------------------------------------ | -------- | ----------- |
| `url`     | `string \| RegExp \| ((url: URL) =&gt; boolean)` | Yes      | —           |
| `handler` | `PlaywrightRouteHandler`                         | Yes      | —           |
| `options` | `{ times?: number }`                             | No       | —           |

[Upstream docs](https://playwright.dev/docs/api/class-page#page-route)

***

### unroute(url, handler?)

Remove a route.

```ts
await runtime.page.unroute(/* url */);
```

| Parameter | Type                                             | Required | Description |
| --------- | ------------------------------------------------ | -------- | ----------- |
| `url`     | `string \| RegExp \| ((url: URL) =&gt; boolean)` | Yes      | —           |
| `handler` | `PlaywrightRouteHandler`                         | No       | —           |

[Upstream docs](https://playwright.dev/docs/api/class-page#page-unroute)

***

### unrouteAll(options?)

Remove all routes.

```ts
await runtime.page.unrouteAll();
```

| Parameter | Type                                                   | Required | Description |
| --------- | ------------------------------------------------------ | -------- | ----------- |
| `options` | `{ behavior?: "wait" \| "ignoreErrors" \| "default" }` | No       | —           |

[Upstream docs](https://playwright.dev/docs/api/class-page#page-unroute-all)

***

### setExtraHTTPHeaders(headers)

Set extra HTTP headers for all requests.

```ts
await runtime.page.setExtraHTTPHeaders(/* Record<string, string> */);
```

| Parameter | Type                           | Required | Description |
| --------- | ------------------------------ | -------- | ----------- |
| `headers` | `Record&lt;string, string&gt;` | Yes      | —           |

[Upstream docs](https://playwright.dev/docs/api/class-page#page-set-extra-http-headers)

***

### context()

Get the browser context that the page belongs to.

```ts
runtime.page.context();
```

**Returns** `unknown`

[Upstream docs](https://playwright.dev/docs/api/class-page#page-context)

***

### setDefaultTimeout(timeout)

Set the default timeout for all methods.

```ts
await runtime.page.setDefaultTimeout(0);
```

| Parameter | Type     | Required | Description |
| --------- | -------- | -------- | ----------- |
| `timeout` | `number` | Yes      | —           |

[Upstream docs](https://playwright.dev/docs/api/class-page#page-set-default-timeout)

***

### setDefaultNavigationTimeout(timeout)

Set the default navigation timeout.

```ts
await runtime.page.setDefaultNavigationTimeout(0);
```

| Parameter | Type     | Required | Description |
| --------- | -------- | -------- | ----------- |
| `timeout` | `number` | Yes      | —           |

[Upstream docs](https://playwright.dev/docs/api/class-page#page-set-default-navigation-timeout)

***

### addInitScript(script, arg?)

Add a script to evaluate before page scripts run.

```ts
await runtime.page.addInitScript(/* script */);
```

| Parameter | Type                                                        | Required | Description |
| --------- | ----------------------------------------------------------- | -------- | ----------- |
| `script`  | `Function \| string \| { path?: string; content?: string }` | Yes      | —           |
| `arg`     | `unknown`                                                   | No       | —           |

[Upstream docs](https://playwright.dev/docs/api/class-page#page-add-init-script)

***

### addScriptTag(options)

Add a \<script> tag to the page.

```ts
await runtime.page.addScriptTag(/* PlaywrightAddScriptTagOptions */);
```

| Parameter | Type                            | Required | Description |
| --------- | ------------------------------- | -------- | ----------- |
| `options` | `PlaywrightAddScriptTagOptions` | Yes      | —           |

**Returns** `RemotePlaywrightElementHandle`

[Upstream docs](https://playwright.dev/docs/api/class-page#page-add-script-tag)

***

### addStyleTag(options)

Add a \<style> tag to the page.

```ts
await runtime.page.addStyleTag(/* PlaywrightAddStyleTagOptions */);
```

| Parameter | Type                           | Required | Description |
| --------- | ------------------------------ | -------- | ----------- |
| `options` | `PlaywrightAddStyleTagOptions` | Yes      | —           |

**Returns** `RemotePlaywrightElementHandle`

[Upstream docs](https://playwright.dev/docs/api/class-page#page-add-style-tag)

***

### exposeBinding(name, callback, options?)

Expose a binding to the page (with source info).

```ts
await runtime.page.exposeBinding('...', '...');
```

| Parameter  | Type                   | Required | Description |
| ---------- | ---------------------- | -------- | ----------- |
| `name`     | `string`               | Yes      | —           |
| `callback` | `Function`             | Yes      | —           |
| `options`  | `{ handle?: boolean }` | No       | —           |

[Upstream docs](https://playwright.dev/docs/api/class-page#page-expose-binding)

***

### pause()

Pause script execution (for debugging).

```ts
await runtime.page.pause();
```

[Upstream docs](https://playwright.dev/docs/api/class-page#page-pause)

***

### video()

Get the video object if recording is enabled.

```ts
runtime.page.video();
```

**Returns** `{ path: () =&gt; Promise&lt;string \| null&gt;; saveAs: (path: string) =&gt; Promise&lt;void&gt;; delete: () =&gt; Promise&lt;void&gt; } \| null`

[Upstream docs](https://playwright.dev/docs/api/class-page#page-video)

***

### opener()

Get the page that opened this page (via window\.open).

```ts
await runtime.page.opener();
```

**Returns** `RemotePlaywrightPage \| null`

[Upstream docs](https://playwright.dev/docs/api/class-page#page-opener)

***

### workers()

Get all web workers in the page.

```ts
runtime.page.workers();
```

**Returns** `unknown[]`

[Upstream docs](https://playwright.dev/docs/api/class-page#page-workers)

***

### addLocatorHandler(locator, handler, options?)

Registers a handler that will be called when the specified locator becomes visible on the page.

<Note>
  Useful for handling overlays and popups that may appear during automation.
</Note>

```ts
await runtime.page.addLocatorHandler(/* RemotePlaywrightLocator */, /* (locator: RemotePlaywrightLocator) => Promise<void> */);
```

| Parameter | Type                                                           | Required | Description |
| --------- | -------------------------------------------------------------- | -------- | ----------- |
| `locator` | `RemotePlaywrightLocator`                                      | Yes      | —           |
| `handler` | `(locator: RemotePlaywrightLocator) =&gt; Promise&lt;void&gt;` | Yes      | —           |
| `options` | `PlaywrightAddLocatorHandlerOptions`                           | No       | —           |

[Upstream docs](https://playwright.dev/docs/api/class-page#page-add-locator-handler)

***

### removeLocatorHandler(locator)

Removes a previously added locator handler.

```ts
await runtime.page.removeLocatorHandler(/* RemotePlaywrightLocator */);
```

| Parameter | Type                      | Required | Description |
| --------- | ------------------------- | -------- | ----------- |
| `locator` | `RemotePlaywrightLocator` | Yes      | —           |

[Upstream docs](https://playwright.dev/docs/api/class-page#page-remove-locator-handler)

***

### consoleMessages()

Returns all console messages captured during the page lifecycle.

<Note>
  Note: This is a custom method that returns accumulated console messages.
</Note>

```ts
await runtime.page.consoleMessages();
```

**Returns** `PlaywrightConsoleMessage[]`

[Upstream docs](https://playwright.dev/docs/api/class-consolemessage)

***

### pageErrors()

Returns all page errors (uncaught exceptions) captured during the page lifecycle.

<Note>
  Note: This is a custom method that returns accumulated page errors.
</Note>

```ts
await runtime.page.pageErrors();
```

**Returns** `Error[]`

[Upstream docs](https://playwright.dev/docs/api/class-page#page-event-page-error)

***

### requestGC()

Request garbage collection in the page context.

<Note>
  Note: This method is only available in Chromium-based browsers.
</Note>

```ts
await runtime.page.requestGC();
```

[Upstream docs](https://playwright.dev/docs/api/class-page#page-request-gc)

***

### requests()

Returns all requests made by the page since the last navigation.

<Note>
  Note: This is a custom method that returns accumulated requests.
</Note>

```ts
await runtime.page.requests();
```

**Returns** `PlaywrightRequest[]`

[Upstream docs](https://playwright.dev/docs/api/class-request)

***

### routeFromHAR(har, options?)

Serves network requests from a HAR (HTTP Archive) file.

<Note>
  Useful for replaying recorded network traffic during tests.
</Note>

```ts
await runtime.page.routeFromHAR('...');
```

| Parameter | Type                            | Required | Description |
| --------- | ------------------------------- | -------- | ----------- |
| `har`     | `string`                        | Yes      | —           |
| `options` | `PlaywrightRouteFromHAROptions` | No       | —           |

[Upstream docs](https://playwright.dev/docs/api/class-page#page-route-from-har)

***

### routeWebSocket(url, handler)

Route WebSocket connections matching the URL pattern.

<Note>
  Allows intercepting and modifying WebSocket traffic.
</Note>

```ts
await runtime.page.routeWebSocket(/* url */, /* handler */);
```

| Parameter | Type                                                               | Required | Description |
| --------- | ------------------------------------------------------------------ | -------- | ----------- |
| `url`     | `string \| RegExp \| ((url: URL) =&gt; boolean)`                   | Yes      | —           |
| `handler` | `(ws: PlaywrightWebSocketRoute) =&gt; void \| Promise&lt;void&gt;` | Yes      | —           |

[Upstream docs](https://playwright.dev/docs/api/class-page#page-route-web-socket)

***

## Mouse

### mouse.click(x, y, options?)

Shortcut for mouse.move(), mouse.down(), mouse.up().

<Note>
  Simulates a mouse click at the specified coordinates.
</Note>

````ts
```ts
await page.mouse.click(100, 50);
await page.mouse.click(200, 100, { button: 'right', delay: 100 });
````

````

| Parameter | Type | Required | Description |
|---|---|---|---|
| `x` | `number` | Yes | X coordinate relative to the main frame viewport in CSS pixels. |
| `y` | `number` | Yes | Y coordinate relative to the main frame viewport in CSS pixels. |
| `options` | `PlaywrightMouseClickOptions` | No | Click options. |

[Upstream docs](https://playwright.dev/docs/api/class-mouse#mouse-click)

---

### mouse.dblclick(x, y, options?)

Shortcut for mouse.move(), mouse.down(), mouse.up(), mouse.down(), mouse.up().

<Note>
Simulates a double mouse click at the specified coordinates.
</Note>

```ts
```ts
await page.mouse.dblclick(100, 50);
await page.mouse.dblclick(200, 100, { delay: 50 });
````

````

| Parameter | Type | Required | Description |
|---|---|---|---|
| `x` | `number` | Yes | X coordinate relative to the main frame viewport in CSS pixels. |
| `y` | `number` | Yes | Y coordinate relative to the main frame viewport in CSS pixels. |
| `options` | `PlaywrightMouseDblclickOptions` | No | Double-click options. |

[Upstream docs](https://playwright.dev/docs/api/class-mouse#mouse-dblclick)

---

### mouse.down(options?)

Dispatches a mousedown event.

```ts
await runtime.page.mouse.down();
````

| Parameter | Type                           | Required | Description         |
| --------- | ------------------------------ | -------- | ------------------- |
| `options` | `PlaywrightMouseDownUpOptions` | No       | Mouse down options. |

[Upstream docs](https://playwright.dev/docs/api/class-mouse#mouse-down)

***

### mouse.up(options?)

Dispatches a mouseup event.

```ts
await runtime.page.mouse.up();
```

| Parameter | Type                           | Required | Description       |
| --------- | ------------------------------ | -------- | ----------------- |
| `options` | `PlaywrightMouseDownUpOptions` | No       | Mouse up options. |

[Upstream docs](https://playwright.dev/docs/api/class-mouse#mouse-up)

***

### mouse.move(x, y, options?)

Dispatches a mousemove event.

<Note>
  The steps option controls the number of intermediate mousemove events to generate.
</Note>

```ts
await runtime.page.mouse.move(0, 0);
```

| Parameter | Type                         | Required | Description                                                     |
| --------- | ---------------------------- | -------- | --------------------------------------------------------------- |
| `x`       | `number`                     | Yes      | X coordinate relative to the main frame viewport in CSS pixels. |
| `y`       | `number`                     | Yes      | Y coordinate relative to the main frame viewport in CSS pixels. |
| `options` | `PlaywrightMouseMoveOptions` | No       | Mouse move options.                                             |

[Upstream docs](https://playwright.dev/docs/api/class-mouse#mouse-move)

***

### mouse.wheel(deltaX, deltaY)

Dispatches a wheel event.

<Note>
  This method is usually used to manually scroll the page.
  Wheel events may cause scrolling if they are not handled, and this method does not wait for the scrolling to finish before returning.
</Note>

````ts
```ts
// Scroll down by 100 pixels
await page.mouse.wheel(0, 100);
````

````

| Parameter | Type | Required | Description |
|---|---|---|---|
| `deltaX` | `number` | Yes | Pixels to scroll horizontally. |
| `deltaY` | `number` | Yes | Pixels to scroll vertically. |

[Upstream docs](https://playwright.dev/docs/api/class-mouse#mouse-wheel)

---

## Keyboard

### keyboard.down(key)

Dispatches a keydown event.

<Note>
If key is a single character and no modifier keys besides Shift are being held down,
a keypress/input event will also be generated. The text option can be specified to force an input event to be generated.

Modifier keys DO affect keyboard.down. Holding down Shift will type the text in upper case.
</Note>

```ts
await runtime.page.keyboard.down('...');
````

| Parameter | Type     | Required | Description                                                                      |
| --------- | -------- | -------- | -------------------------------------------------------------------------------- |
| `key`     | `string` | Yes      | Name of the key to press or a character to generate, such as `ArrowLeft` or `a`. |

[Upstream docs](https://playwright.dev/docs/api/class-keyboard#keyboard-down)

***

### keyboard.up(key)

Dispatches a keyup event.

```ts
await runtime.page.keyboard.up('...');
```

| Parameter | Type     | Required | Description                                |
| --------- | -------- | -------- | ------------------------------------------ |
| `key`     | `string` | Yes      | Name of the key to release or a character. |

[Upstream docs](https://playwright.dev/docs/api/class-keyboard#keyboard-up)

***

### keyboard.press(key, options?)

Shortcut for keyboard.down() and keyboard.up().

<Note>
  Dispatches a keydown, keypress/input, and keyup event for the specified key.

  If key is a single character and no modifier keys besides Shift are being held down,
  a keypress/input event will also be generated.

  Modifier keys DO affect keyboard.press. Holding down Shift will type the text in upper case.

  Shortcut such as "ControlOrMeta+A" are supported. "ControlOrMeta" resolves to "Control" on Windows/Linux and to "Meta" on macOS.
</Note>

````ts
```ts
await page.keyboard.press('Enter');
await page.keyboard.press('Shift+A');
await page.keyboard.press('ControlOrMeta+A');
````

````

| Parameter | Type | Required | Description |
|---|---|---|---|
| `key` | `string` | Yes | Key to press. Can be a character or a special key name (e.g., `ArrowLeft`, `Shift+A`, `ControlOrMeta+A`). |
| `options` | `PlaywrightKeyboardPressOptions` | No | Options for the key press event. |

[Upstream docs](https://playwright.dev/docs/api/class-keyboard#keyboard-press)

---

### keyboard.type(text, options?)

Sends a keydown, keypress/input, and keyup event for each character in the text.

<Note>
Use this method when you need to simulate typing character by character,
for example, if the page has custom keyboard event listeners.

Modifier keys DO NOT affect keyboard.type. Holding down Shift will not type the text in upper case.

For characters not present on a standard US keyboard layout, only an input event will be dispatched.

For simple text input, locator.fill() is generally preferred.
</Note>

```ts
```ts
await page.keyboard.type('Hello'); // Types instantly
await page.keyboard.type('World', { delay: 100 }); // Types slower, like a user
````

````

| Parameter | Type | Required | Description |
|---|---|---|---|
| `text` | `string` | Yes | Text to type. |
| `options` | `PlaywrightKeyboardTypeOptions` | No | Options for typing. |

[Upstream docs](https://playwright.dev/docs/api/class-keyboard#keyboard-type)

---

### keyboard.insertText(text)

Dispatches only an input event, does not emit keydown, keyup, or keypress events.

<Note>
This method is useful for directly inserting text without simulating physical key presses.

Modifier keys DO NOT affect keyboard.insertText. Holding down Shift will not type the text in upper case.
</Note>

```ts
```ts
await page.keyboard.insertText('Hello');
````

````

| Parameter | Type | Required | Description |
|---|---|---|---|
| `text` | `string` | Yes | Text to insert. |

[Upstream docs](https://playwright.dev/docs/api/class-keyboard#keyboard-insert-text)

---

## Touchscreen

### touchscreen.tap(x, y)

Dispatches a touchstart and touchend event with a single touch at the position (x, y).

<Note>
This method simulates a tap gesture on a touchscreen device.

Note: The page must be initialized with hasTouch option of the browser context set to true.
</Note>

```ts
```ts
await page.touchscreen.tap(100, 200);
````

```

| Parameter | Type | Required | Description |
|---|---|---|---|
| `x` | `number` | Yes | X coordinate relative to the main frame viewport in CSS pixels. |
| `y` | `number` | Yes | Y coordinate relative to the main frame viewport in CSS pixels. |

[Upstream docs](https://playwright.dev/docs/api/class-touchscreen#touchscreen-tap)

---
```