mirror of
https://github.com/puppeteer/puppeteer
synced 2024-06-14 14:02:48 +00:00
feat: add documentation (#8593)
This commit is contained in:
50
docs/api/puppeteer.elementhandle.type.md
Normal file
50
docs/api/puppeteer.elementhandle.type.md
Normal file
@@ -0,0 +1,50 @@
|
||||
---
|
||||
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()](./puppeteer.elementhandle.press.md).
|
||||
|
||||
**Signature:**
|
||||
|
||||
```typescript
|
||||
class ElementHandle {
|
||||
type(
|
||||
text: string,
|
||||
options?: {
|
||||
delay: number;
|
||||
}
|
||||
): Promise<void>;
|
||||
}
|
||||
```
|
||||
|
||||
## Parameters
|
||||
|
||||
| Parameter | Type | Description |
|
||||
| --------- | ------------------ | ----------------- |
|
||||
| text | string | |
|
||||
| options | { delay: number; } | <i>(Optional)</i> |
|
||||
|
||||
**Returns:**
|
||||
|
||||
Promise<void>
|
||||
|
||||
## Example 1
|
||||
|
||||
```ts
|
||||
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:
|
||||
|
||||
```ts
|
||||
const elementHandle = await page.$('input');
|
||||
await elementHandle.type('some text');
|
||||
await elementHandle.press('Enter');
|
||||
```
|
||||
Reference in New Issue
Block a user