Edge Security Acceleration:API EdgeKV

Constructeur

Crée une instance EdgeKV pour un namespace spécifié.

• Syntaxe

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

• Paramètres

  Paramètre	Description
  namespace	Le namespace que vous avez créé dans la console. Consultez vos namespaces dans la liste des namespaces.

get

Lit les données d'un namespace.

• Syntaxe

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

• Paramètres

  Paramètre	Description
  key	La clé à récupérer, spécifiée sous forme de chaîne.
  type	Le type de retour. Spécifiez l'une des valeurs suivantes : stream (par défaut) : renvoie la valeur sous forme de ReadableStream. text : renvoie la valeur sous forme de chaîne. json : analyse la valeur au format JSON et renvoie l'objet résultant. arrayBuffer : renvoie la valeur sous forme d'ArrayBuffer.

• Valeur de retour

  Renvoie une Promise. Utilisez await pour vous assurer que l'opération est terminée.

  • Si la clé est introuvable, la promesse est résolue avec undefined.

  • En cas d'exception et d'échec de l'opération, la promesse est rejetée avec un objet 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

Supprime une paire clé-valeur d'un namespace.

• Syntaxe

  delete(key)

• Paramètres

  Paramètre	Description
  key	La clé à supprimer, spécifiée sous forme de chaîne.

• Valeur de retour

  Renvoie une Promise. Utilisez await pour vous assurer que l'opération est terminée.

  • Si la suppression réussit, la promesse est résolue avec true.

  • Si la suppression échoue, la promesse est résolue avec false.

  • En cas d'exception, la promesse est rejetée avec un objet 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;
    }
  }

Gestion des exceptions JavaScript

Lorsqu'une exception se produit, une erreur JS est renvoyée. Pour ignorer cette erreur, interceptez-la dans votre code JS. Sinon, un code d'état 599 est renvoyé et la requête revient automatiquement vers le serveur d'origine de secours pour une nouvelle tentative. Le serveur d'origine de secours est le serveur d'origine que vous avez configuré lors de l'ajout du nom de domaine à CDN/DCDN.