web-to-png

使用 Node.js + Puppeteer 将 HTML 文件或 URL 转换为图片，支持长图（整页）截图。

安装

• 需要已安装 Node.js（建议 18+）。
• 已在项目中添加 Puppeteer 依赖，首次安装会自动下载 Chromium。

使用

1. 将本地 HTML 转成 PNG（默认长图）

npm run web-to-image -- samples/long.html --output samples/long.png

2. 将在线 URL 转成 JPEG（质量 90）

npm run web-to-image -- https://example.com --type jpeg --quality 90 --output out.jpg

3. 自定义视口大小并关闭长图（仅当前视口）

npm run web-to-image -- samples/long.html --width 1440 --height 900 --no-full --output viewport.png

CLI 参数

• input：必填，本地 HTML 文件路径或 http(s):///file:// URL。
• --output, -o：输出图片路径，默认 output.png。
• --type, -t：图片类型 png|jpeg，默认 png。
• --width, -w：页面视口宽度，默认 1280。
• --height, -h：页面视口高度，默认 800。
• --quality, -q：JPEG 质量 0-100，默认 80（仅对 jpeg 生效）。
• --wait：加载后额外等待毫秒数（处理异步渲染场景）。
• --no-full：关闭整页截图，改为仅当前视口截图。

说明

• 对于本地 HTML，脚本会自动使用 file:// 协议加载，无需本地服务器。
• 默认使用整页截图（长图），适合需要完整页面内容的场景。
• 如页面包含异步内容，可通过 --wait 传入等待时间确保内容渲染完成。