@replayio/puppeteer

Provides utilities to support using Replay with Puppeteer

Use with replayio/action-upload to automatically upload replays of puppeteer scripts. Check out our documentation here.

Exports

• getExecutablePath() - Returns the path to the replay chromium browser.
• getMetadataFilePath(workerIndex: number = 0) - Returns the path of a worker-specific metadata file keyed by the workerIndex. The file path will be within the RECORD_REPLAY_DIRECTORY.

Metadata

You can add metadata to your puppeteer recordings using either the RECORD_REPLAY_METADATA or RECORD_REPLAY_METADATA_FILE environment variable. If both are set, RECORD_REPLAY_METADATA_FILE takes precedence.

Currently, this metadata is only available locally except for title

• RECORD_REPLAY_METADATA_FILE - The path to a file containing JSON-formatted metadata
• RECORD_REPLAY_METADATA - JSON-formatted metadata string

1const puppeteer = require("puppeteer");
2const { getExecutablePath } = require("@kitchensink/replayio-puppeteer");
3
4(async () => {
5  const browser = await puppeteer.launch({
6    headless: false,
7    executablePath: getExecutablePath(),
8  });
9  const page = await browser.newPage();
10  await page.goto("https://replay.io");
11  await page.screenshot({ path: "replay.png" });
12
13  await page.close();
14  await browser.close();
15})();