Edge Security Acceleration:フェッチAPI

Fetch APIは3xxリダイレクトをサポートしています。 フェッチ要求は3xxリダイレクトに従うことができます。 HTTP 3xxステータスコードには、301、302、303、307、および308が含まれます。 リダイレクトパラメーターは、ビジネス要件に基づいて次のいずれかの値に設定できます。

• {redirect: "manual"}: フェッチリクエストが3xxリダイレクトに従わない。 3xxリダイレクトは手動で処理する必要があります。 デフォルト値です。

• {redirect: "error"}: 3xxリダイレクトが発生すると例外がスローされます。

• {redirect: "follow"}: フェッチリクエストは3xxリダイレクトに従います。 Fetch APIでサポートされている3xxリダイレクトの最大数は20です。

次の表に、3xxステータスコードを示します。

Fetch APIを使用すると、fetch("https://www.example.com",{decompress: "manual"}) などの解凍モードを設定できます。 解凍パラメータは、次の値をサポートします。

• manual: データを解凍しません。 サーバがフェッチ要求時に圧縮データを返す場合、EdgeRoutine (ER) によって受信されたデータも圧縮される。

• decompress: データを自動的に解凍します。 デフォルト値です。 Fetch APIはGzip圧縮をサポートしています。 ERは、Content-Encodingヘッダーに基づいてデータを自動的に検出または解凍します。 ERがデータを解凍した後、ERはContent-Encodingの値を変更します。 Gzipパラメーターが削除されている場合、データ送信中の例外を防ぐために次の設定を構成できます。

  • content-encoding: gzip: ERはContent-Encodingの値を認識し、データを解凍します。

  • content-encoding: gzip, identity: ERはContent-Encodingの値を認識し、データを解凍します。

  説明

  Gzip以外のアルゴリズムは例外を引き起こす。

• fallbackIdentity: この値の効果は、値の解凍の効果に似ています。 ERがこの値を認識できない場合、ERはデータを解凍しません。

Fetch APIを使用してERでサブリクエストを行うと、次の図のステップ6に示すように、ERはHTTPリクエストをインターネットに直接送信します。 次の図に示すように、Alibaba Cloud CDNまたはDCDNをプロキシとして使用してサブリクエストを処理することもできます。 この場合、サブリクエストはステップ5と3を介して処理されます。 Alibaba Cloud CDNをプロキシとして使用するには、fetch("http://www.example.com", {cdnProxy: true}) のようにcdnProxyパラメーターを設定します。 cdnProxyパラメーターを使用して、Alibaba Cloud CDNおよびDCDNドメイン名からのみリソースを取得できます。 cdnProxyパラメーターを使用すると、Fetchリクエストは、DNS解決後に他のPOPにリダイレクトされることなく、同じPOPにキャッシュされたファイルに直接アクセスできます。 これは時間消費を減らす。

フェッチリクエストでContent-Lengthヘッダーを設定すると、データはContent-Lengthヘッダーで指定された形式でエンコードされ、データを送信するためにfetch APIによって使用される方法が変更されます。 Content-Lengthヘッダーを設定しない場合、Fetch APIはボディストリーム内のすべてのデータを自動的に取得し、データを送信します。 送信されたデータは、チャンク転送符号化方式を用いて符号化される。

• コンテンツ長の設定

  • Content-Lengthヘッダが負でない値に設定されている場合、Fetch APIは、Content-Lengthヘッダに基づいてボディストリームからデータをフェッチし、フェッチされたデータを送信します。 Content-Lengthが0に設定されている場合、データは送信されません。

  • Content-Lengthヘッダーが無効な値に設定されている場合、Fetch APIはボディ内のすべての値を送信します。 送信されたデータは、チャンク転送符号化方式を用いて符号化される。

• 例

  Fetch APIは自動的にデータを解凍します。 データが解凍された後、Content-Lengthヘッダーはレスポンスに保持されます。 Content-Lengthヘッダは、データが解凍される前のデータのサイズを示す。 本文を変更した後にFetch APIを呼び出す場合は、Content-Lengthヘッダーを変更する必要があるかどうかを確認します。 Content-Lengthヘッダーを変更する必要があるが、変更しない場合、送信されるコンテンツが正しくない可能性があります。

  次の例では、Content-Lengthヘッダーを含むPOSTリクエストがクライアントから送信されます。 Fetch APIを呼び出してデータをフェッチすると、リクエストボディはクライアント要求のHeadersオブジェクトを使用します。 Content-Lengthヘッダーの値は、ボディの実際のサイズとは異なる場合があります。 Headersオブジェクトが送信された場合は、本文のサイズが変更されているかどうかを確認します。

  addEventListener('fetch', (event) => {
    event.respondWith(h(event));
  });
  
  async function h(event) {
    return fetch("http://www.example.com", {
      headers: event.request.headers,
      method: event.request.method,
      body: "SomeData"
    });
  }