Skip to main content

ensureBrowser()v4.0.137

Ensures a browser is locally installed so a Remotion render can be executed.

Simple usage
tsx
import {ensureBrowser} from '@remotion/renderer';
 
await ensureBrowser();
Setting a specific Chrome version and listening to progress
tsx
import {ensureBrowser} from '@remotion/renderer';
 
await ensureBrowser({
  onBrowserDownload: () => {
    console.log('Downloading browser');
 
    return {
      version: '134.0.6998.35',
      onProgress: ({percent}) => {
        console.log(`${Math.round(percent * 100)}% downloaded`);
      },
    };
  },
});

API​

An object with the following properties, all of which are optional:

chromeMode?v4.0.248​

One of headless-shell, chrome-for-testing. Default headless-shell. Use chrome-for-testing to take advantage of GPU drivers on Linux.

browserExecutable?​

Pass a path to a browser executable that you want to use instead of downloading.
If the path does not exist, this function will throw.
Pass the same path to any other API that supports the browserExecutable option.

logLevel?​

One of trace, verbose, info, warn, error.
Determines how much info is being logged to the console.

Default info.

onBrowserDownload​

Specify a specific version of Chrome that should be used and hook into the download progress.
See the example below for the function signature.

init.ts
tsx
import {ensureBrowser, OnBrowserDownload, DownloadBrowserProgressFn} from '@remotion/renderer';
 
const onProgress: DownloadBrowserProgressFn = ({percent, downloadedBytes, totalSizeInBytes}) => {
  console.log(`${Math.round(percent * 100)}% downloaded`);
};
 
const onBrowserDownload: OnBrowserDownload = () => {
  console.log('Downloading browser');
 
  return {
    // Pass `null` to use Remotion's recommendation.
    version: '134.0.6998.35',
    onProgress,
  };
};
 
await ensureBrowser({
  onBrowserDownload,
});

Return value​

A promise with no value.

See also​