8e1c8b9be6
* chore(main): release 17.1.1 * chore: generate versioned docs Co-authored-by: release-please[bot] <55107282+release-please[bot]@users.noreply.github.com>
45 lines
1.1 KiB
Markdown
45 lines
1.1 KiB
Markdown
---
|
|
sidebar_label: Page.emulate
|
|
---
|
|
|
|
# Page.emulate() method
|
|
|
|
Emulates given device metrics and user agent.
|
|
|
|
**Signature:**
|
|
|
|
```typescript
|
|
class Page {
|
|
emulate(options: {viewport: Viewport; userAgent: string}): Promise<void>;
|
|
}
|
|
```
|
|
|
|
## Parameters
|
|
|
|
| Parameter | Type | Description |
|
|
| --------- | --------------------------------------------------------------------- | ----------- |
|
|
| options | { viewport: [Viewport](./puppeteer.viewport.md); userAgent: string; } | |
|
|
|
|
**Returns:**
|
|
|
|
Promise<void>
|
|
|
|
## Remarks
|
|
|
|
List of all available devices is available in the source code: [src/common/DeviceDescriptors.ts](https://github.com/puppeteer/puppeteer/blob/main/src/common/DeviceDescriptors.ts).
|
|
|
|
## Example
|
|
|
|
```ts
|
|
const puppeteer = require('puppeteer');
|
|
const iPhone = puppeteer.devices['iPhone 6'];
|
|
(async () => {
|
|
const browser = await puppeteer.launch();
|
|
const page = await browser.newPage();
|
|
await page.emulate(iPhone);
|
|
await page.goto('https://www.google.com');
|
|
// other actions...
|
|
await browser.close();
|
|
})();
|
|
```
|