边缘开发者平台
  • 边缘函数
    • 概述
    • 快速指引
    • 操作指引
      • 函数管理
      • 触发配置
    • Runtime APIs
      • addEventListener
      • Cache
      • Cookies
      • Encoding
      • Fetch
      • FetchEvent
      • Headers
      • Request
      • Response
      • Streams
        • ReadableStream
        • ReadableStreamBYOBReader
        • ReadableStreamDefaultReader
        • TransformStream
        • WritableStream
        • WritableStreamDefaultWriter
      • Web Crypto
      • Web standards
      • Images
        • ImageProperties
    • 示例函数
      • 返回 HTML 页面
      • 返回 JSON
      • Fetch 远程资源
      • 请求头鉴权
      • 修改响应头
      • AB 测试
      • 设置 Cookie
      • 基于请求区域重定向
      • Cache API 使用
      • 缓存 POST 请求
      • 流式响应
      • 合并资源流式响应
      • 防篡改校验
      • m3u8 改写与鉴权
      • 图片自适应缩放
      • 图片自适应 WebP
      • 自定义 Referer 限制规则
      • 远程鉴权
      • HMAC 数字签名
      • 自定义下载文件名
      • 获取客户端 IP
    • 最佳实践
      • 通过边缘函数实现自适应图片格式转换
Docs Overview/
边缘开发者平台/
边缘函数/
示例函数/
图片自适应 WebP/

图片自适应 WebP

该示例通过对请求头 Accept 判断，如果包含image/webp，边缘函数会将图片格式自动转换为 WebP 格式，并缓存在 EdgeOne 边缘节点。若您的 Web 应用展示了大量的 PNG，JPEG 格式图片，期望在边缘自动优化图片，减少流量带宽成本，可使用边缘函数实现平滑升级， 把 PNG，JPEG 格式图片自动转换为 WebP 格式，并且业务代码 0 改动。更多图片转换格式，详情请参考 ImageProperties。
注意：
该示例仅在源文件的响应头 Content-Type 指定的 MIME 类型为图像（image/*）时，才能正常执行转换功能。
该示例暂不支持转换 SVG 格式图片。
建议边缘函数触发规则配置添加上文件后缀 .png、.jpeg、.jpg 等图片后缀。
async function handleEvent(event) {
  const { request } = event;
  
  // 获取客户端支持的图片类型
  const accept = request.headers.get('Accept');
  const option = { eo: { image: {} } };
  
  // 检查客户端是否支持 WebP 格式的图片,若不支持响应原图
  if (accept && accept.includes('image/webp')) {
    option.eo.image.format = 'webp';
  }
  
  const response = await fetch(request, option);
  return response;
}

addEventListener('fetch', event => {
  // 当函数代码抛出未处理的异常时，边缘函数会将此请求转发回源站 
  event.passThroughOnException();
  event.respondWith(handleEvent(event));
});

示例预览

在 PC 端与移动端的浏览器地址栏中输入匹配到边缘函数触发规则的 URL（如：https://example.com/images-format/ef-1.jpeg），即可自动转换为 Webp 格式图片。


相关参考

Runtime APIs: Fetch
Runtime APIs: Headers
Runtime APIs: Request
Runtime APIs: FetchEvent