Edge KV API - Edge Security Acceleration

Kelola penyimpanan edge Anda menggunakan operasi Edge KV API bawaan.

Konstruktor

Membuat instance yang terkait dengan namespace tertentu di Edge KV.

Definisi

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

Parameter
Parameter
Deskripsi
namespace
NameSpace adalah nama ruang penyimpanan yang Anda buat di konsol.

get

Membaca data dari sebuah namespace.

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

Parameter

Deskripsi

key

Tipe adalah string.

type

Anda dapat memilih salah satu dari berikut ini:

stream (default): Mengembalikan konten dalam bentuk ReadableStream.
text: Mengembalikan string.
json: Mengonversi konten JSON yang disimpan menjadi Objek lalu mengembalikannya.
arrayBuffer: Mengembalikan data biner.

Nilai Kembali
Sebuah objek Promise dikembalikan. Anda dapat memanggil await untuk memastikan eksekusi metode get selesai.
- Jika key tidak ada, objek Promise diselesaikan menjadi undefined.
- Jika metode get gagal dieksekusi karena pengecualian, objek Promise ditolak dengan kesalahan.

Contoh kode

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 tidak ditemukan";
    } else {
      return new Response(value);
    }
  } catch (e) {
    return "EdgeKV get error" + e;
  }
}

put

Menulis atau memperbarui pasangan nilai-kunci ke sebuah namespace.

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

Parameter

Deskripsi

key

Tipe adalah string. Key tidak boleh kosong.

type

Data yang ingin Anda simpan. Nilainya bisa mencapai ukuran maksimum 1,8 MB. Anda dapat memilih salah satu dari berikut ini:

string
ReadableStream
ArrayBuffer
Response

Nilai Kembali
Sebuah objek Promise dikembalikan. Anda dapat memanggil await untuk memastikan eksekusi metode put selesai.
- Jika metode put berhasil, objek Promise diselesaikan menjadi undefined.
- Jika metode put gagal dieksekusi karena pengecualian, objek Promise ditolak dengan kesalahan.

Contoh kode

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 sebuah key dan nilainya dari sebuah namespace.

Definisi
```
delete(key)
```
Parameter
Parameter
Deskripsi
key
Key yang ingin Anda hapus. Tipe adalah string.
Nilai Kembali
Sebuah objek Promise dikembalikan. Anda dapat memanggil await untuk memastikan eksekusi metode delete selesai.
- Jika metode delete berhasil, objek Promise diselesaikan menjadi true.
- Jika metode delete gagal dieksekusi, objek Promise diselesaikan menjadi false.
- Jika terjadi pengecualian saat mengeksekusi metode delete, objek Promise ditolak dengan kesalahan.

Contoh kode

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	Deskripsi
namespace	NameSpace adalah nama ruang penyimpanan yang Anda buat di konsol.

Parameter	Deskripsi
key	Key yang ingin Anda hapus. Tipe adalah string.