replayio / puppeteer

Replay enabled fork of the puppeteer library

puppeteer

Replay enabled fork of the Puppeteer library.

Overview

This is an alternative to Puppeteer that uses a replay enabled chromium where possible, simplifying installation and versioning when compared with configuring the standard Puppeteer library to use replay browsers directly.

Installation

npm i @recordreplay/puppeteer

Usage

Replace puppeteer with @recordreplay/puppeteer in require/import statements, and this library will be used instead. On supported platforms (see below), replay enabled browsers will be used to make recordings and save them to disk. After running any puppeteer scripts, use the replay-recordings CLI tool to manage and upload the recordings.

Supported Platforms

The replay enabled chromium is currently only supported on linux.

puppeteer's Issues

Respect env vars to skip browser download

Puppeteer looks for six different environment variables (!) to decide whether to skip downloading the browser (https://github.com/RecordReplay/puppeteer/blob/main/install.js). We should avoid downloading the replay browser as well if any of these are set.

Launching chromium often hangs on ubuntu 20

Continuation from #2

I did some testing on our ubuntu 20 box and discovered that our playwright fork is able to consistently record with both FF and chromium but puppeteer consistently crashes when recording.

Both of the following run correctly (climatescape.js is a copy of our playwright-tests example)

PLAYWRIGHT_CHROMIUM=1 PLAYWRIGHT_HEADLESS=1 node ./climatescape.js 
PLAYWRIGHT_HEADLESS=1 node ./climatescape.js 

When I update that script to use puppeteer instead, it hangs when trying to open a new page.