Node library for controlling a Chromium instance running in a Docker container
Requirements:
npm install --save docker-chromium
const {
dockerSetChromiumConfig,
dockerRunChromium,
dockerShutdownChromium
} = require("docker-chromium");
(async () => {
await dockerSetChromiumConfig({
revision: "123456"
flags: [' -–ignore-certificate-errors']
});
const webSocketUri = await dockerRunChromium();
// do some other stuff...
await dockerShutdownChromium();
})();Default is trying to connect to Chromium 5 times with a 500 milisecond interval between each attempt. You can customize timeout/attempts by passing arguments to dockerRunChromium:
// ...
const webSocketUri = await dockerRunChromium({
maxAttempts: 10,
retryInterval: 5000 // 5 seconds
});Or by defining environment variables DOCKER_CHROMIUM_MAX_ATTEMPTS and DOCKER_CHROMIUM_RETRY_INTERVAL. Passing arguments to dockerRunChromium takes precedence over environment variables.
docker-chromium pulls a pre-built Docker image running a version of Chromium specified by you from a Docker Hub repository. You can then fetch the WebSocket URI to connect to the instance in your own application. If the pre-built image is unavailable or corrupt (rare case), a backup mechanism is in place, which builds the image from scratch locally instead.
Due to Ubuntu 14.04 LTS transitioning to ESM support, we have had to upgrade the Ubuntu version to 18.04 LTS. The Dockerfile used in the pre-built version in Docker Hub remains on the old version. Until this is changed, we have to disable this option for the time being.
Function which is used for the configuration of Chromium, before running it with dockerRunChromium.
await dockerSetChromiumConfig({
revision: '123456',
flags: [' -–ignore-certificate-errors']
});-
revision: string- Required
- Describes version number for Chromium
-
flags: string[]- Optional
- Defaults to
process.env.CHROMIUM_ADDITIONAL_ARGS - Describes command line flags that Chromium accepts.
-
downloadHost: string- Optional
- Defaults to
process.env.PUPPETEER_DOWNLOAD_HOST || process.env.npm_config_puppeteer_download_host || process.env.npm_package_config_puppeteer_download_host || 'https://storage.googleapis.com' - Describes host address for downloading of Chromium.
- Describes only the beginning of address, like this rule:
$CHROMIUM_DOWNLOAD_HOST/chromium-browser-snapshots/Linux_x64/$REV/chrome-linux.zip-$CHROMIUM_DOWNLOAD_HOSTdescribesdownloadHostargument - Example: If we run
dockerSetChromiumConfig({downloadHost: 'https://internal.service.com, revision: 99999}), it means that Chromium snapshot will be downloaded from https://internal.service.com/chromium-browser-snapshots/Linux_x64/99999/chrome-linux.zip
-
useClosestUbuntuMirror: boolean- Optional
- Defaults to
process.env.USE_CLOSEST_UBUNTU_MIRROR || process.env.npm_config_use_closest_ubuntu_mirror || process.env.npm_package_config_use_closest_ubuntu_mirror|| false - Flag for setting whether Ubuntu should use the default mirror for fetching packages, or pick the closest mirror depending on location
Function which is used to build and run the Docker container.
const webSocketUri = await dockerRunChromium({
maxAttempts: 10,
retryInterval: 5000
});maxAttempts: number- Optional
- Defaults to 5
- Describes number of attempts to connect to Chromium in the launched container (sometimes it fails).
retryInterval: number- Optional
- Defaults to 500
- Describes number of milliseconds between attempts to connect to Chromium in the launched container.
Promise<string>- Returns web socket URI to the launched Chromium in the container.
- By using this URI we can connect to Chromium and control it.
Function which is used to shutdown the launched Docker container.
await dockerShutdownChromium();