Skip to main content
Version: 25.10.0

Page.record() method

Records this page using the Chrome DevTools Protocol Page.startScreenRecording API.

Outputs mp4 video stream.

Signature

class Page {
record(options?: Readonly<RecordOptions>): Promise<ScreenRecording>;
}

Parameters

Parameter

Type

Description

options

Readonly<RecordOptions>

(Optional) Configures recording behavior.

Returns:

Promise<ScreenRecording>

Example

Recording a page:

import puppeteer from 'puppeteer';

// Launch a browser
const browser = await puppeteer.launch();

// Create a new page
const page = await browser.newPage();

// Go to your site.
await page.goto('https://www.example.com');

// Start recording.
const recorder = await page.record({path: 'recording.mp4'});

// Do something.

// Stop recording.
await recorder.stop();

await browser.close();