@pz4l/tinyimg-webpack

用于 Webpack 的 TinyPNG 图片压缩插件。

Peer dependency: webpack ^5.0.0

安装

npm i -D @pz4l/tinyimg-webpack

使用

零配置使用：

// webpack.config.ts
import TinyimgWebpackPlugin from '@pz4l/tinyimg-webpack'

export default {
  plugins: [new TinyimgWebpackPlugin()],
}

带配置：

// webpack.config.ts
import TinyimgWebpackPlugin from '@pz4l/tinyimg-webpack'

export default {
  // ...other config
  plugins: [
    new TinyimgWebpackPlugin({
      strategy: 'AUTO',
      maxFileSize: 5 * 1024 * 1024,
      convertPngToJpg: false,
      parallel: 3,
    }),
  ],
}

配置项

| 配置项 | 类型 | 默认值 | 说明 | | --------------- | ------------------------------------------------- | ----------------- | ------------------------------- | | strategy | 'API_ONLY' \| 'RANDOM' \| 'API_FIRST' \| 'AUTO' | 'AUTO' | 压缩策略 | | maxFileSize | number | 5 * 1024 * 1024 | 本地预压缩前的单个文件最大大小 | | convertPngToJpg | boolean | false | 是否将无透明通道的 PNG 转为 JPG | | parallel | number | 3 | 最大并行压缩数量 |

压缩策略说明

• API_ONLY: 始终使用 TinyPNG API。需要提供 API key。
• RANDOM: 随机在 API 和 Web 端点之间选择。
• API_FIRST: 优先使用 TinyPNG API；当 API key 无效或触发限流时回退到 Web 端点。
• AUTO: 有 API key 时等同于 API_FIRST，否则等同于 RANDOM。

API Key 设置

插件本身不读取 .env 文件；由构建工具（Webpack）加载。建议使用 .env.local 存放本地密钥。

支持的变量名：任何以 TINYIMG_KEY、TINYIMG_KEYS、TINYPNG_KEY、TINYPNG_KEYS 结尾的变量。你也可以添加前缀，例如 APP_TINYIMG_KEY。

示例：

TINYIMG_KEY=your_api_key

示例

参见仓库中的 examples/webpack 获取可运行的示例。

许可证

MIT