puppeteer/docs/api/puppeteer.page.emulate.md

47 lines
1013 B
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();
})();
```