Edge Security Acceleration:API do EdgeKV

Construtor

Cria uma instância EdgeKV para um namespace específico.

• Sintaxe

  const edgeKv = new EdgeKV({ namespace: "ns"});

• Parâmetros

  Parâmetro	Descrição
  namespace	O namespace criado no console. Visualize seus namespaces na lista de namespaces.

get

Lê dados de um namespace.

• Sintaxe

  get(key[, {type: “type”}])

• Parâmetros

  Parâmetro	Descrição
  key	Chave a recuperar, especificada como string.
  type	Tipo de retorno. Especifique um dos seguintes valores: stream (padrão): Retorna o valor como ReadableStream. text: Retorna o valor como string. json: Analisa o valor como JSON e retorna o objeto resultante. arrayBuffer: Retorna o valor como ArrayBuffer.

• Valor de retorno

  Retorna uma Promise. Use await para garantir a conclusão da operação.

  • Se a chave não for encontrada, a promise será resolvida com undefined.

  • Em caso de exceção e falha na operação, a promise será rejeitada com um objeto Error.

• Sample Code

  addEventListener("fetch", event => {
    event.respondWith(handleRequest(event.request))
  })
  
  async function handleRequest(request) {
    try {
      const edgeKV = new EdgeKV({ namespace: "ns" });
      let getType = { type: "text" };
      let value = await edgeKV.get("key", getType);
      if (value === undefined) {
        return "EdgeKV get: key not found";
      } else {
        return new Response(value);
      }
    } catch (e) {
      return "EdgeKV get error" + e;
    }
  }

delete

Exclua um par chave-valor de um namespace.

• Sintaxe

  delete(key)

• Parâmetros

  Parâmetro	Descrição
  key	Chave a excluir, especificada como string.

• Valor de retorno

  Retorna uma Promise. Use await para garantir a conclusão da operação.

  • Se a exclusão for bem-sucedida, a promise será resolvida com true.

  • Se a exclusão falhar, a promise será resolvida com false.

  • Em caso de exceção, a promise será rejeitada com um objeto Error.

• Sample Code

  addEventListener("fetch", event => {
    event.respondWith(handleRequest(event.request))
  })
  
  async function handleRequest() {
    try {
      const edgeKV = new EdgeKV({ namespace: "ns" });
      let resp = await edgeKV.delete("key");
      if (resp) {
        return "EdgeKV delete success";
      } else {
        return "EdgeKV delete failed";
      }
    }
    catch (e) {
      return "EdgeKV delete error" + e;
    }
  }

Tratamento de exceções JavaScript

Quando ocorre uma exceção, o sistema retorna um erro JS. Para ignorar esse erro, capture-o no código JS. Caso contrário, o sistema retornará um código de status 599 e a solicitação voltará automaticamente ao servidor de origem de fallback para nova tentativa. O servidor de origem de fallback é the origin server that you configured when you added the domain name to CDN/DCDN.