从一个生成 PDF 的需求中接触到了 Puppeteer ,随着使用场景的深入,异常问题也越发难以处理。索性纪录一下摸索过程,供新手参考学习。

一、Chromium revision is not downloaded

1
UnhandledPromiseRejectionWarning: Unhandled promise rejection (rejection id: 1): Error: Chromium revision is not downloaded. Run "npm install" or "yarn install”

遇到这个问题,说明你并没有成功下载 Chromium手动下载(需要翻墙)可以解决你的问题。

二、Unhandled promise rejection

需要使用 catch 处理异常,所以你需要这么处理:

1
2
3
4
5
6
7
8
9
10
11
12
const puppeteer = require('puppeteer');
(async () => {
const browser = await puppeteer.launch({
executablePath: 'chromium/Chromium.app/Contents/MacOS/Chromium',
headless: true
});
const page = await browser.newPage();
await page.goto('http://jartto.wang');
await page.screenshot({path: 'temp/blog.png'});
await browser.close();
})().catch(error => console.log('error: ', error.message));

重点关注最后一行即可。

三、spawn EACCES

没有权限,需要执行:

1
sudo chmod -R a+rwx chromium/Chromium.app

之后请设置正确的引用路径:

1
executablePath: 'chromium/Chromium.app/Contents/MacOS/Chromium',

四、PrintToPDF is not implemented

出现这个问题,是因为 headless: false

1
2
3
const browser = await puppeteer.launch({
headless: false
});

官方文档中是这么说的:

NOTE Generating a pdf is currently only supported in Chrome headless.

五、生成 PDF 乱码问题

小技巧:如果你发现无头打印异常,可以将设置改掉 headless: false,通过调试工具打开。

六、在 Docker 中使用

Docker 中使用 Puppeteer 稍显复杂,因为其 node 库中自带的 Chromium 缺少一些依赖。这些依赖在桌面环境中一般都已自带,但是在 Dockernode 源镜像例如 node-alpine 或者 node-slim 是缺失的。所以,在 Docker 中使用 Puppeteer 需要首先安装这些缺失的依赖。

具体细节,请移步在 Docker 中使用

七、更改默认视口

1
await page.setViewport({width: 1024, height: 880});
1
2
3
4
5
6
7
8
9
const COOKS =[
{
'domain': 'jartto.wang',
'name': 'user',
'value': 'jartto',
}
]
await page.setCookie(...COOKS);

九、模拟点击

1
2
3
4
5
6
// 输入框 id,搜索关键字 jartto
await page.type('#index-kw', 'jartto');
// 模拟点击提交按钮
await page.click('#index-bn');
// 跳转等待时间
await page.waitForNavigation({ timeout: 3000 });