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