使用示例(nodejs 模块 API 方式)
//import convert from 'webp-batch-convert';
const convert = require('webp-batch-convert');
let res;
// 示例一: 生成 img 目录下的图片文件至 webp 目录
res = await convert.cwebp('./img', './webp');
console.log('total: ', res);
// 示例二: 生成 img 目录下的图片文件至 webp 目录，附带质量等参数
// 更多参数参考：https://developers.google.com/speed/webp/docs/cwebp?csw=1#options
// 也可以执行如下命令通过 cwebp 帮助信息了解： `yarn cwebp --longhelp`
const cwebpOpts = {
/** don't print anything */
quiet: true,
/** quality factor (0:small..100:big), default=75 */
q: 75,
/** transparency-compression quality (0..100), default=100 */
alpha_q: 100,
/** spatial noise shaping (0:off, 100:max), default=50 */
sns: 50,
/** filter strength (0=off..100), default=60 */
f: 60,
/** use simple filter instead of strong */
nostrong: false,
// 先清空输出目录
convert.utils.delDir('./webp');
res = await convert.cwebp('./img','./webp', cwebpOpts);
console.log('total: ', res);
best-practice
https://github.com/lzwme/webp-batch-convert/tree/master/best-practice
命令行方式使用(wbc / cwebp-batch)
npm install -g webp-batch-convert
wbc -h
cwebp-batch -h
也可以不安装，使用
npx
执行：
npx webp-batch-convert -h
wbc --in img-folder --out webp-folder <--debug --q 75>
或者局部安装，然后如下方式使用：
./node_modules/.bin/wbc --in img-folder --out webp-folder <-D -q 75>
.cwebp(imgDir, webpDir, cwebpOptions)
批量转换生成 webp。示例：
// 将 img 目录下的所有图片转换为 webp 文件，输出至 webp 目录
const res = await convert.cwebp('./img','./webp', {
debug: true,
q: 60 // 质量
});
console.log('result: ' + res);
.utils.mkDir(dirPath)
创建一个(深度的)目录。示例：
// 创建目录
convert.utils.mkDir('./src/assets/webp');
.utils.delDir(dirPath, ext)
清空一个（非空的）目录。示例：
// 删除 webp 目录
convert.utils.delDir('./webp');
// 删除 webp 目录下的所有 webp 后缀的文件
convert.utils.delDir('./webp', 'webp');
// 删除 webp 目录下的所有 .webp、png 后缀的文件
convert.utils.delDir('./webp', /\.(webp|png)$/);
依赖安装
pnpm install
修改/新增功能
添加测试并执行
pnpm test
全局安装与测试
npm link . && wbc -h
License
webp-batch-convert
is released under the MIT license.
