Edge Security Acceleration:Fetch API

Definição do método

O Fetch é totalmente assíncrono e não bloqueia a execução do script, a menos que você use await. O sistema suporta até quatro sub-requisições simultâneas e gerencia conexões persistentes internamente.

O Fetch aceita requisições HTTP e HTTPS. Cada redirect conta como uma sub-requisição, com limite máximo de 12 operações de redirect por requisição.

• Definição do método

  fetch(arg, init). Este método segue a especificação MDN WorkerOrGlobalScope.fetch().

• Limites do método

  • A Fetch API aceita apenas nomes de domínio, não endereços IP. Portas padrão: 80 (HTTP) e 443 (HTTPS).

  • As propriedades credentials, referrer, referrerPolicy, cache e integrity do parâmetro init não têm efeito.

  • O valor padrão de redirect é follow, que segue respostas 3xx da origem. Defina redirect como manual para desativar o seguimento de redirecionamentos.

  Nota

  • Os modos de Fetch específicos do navegador não se aplicam. Em CDN, DCDN ou ESA, o CROS fetch pode recuperar dados de qualquer origem.

  • O comprimento total da URL de requisição não pode exceder 4 KB.

  • Recursos compactados com gzip são descompactados por padrão ao serem buscados. Adicione o parâmetro manual para desativar a descompactação. A seção Descompactar aborda os detalhes.

• Definir um período de timeout

  • Função de timeout

    /**
     * Request timeout control implementation
     *
     * @param {Number} timeout Timeout period, in ms
     * @param {Object} config Timeout configuration
     *   - @param {Object|Funtion} handler Value to return on timeout
     * @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);
      });
    };

  • Exemplo de chamada

    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)`,
      }
    });
    
    let resp = await Promise.race([
      kvRequest,
      timeoutPromise,
    ]);
    
    if (resp === undefined) {
      return "kv not found, key = " + key;
    } else {
      return resp;
    }

Redirecionamento

Descompactar

content-length

Headers

• Definição

  Para mais informações sobre o objeto Headers, consulte Headers.

• Limites

  Um cabeçalho registra a quantidade de recursos de memória consumidos. O tamanho máximo de um objeto Headers é 8 KB. Se o tamanho de um objeto Headers exceder esse limite, o sistema gera uma exceção JavaScript.

• Lista de bloqueios

  A Fetch API utiliza uma lista de bloqueios de cabeçalhos. Se você tentar ler ou gravar um cabeçalho presente nessa lista, o sistema gera uma exceção. A tabela a seguir descreve os cabeçalhos incluídos na lista de bloqueios.

  • expect

  • te

  • trailer

  • upgrade

  • proxy-connection

  • connection

  • keep-alive

  • dnt

  • host

  • Cabeçalhos reservados

Request

• Definição

  Segue a especificação MDN Request.

• Limites

  As seguintes propriedades de Request não são suportadas em CDN, DCDN ou ESA.

  • context

  • credentials

  • destination

  • integrity

  • mode

  • referrer

  • referrerPolicy

  • cache

• Usos comuns

  • Obter o método da requisição: request.method.

  • Obter a URL da requisição: request.url.

  • Obter os cabeçalhos da requisição: request.headers.

  • Obter o payload da requisição: request.body. O corpo é um objeto ReadableStream.

  • Obter JSON: await request.json().

  • Obter dados de formulário: await request.formData().

  • Obter uma string UTF-8: await request.text().

  Como extensão não padrão, request.ignore drena o stream do corpo no nível do socket sem carregá-lo na memória da VM JavaScript, evitando atrasos de GC. Chame await request.ignore() quando não precisar do corpo da requisição. O runtime devolve a conexão ao pool após a leitura completa do corpo.

Response

• Definição

  Segue a especificação MDN Response.

• Limites

  As propriedades useFinalURLS e error não são suportadas em CDN, DCDN ou ESA.

• Usos comuns

  • Obter o código de resposta: response.status.

  • Obter a frase de motivo da resposta: response.statusText.

  • Obter os cabeçalhos da resposta: response.headers.

  • Obter a URL da resposta: response.url. Esta é a URL final após todos os redirecionamentos.

  • Obter todas as URLs de redirecionamento (não padrão): response.urlList. Response implementa um mixin de corpo assim como Request, portanto, os mesmos métodos de recuperação de corpo se aplicam.

FormData

• Definição

  Para mais informações sobre a operação FormData, consulte FormData.

• Limites

  A operação FormData é semelhante à operação Headers. O FormData limita o tamanho dos cabeçalhos. Se o tamanho de um cabeçalho exceder o limite superior, o sistema gera uma exceção. Se você enviar FormData como corpo de requisição HTTP, content-type será definido como form-data/multipart por padrão.

URLSearchParams

• Definição

  Para mais informações sobre a operação URLSearchParams, consulte URLSearchParams().

• Limites

  Se você enviar URLSearchParams como corpo de requisição HTTP, content-type será definido como application/x-www-form-urlencode por padrão. O tamanho dos dados não pode exceder 1.000 bytes.

Blob e File

• Definição

  • Para mais informações sobre a operação Blob, consulte Blob.

  • Para mais informações sobre a operação File, consulte File.

• Limites

  O ER suporta as classes Blob e File, que atendem aos padrões das operações Blob e File. O ER não consegue ler nem gravar arquivos. Você pode passar as classes Blob e File suportadas pelo ER para o corpo da resposta. O valor do cabeçalho content-type é igual ao tipo MIME na operação Blob ou File.