Tool to resolve puppeteer and chromium faster, detect local installed chromium, download chromium with custom mirror host, cache chromium revision out of node_modules, test chromium headless being launchable.
npm install puppeteer-chromium-resolver
sh
npm i puppeteer-chromium-resolver
`
Usage
$3
`js
const PCR = require("puppeteer-chromium-resolver");
const options = {};
const stats = await PCR(options);
const browser = await stats.puppeteer.launch({
headless: false,
args: ["--no-sandbox"],
executablePath: stats.executablePath
}).catch(function(error) {
console.log(error);
});
const page = await browser.newPage();
await page.goto("https://www.npmjs.com/package/puppeteer-chromium-resolver");
await browser.close();
`
$3
`js
const PCR = require("puppeteer-chromium-resolver");
const options = {};
const stats = PCR.getStats(options);
if (stats) {
stats.puppeteer.launch({
headless: false,
args: ["--no-sandbox"],
executablePath: stats.executablePath
}).then(function(browser){
//...
}).catch(function(error) {
console.log(error);
});
}
`
Default Options
`js
const options = {
// the chromium revision to use
// default is puppeteer.PUPPETEER_REVISIONS.chromium
// or you can use PUPPETEER_REVISION environment variable
revision: '',
// additional path to detect local chromium copy (separate with a comma if multiple paths)
detectionPath: '',
// custom path to download chromium to local, require dir permission: 0o777
// default is user home dir
downloadPath: '',
// the folder name for chromium snapshots (maybe there are multiple versions)
folderName: '.chromium-browser-snapshots',
// the stats file name, cache stats info for latest installation
statsName: '.pcr-stats.json',
// default hosts are ['https://storage.googleapis.com']
// or you can use PUPPETEER_DEFAULT_HOST environment variable
hosts: [],
cacheRevisions: 2,
retry: 3,
silent: false
};
`
see lib/options.js
$3
`json
{
// ...
"pcr": {
"revision": "1138907"
}
}
`
Return Stats
|Property | Type | |
| :--------------| :------ | :---------------------- |
|revision | String |current chromium revision |
|executablePath | String |chromium executable path |
|chromiumVersion | String |chromium version |
|launchable | Boolean |chromium launchable |
|puppeteerVersion| String |puppeteer version |
|puppeteer | Object |puppeteer module |
Test Cases
see test/test.js
$3
* 1, Sets env PUPPETEER_SKIP_DOWNLOAD to skip download Chromium when installation (.npmrc)
`
PUPPETEER_SKIP_DOWNLOAD=true
`
* 2, Sets env PUPPETEER_EXECUTABLE_PATH to PCR executablePath globally or pass in launch option executablePath
`js
(async () => {
const PCR = require("puppeteer-chromium-resolver");
const puppeteer = require("puppeteer");
const stats = await PCR({});
//update global env
process.env.PUPPETEER_EXECUTABLE_PATH = stats.executablePath;
//or specify executablePath
const browser = await puppeteer.launch({
executablePath: stats.executablePath,
headless: false
});
})();
`
Troubleshooting
- CentOS: error while loading shared libraries: libatk-1.0.so.0: cannot open shared objecsuch file or directory
`sh
Install dependencies:
yum install -y alsa-lib.x86_64 \
atk.x86_64 \
cups-libs.x86_64 \
gtk3.x86_64 \
ipa-gothic-fonts \
libXcomposite.x86_64 \
libXcursor.x86_64 \
libXdamage.x86_64 \
libXext.x86_64 \
libXi.x86_64 \
libXrandr.x86_64 \
libXScrnSaver.x86_64 \
libXtst.x86_64 \
pango.x86_64 \
xorg-x11-fonts-100dpi \
xorg-x11-fonts-75dpi \
xorg-x11-fonts-cyrillic \
xorg-x11-fonts-misc \
xorg-x11-fonts-Type1 \
xorg-x11-utils
After installing dependencies you need to update nss library:
yum update nss -y
`
- Debian (e.g. Ubuntu): error while loading shared libraries: libgobject-2.0.so.0: cannot open shared object file: No such file or directory
`sh
sudo apt-get install -y ca-certificates fonts-liberation libasound2 libatk-bridge2.0-0 libatk1.0-0 libc6 libcairo2 libcups2 libdbus-1-3 libexpat1 libfontconfig1 libgbm1 libgcc1 libglib2.0-0 libgtk-3-0 libnspr4 libnss3 libpango-1.0-0 libpangocairo-1.0-0 libstdc++6 libx11-6 libx11-xcb1 libxcb1 libxcomposite1 libxcursor1 libxdamage1 libxext6 libxfixes3 libxi6 libxrandr2 libxrender1 libxss1 libxtst6 lsb-release wget xdg-utils
``