Skip to main content
Version: 21.9.0

Page.screencast() method

Captures a screencast of this page.

Signature:

class Page {
screencast(options?: Readonly<ScreencastOptions>): Promise<ScreenRecorder>;
}

Parameters

ParameterTypeDescription
optionsReadonly<ScreencastOptions>(Optional) Configures screencast behavior.

Returns:

Promise<ScreenRecorder>

Remarks

All recordings will be WebM format using the VP9 video codec. The FPS is 30.

You must have ffmpeg installed on your system.

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.screencast({path: 'recording.webm'});

// Do something.

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

browser.close();