Tencent Cloud

FetchEvent

最后更新时间：2024-01-30 16:47:27

FetchEvent 代表任何传入的 HTTP 请求事件，边缘函数通过注册 fetch 事件监听器实现对 HTTP 请求的处理。
描述
在边缘函数中，使用 addEventListener 注册 fetch 事件监听器，生成 HTTP 请求事件 FetchEvent ，进而实现对 HTTP 请求的处理。
注意：
不支持直接构造 FetchEvent 对象，使用 addEventListener 注册 fetch 事件获取 event 对象。
// event 为 FetchEvent 对象
addEventListener('fetch', (event) => {
  event.respondWith(new Response('hello world!'))；
});
属性
clientId
// event.clientId
readonly clientId: string;
边缘函数为每一个请求分配的 id 标识。
request
// event.request
readonly request: Request;
客户端发起的 HTTP 请求对象，详情参见 Request。
方法
respondWith
event.respondWith(response: Response | Promise<Response>): void;
边缘函数接管客户端的请求，并使用该方法，返回自定义响应内容。 
注意：
 事件监听器 addEventListener 的 fetch 事件回调中，需要调用接口 event.respondWith() 响应客户端，若未调用该接口，边缘函数会将当前请求转发回源站。
参数
参数名称
类型
必填
说明
response
Response |         Promise<Response>      
是
        客户端 HTTP 请求的响应。      
waitUntil
event.waitUntil(task: Promise<any>): void;
用于通知边缘函数等待 Promise 完成，可延长事件处理的生命周期。
参数
参数名称
类型
必填
说明
task
Promise<Response>      
是
        等待完成的 Promise 任务。       
passThroughOnException
event.passThroughOnException(): void;
用于防止运行时响应异常信息。当函数代码抛出未处理的异常时，边缘函数会将此请求转发回源站，进而增强服务的可用性.
示例代码
未调用接口 event.respondWith，边缘函数将当前请求转发回源站。
function handleRequest(request) {
  return new Response('Edge Functions, Hello World!');
}
﻿
addEventListener('fetch', event => {
  const request = event.request;
  // 请求 url 包含字符串 /ignore/ ，边缘函数会将当前请求转发回源站。
  if (request.url.indexOf('/ignore/') !== -1) {
    // 未调用接口 event.respondWith
    return;
  }
﻿
  // 在边缘函数中，自定义内容响应客户端
  event.respondWith(handleRequest(request));
});
当函数代码抛出未处理的异常时，边缘函数会将此请求转发回源站。
addEventListener('fetch', event => {
  // 当函数代码抛出未处理的异常时，边缘函数会将此请求转发回源站 
  event.passThroughOnException();
  throw new Error('Throw error');
});
相关参考
MDN 官方文档：FetchEvent
示例函数：返回 HTML 页面
示例函数：Cache API 使用

tencent cloud

Recent Pages

FetchEvent

描述

属性

clientId

request

方法

respondWith

参数

waitUntil

参数

passThroughOnException

示例代码

相关参考

本页内容是否解决了您的问题？

本页内容是否解决了您的问题？

参数名称	类型	必填	说明
response	Response \| Promise<Response>	是	客户端 HTTP 请求的响应。

tencent cloud

注册

登录

Recent Pages

FetchEvent

描述

属性

clientId

request

方法

respondWith

参数

waitUntil

参数

passThroughOnException

示例代码

相关参考

本页内容是否解决了您的问题？

本页内容是否解决了您的问题？