All Products
Search
Document Center

Edge Security Acceleration:Cache API

Last Updated:Oct 21, 2026

Cache API memungkinkan Anda menyimpan data dalam cache pada edge node untuk mempercepat respons terhadap permintaan berikutnya. Anda dapat mengonfigurasi durasi dan ukuran cache guna mengatur kebijakan caching.

Cara kerja

Cache API bawaan Edge Routines (ER) menyimpan data yang diproses oleh ER atau diambil dari origin server ke ESA agar dapat digunakan kembali oleh permintaan lain pada node yang sama. Hal ini mengurangi komputasi berulang dan permintaan jaringan. Gambar berikut menunjukkan hubungan antara ER dan cache ESA:How it works

Standar API

Cache API sebisa mungkin mematuhi antarmuka Cache standar. Namun, karena Edge Routines menggunakan kembali mesin cache yang ada di ESA, semantiknya tidak sepenuhnya konsisten.

Definisi API

cache.put(request/string, response)

  • Menyimpan objek Response ke dalam Cache.

    • Jika operasi put berhasil, fungsi akan mengembalikan undefined.

    • Jika mesin Cache gagal, operasi akan ditolak dengan pengecualian error.

    • Jika kuota mesin Cache terlampaui, operasi akan ditolak dengan pengecualian error.

  • Kunci cache diatur berdasarkan URL dari objek request atau string URL. Gunakan URL HTTP karena mesin Cache ESA saat ini tidak mendukung URL HTTPS.

  • Ini adalah fungsi asinkron. Gunakan await untuk memastikan operasi put selesai.

  • Anda dapat mengatur header cache-control pada objek Response untuk mengonfigurasi TTL cache (header cache-control mengikuti standar cache).

Examples

  • Menyimpan konten ke dalam Cache.

    async function doPut() {
      await cache.put("http://www.example.com", new Response("Hello World"));
      new Response("Hello World", {headers: [["cache-control", "max-age=10"]]})); 
    }
  • Menyimpan konten ke dalam Cache dan mengatur TTL.

    async function doPut() {
      await cache.put("http://www.example.com", new Response("Hello World"));
      await cache.put("http://www.example.com", 
      new Response("Hello World", {headers: [["cache-control", "max-age=10"]]})); 
    }

cache.get(request/string)

  • Mengambil objek Response menggunakan request/string yang ditentukan sebagai kunci. Jika objek tidak ada, fungsi akan mengembalikan undefined.

  • Ini adalah fungsi asinkron. Gunakan await untuk memastikan operasi get selesai.

  • Fungsi get mungkin tidak mengembalikan objek yang baru saja disimpan melalui put karena cache menggunakan algoritma LRU dan tidak menjamin bahwa objek yang di-cache selalu dapat diambil.

Examples

  • Menggunakan cache.get untuk mengambil objek Response.

    async function doGet() {
        let resp = await cache.get("http://www.example.com");
    }
  • Mengurai hasil cache menjadi JSON.

    async function doGet() {
        let resp = await cache.get("http://www.example.com");
        let j = await resp.json();
    }

cache.delete(request/string)

  • Menghapus objek Response dengan kunci yang ditentukan.

    • Jika penghapusan berhasil, fungsi akan mengembalikan true.

    • Jika penghapusan gagal, fungsi akan mengembalikan false.

  • Ini adalah fungsi asinkron. Gunakan await untuk memastikan operasi delete selesai.

Example (delete a resource under a key)

async function doDelete() {
  let resp = await cache.delete("http://www.example.com");
  
  if (resp) {
        console.alert("done");
  } else {
        console.alert("failed");
  }
}

Batas penggunaan

  • Semua operasi Cache API merupakan subrequest yang berbagi batas subrequest ER. Secara default, satu permintaan ER mendukung maksimal 32 subrequest fetch (angka ini dapat berubah saat ER dikomersialkan). Operasi Cache API berbagi batas ini dengan fetch, sehingga jumlah total operasi cache.put, cache.get, cache.delete, dan fetch dalam satu konteks permintaan tidak boleh melebihi 32.

  • Operasi cache.put, cache.get, dan cache.delete memiliki kontrol konkurensi. Untuk URL yang sama, jika satu permintaan sedang melakukan get sementara permintaan lain melakukan delete, operasi tersebut mungkin mengembalikan status pending karena beberapa permintaan konkuren sedang memodifikasi kunci yang sama. Tunggu dan coba lagi jika hal ini terjadi.

    Catatan

    Jika cache.put, cache.get, atau cache.delete menolak ke true, hal ini menandakan bahwa operasi tersebut tunduk pada kontrol konkurensi.

Refresh cache

Cache API saat ini tidak mendukung refresh cache aktif. Tentukan durasi cache yang sesuai dengan menggunakan parameter TTL saat memanggil Cache.put().