Edge Security Acceleration:API de EdgeKV

Constructor

Crea una instancia de EdgeKV para un namespace específico.

• Sintaxis

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

• Parámetros

  Parámetro	Descripción
  namespace	El namespace que creó en la consola. Consulte sus namespaces en la lista de namespaces.

get

Lee datos de un namespace.

• Sintaxis

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

• Parámetros

  Parámetro	Descripción
  key	La clave que se recuperará, especificada como una cadena.
  type	El tipo de retorno. Especifique uno de los siguientes valores: stream (predeterminado): Devuelve el valor como un objeto ReadableStream. text: Devuelve el valor como una cadena. json: Analiza sintácticamente el valor como JSON y devuelve el objeto resultante. arrayBuffer: Devuelve el valor como un objeto ArrayBuffer.

• Valor de retorno

  Devuelve un objeto Promise. Use await para asegurarse de que la operación haya terminado.

  • Si no se encuentra la clave, la promesa se resuelve con undefined.

  • Si ocurre una excepción y la operación termina con errores, la promesa se rechaza con un 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

Elimina un par clave-valor de un namespace.

• Sintaxis

  delete(key)

• Parámetros

  Parámetro	Descripción
  key	La clave que se eliminará, especificada como una cadena.

• Valor de retorno

  Devuelve un objeto Promise. Use await para asegurarse de que la operación haya terminado.

  • Si la eliminación es exitosa, la promesa se resuelve con true.

  • Si la eliminación termina con errores, la promesa se resuelve con false.

  • Si ocurre una excepción, la promesa se rechaza con un 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;
    }
  }

Manejo de excepciones de JavaScript

Cuando ocurre una excepción, se devuelve un error de JS. Si desea ignorar este error, debe capturarlo en su código JS. De lo contrario, se devuelve un código de estado 599 y la solicitud vuelve automáticamente al servidor de origen de respaldo para reintentar la operación. El servidor de origen de respaldo es the origin server that you configured when you added the domain name to CDN/DCDN.