Gunakan Edge KV API untuk mengelola data - Edge Security Acceleration - Alibaba Cloud - Edge Security Acceleration

Gunakan Edge KV API bawaan untuk mengelola namespace Anda.

Constructor

Membuat instance Edge KV yang dikaitkan dengan namespace tertentu.

Definisi

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

Parameter

Parameter

Description

namespace

Nama namespace yang telah Anda buat di Konsol.

get

Membaca nilai untuk kunci tertentu dari sebuah namespace.

Definisi
```
get(key[, {type: "type"}])
```

Parameter

Description

key

Kunci yang akan diambil. Harus berupa string.

type

Format nilai yang dikembalikan. Nilainya dapat berupa salah satu berikut:

stream (default): Mengembalikan nilai sebagai ReadableStream.
text: Mengembalikan nilai sebagai string.
json: Mengurai nilai sebagai JSON dan mengembalikan objek JavaScript.
arrayBuffer: Mengembalikan nilai sebagai ArrayBuffer.

Nilai kembalian
Mengembalikan Promise yang diselesaikan menjadi nilai kunci tersebut:
- Jika kunci tidak ditemukan, Promise diselesaikan menjadi undefined.
- Jika terjadi error, Promise ditolak.

Contoh

export default {
  fetch(request) {
    return handleRequest(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;
  }
}

put

Menulis atau memperbarui pasangan kunci-nilai dalam sebuah namespace.

Definisi
```
put(key,value)
```

Parameter

Description

key

Kunci yang akan ditulis. Harus berupa string tidak kosong.

value

Nilai yang akan disimpan. Ukuran maksimum adalah 1,8 MB. Nilainya dapat berupa salah satu tipe berikut:

string
ReadableStream
ArrayBuffer
Response

Nilai kembalian
Mengembalikan Promise yang diselesaikan saat operasi selesai:
- Jika berhasil, Promise diselesaikan menjadi undefined.
- Jika terjadi error, Promise ditolak.

Contoh

export default {
  async fetch(request) {
    return handleRequest(request);
  }
}
async function handleRequest(request) {
  try {
    const edgeKV = new EdgeKV({ namespace: "ns" });
    let data = await edgeKV.put("put_string", "string_value")
    // await edgeKV.put("put_stream", new HTMLStream("test_stream", []));
    // await edgeKV.put("put_array_buffer", getArrayBuffer());
    // await edgeKV.put("put_array_buffer", new Response("test"));
    if (data === undefined) {
      return "EdgeKV put success\n";
    } else {
      return "EdgeKV put failed\n";
    }
  } catch (e) {
    return "EdgeKV put error" + e;
  }
}

delete

Menghapus pasangan kunci-nilai dari sebuah namespace.

Definisi
```
delete(key)
```
Parameter

Parameter

Description

key

Kunci yang akan dihapus. Harus berupa string.
Nilai kembalian
Mengembalikan Promise yang diselesaikan saat operasi selesai:
- Diselesaikan menjadi true jika penghapusan berhasil.
- Diselesaikan menjadi false jika penghapusan gagal.
- Jika terjadi error, Promise ditolak.

Contoh

export default {
  async fetch(request) {
    return handleRequest(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;
  }
}

Parameter	Description
namespace	Nama namespace yang telah Anda buat di Konsol.

Parameter	Description
key	Kunci yang akan dihapus. Harus berupa string.