Edge Security Acceleration:Fetch API

Fetch API メソッド

Fetch は非同期呼び出しをサポートしています。 await キーワードを使用しない限り、Fetch はスクリプトの実行をブロックしません。 Fetch では、一度に最大 4 つのサブリクエストを送信できます。 基礎となるレイヤーは持続的接続を使用しているため、接続プールを管理しなくても安定したパフォーマンスが保証されます。

Fetch API を呼び出して、HTTP または HTTPS リクエストを送信できます。 各 redirect は 1 つのリクエストと見なされます。 各 Fetch API リクエストは、最大 12 の redirect 操作をサポートしています。

• メソッド定義

  fetch(arg, init) は、Fetch メソッドとして使用されます。 詳細については、「WorkerOrGlobalScope.fetch()」をご参照ください。

• メソッドの制限

  • Fetch API はドメイン名をサポートしていますが、IP アドレスはサポートしていません。 HTTP リクエストはポート 80 を使用し、HTTPS リクエストはポート 443 を使用します。

  • init パラメーターの内部 credentials、referrer、referrerPolicy、cache、および integrity パラメーターは使用されていません。

  • デフォルトでは、redirect パラメーターは follow に設定されています。これは、fetch リクエストが 3xx リダイレクトに従うことを指定します。 fetch リクエストが 3xx リダイレクトに従わないようにするには、redirect パラメーターを manual に設定します。

  説明

  • ブラウザは、さまざまなモードで fetch リクエストを同じ方法で処理します。 たとえば、CROS fetch を使用して、Alibaba Cloud CDN、DCDN、または ESA を使用して、任意のオリジン サーバーからリソースを取得できます。

  • 一度に 4 つを超えるサブリクエストを送信するには、チケットを送信して、クォータの増加をリクエストしてください。

  • リクエスト URL の全長は 4 KB を超えることはできません。

  • Fetch を使用して Gzip で圧縮されたリソースを取得する場合、これらのリソースは返される前に自動的に解凍されます。 リソースがデフォルトで解凍されないようにするには、「解凍」セクションの説明に従って、decompress パラメーターを manual に設定します。

• タイムアウト期間の構成

  • Timeout

    /**
     * リクエストのタイムアウトをデプロイ
     *
     * @param {Number} timeout. タイムアウト期間。単位：ミリ秒。
     * @param {Object} config. タイムアウト構成。
     *   - @param {Object|Funtion} handler. 操作がタイムアウトした場合の戻り値。
     * @returns
     */
    const RequestTimeout = (timeout, config) => {
      return new Promise((resolve) => {
        const { handler = null } = config;
        let timer = setTimeout(() => {
          clearTimeout(timer);
          timer = null;
    
          const defaultRes = (typeof handler === 'function' ? handler() : handler) || {};
          resolve(defaultRes);
        }, timeout);
      });
    };

  • リクエスト例

    const KV_TIMEOUT = 1000;
    let edgekv = new EdgeKV({
      namespace: KV_NS,
    });
    
    let kvRequest = edgekv.get(key, getType);
    let timeoutPromise = RequestTimeout(KV_TIMEOUT, {
      handler: {
        res: {},
        errorMessage: `kv request timeout (${KV_TIMEOUT}ms)`, // kv リクエストのタイムアウト
      }
    });
    
    let resp = await Promise.race([
      kvRequest,
      timeoutPromise,
    ]);
    
    if (resp === undefined) {
      return "kv not found, key = " + key; // kv が見つかりません
    } else {
      return resp;
    }

リダイレクト

解凍

content-length

ヘッダー

• 定義

  Headers オブジェクトの詳細については、「Headers」をご参照ください。

• 制限

  ヘッダーは、消費されるメモリリソースの量を記録します。 Headers オブジェクトの最大サイズは 8 KB です。 Headers オブジェクトのサイズがこの制限を超えると、JavaScript 例外がスローされます。

• ブラックリスト

  Fetch API はヘッダーブラックリストを使用します。 ブラックリストに含まれるヘッダーの読み取りまたは書き込みを試みると、例外がスローされます。 次の表に、ブラックリストに含まれるヘッダーについて説明します。

  • expect

  • te

  • trailer

  • upgrade

  • proxy-connection

  • connection

  • keep-alive

  • dnt

  • host

  • 予約済みヘッダー

リクエスト

• 説明

  Request 操作の詳細については、「Request」をご参照ください。

• 制限

  Request オブジェクトの次のプロパティは、CDN/DCDN/ESA コンテキストでは使用されていません。

  • context

  • credentials

  • destination

  • integrity

  • mode

  • referrer

  • referrerPolicy

  • cache

• ユースケース

  • リクエストメソッドをフェッチします: request.method。

  • リクエスト URL をフェッチします: request.url。

  • リクエストヘッダーをフェッチします: request.headers。

  • リクエストペイロードをフェッチします: request.body。本文は ReadableStream オブジェクトです。

  • JSON データをフェッチします: await request.json()。

  • フォームデータをフェッチします: await request.formData()。

  • UTF-8 でエンコードされた文字列をフェッチします: await request.text()。

  Request 操作は標準 API 操作です。 Request 操作は、ER のメモリリソースを消費する必要なく本文のすべての値をフェッチするときに、本文を無視します。 これにより、ガベージコレクション (GC) の一時停止時間が最小限に抑えられ、リクエスト本文のすべての値が基礎となるソケットからフェッチされることが保証されます。 await request.ignore() の場合、フェッチされた本文を読み取る必要がないか、興味がない場合は、パフォーマンスを向上させるためにすべての fetch リクエストに対して request.ignore を呼び出すことをお勧めします。 これは、ランタイムが完全に読み取られた本文を含むリクエストを将来使用するために接続プールに自動的に送信するためです。

レスポンス

• 説明

  Response 操作の詳細については、「Response」をご参照ください。

• 制限

  Response オブジェクトの useFinalURLS プロパティと error プロパティは実装されておらず、CDN/DCDN/ESA コンテキストでは意味がありません。

• ユースケース

  • レスポンスコードをフェッチします: response.status。

  • レスポンスの理由句をフェッチします: response.statusText。

  • レスポンスヘッダーをフェッチします: response.headers。

  • レスポンス URL をフェッチします: response.url。これは、レスポンスが送信された URL を示します。

  • すべてのリダイレクト URL のリストをフェッチします (非標準): response.urlList。 Request オブジェクトが body mixin を実装する方法と同様に、同様のメソッドを使用して body オブジェクトを取得できます。

FormData

• 定義

  FormData 操作の詳細については、「FormData」をご参照ください。

• 制限

  FormData 操作は Headers 操作に似ています。 FormData はヘッダーのサイズを制限します。 ヘッダーのサイズが上限を超えると、例外がスローされます。 FormData を HTTP リクエスト本文として送信する場合、content-type はデフォルトで form-data/multipart に設定されます。

URLSearchParams

• 定義

  URLSearchParams 操作の詳細については、「URLSearchParams()」をご参照ください。

• 制限

  URLSearchParams を HTTP リクエスト本文として送信する場合、content-type はデフォルトで application/x-www-form-urlencode に設定されます。 データサイズは 1,000 バイトを超えることはできません。

Blob と File

• 定義

  • Blob 操作の詳細については、「Blob」をご参照ください。

  • File 操作の詳細については、「File」をご参照ください。

• 制限

  ER は、Blob 操作と File 操作の標準を満たす Blob クラスと File クラスをサポートしています。 ER はファイルの読み取りまたは書き込みを行うことができません。 ER でサポートされている Blob クラスと File クラスをレスポンス本文に渡すことができます。 content-type ヘッダーの値は、Blob 操作または File 操作の MIME タイプと同じです。