FetchEvent: handled プロパティ

Baseline 広く利用可能

この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2022年9月以降、すべてのブラウザーで利用可能です。

メモ: この機能はサービスワーカー内でのみ利用可能です。

handled は FetchEvent インターフェイスのプロパティで、このイベントがフェッチアルゴリズムによって処理されたかどうかを示すプロミスを返します。このプロパティは、ブラウザーがレスポンスを消費した後にコードを実行することができ、通常は waitUntil() メソッドと共に使用します。

値

イベントが処理されるまでは待機し、イベントが処理されると履行される Promise です。

例

addEventListener("fetch", (event) => {
  event.respondWith(
    (async function () {
      const response = await doCalculateAResponse(event.request);

      event.waitUntil(
        (async function () {
          await doSomeAsyncStuff(); // オプション

          // イベントがブラウザーによって消費されるのを待つ
          await event.handled;

          return doFinalStuff(); // イベントが消費された後に後始末
        })(),
      );

      return response;
    })(),
  );
});