puppeteer/docs/api/puppeteer.elementhandle.type.md
Marcus Otterström 28154eff6f
docs: Document options (#10035)
Co-authored-by: Alex Rudenko <alexrudenko@chromium.org>
2023-04-19 08:19:50 +00:00

1.2 KiB

sidebar_label
ElementHandle.type

ElementHandle.type() method

Focuses the element, and then sends a keydown, keypress/input, and keyup event for each character in the text.

To press a special key, like Control or ArrowDown, use ElementHandle.press().

Signature:

class ElementHandle {
  type(
    text: string,
    options?: {
      delay: number;
    }
  ): Promise<void>;
}

Parameters

Parameter Type Description
text string
options { delay: number; } (Optional) Delay in milliseconds. Defaults to 0.

Returns:

Promise<void>

Example 1

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

Example 2

An example of typing into a text field and then submitting the form:

const elementHandle = await page.$('input');
await elementHandle.type('some text');
await elementHandle.press('Enter');