puppeteer/website/versioned_docs/version-18.0.5/api/puppeteer.page.emulate.md
release-please[bot] ddc567a4b6
chore(main): release 18.0.5 (#8997)
* chore(main): release 18.0.5

* chore: generate versioned docs

Co-authored-by: release-please[bot] <55107282+release-please[bot]@users.noreply.github.com>
2022-09-22 10:46:01 +02:00

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&lt;void&gt;
## 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();
})();
```