格式转换

通过格式转换参数,实时将图片从一种格式转换为另一种格式,无需下载到本地处理。适用于跨平台兼容、存储优化等场景。

功能说明

参数	类型	必填	默认值	取值范围	说明
`[type]`	String	是	—	`jpg` / `png` / `webp` / `bmp` / `gif` / `tiff` / `heic` / `avif`	目标格式

[!NOTE]

WebP 格式要求原图宽高均 ≤ 16,383 px

HEIC / AVIF 仅部分地域支持

原图为 GIF 设置 format,gif 时保持 GIF,否则保持原格式

# 转换为 WebP
?x-oss-process=image/format,webp

# 缩放并转换为 AVIF
?x-oss-process=image/resize,w_300/format,avif

import { processImage } from '@imgx-kit/core';

const buf = await processImage(
  './photo.jpg',
  'image/format,webp',
);

import { imgx } from '@imgx-kit/core';

const buf = await imgx('./photo.jpg')
  .format({ type: 'webp' })
  .toBuffer();