/screencast API

The screencast API allows for generating video files, on demand, of your puppteer scripts. This simple REST API allows for POSTing of a application/json or application/javascript body of your code you'd like to record. The resulting response is a webm file with the video attached.

Screencasting is in beta, and only supports video with audio coming soon.

Using application/javascript content-type

When using this API you'll need to specify an appropriate content-type for the body of the request. When the type is application/json the /screencast API follows a similar semantic of the /function API, where you'll apply both a code property and a context property. This makes your request more re-usable as you can specify arguments in the context property that your code can reference:

Example code body

module.exports = async ({ page, context }) => {
  const { url, wait } = context;
  await page.goto(url);
  await page.waitFor(wait);
};

Full Eample JSON body

// JSON body
// Code is minifed here!
{
  "code": "module.exports=async({page:a,context:b})=>{const{url:c,wait:d}=b;await a.goto(c),await a.waitFor(d)};",
  "context": {
    "url": "https://example.com",
    "wait": 1000
  }
}

Full cURL (with an API token)

curl -X POST \
  https://chrome.browserless.io/screencast?token=MY-API-TOKEN \
  -H 'Content-Type: application/json' \
  -d '{
  "code": "module.exports=async({page:a,context:b})=>{const{url:c,wait:d}=b;await a.goto(c),await a.waitFor(d)};",
  "context": {
    "url": "https://example.com",
    "wait": 1000
  }
}'

Using application/javascript content-type

The application/javascript content-type is great for testing quick scripts and seeing their output, and works with many tools like postman for faster feedback. The only limitation is that you cannot post any arguments into your script via context, and all parameters will need to be hard-coded.

Example body

module.exports = async ({ page, context }) => {
  await page.goto('https://example.com/');
  await page.waitFor(1000);
};

And the resulting cURL call:

Full cURL (with an API token)

curl -X POST \
  https://chrome.browserless.io/screencast?token=MY-API-TOKEN \
  -H 'Content-Type: application/javascript' \
  -d 'module.exports = async ({ page, context }) => {
        await page.goto('https://example.com/');
        await page.waitFor(1000);
      };'