All Products
Search
Document Center

Edge Security Acceleration:Fetch API

Last Updated:Sep 12, 2026

Ambil data dari edge POP melalui HTTP atau HTTPS. Fetch API berfungsi seperti Fetch API browser dan mendukung pemuatan konten dinamis, interaksi backend, serta Pengujian A/B.

Definisi metode

Fetch sepenuhnya asinkron dan tidak memblokir eksekusi skrip kecuali jika Anda menggunakan await. Hingga empat subrequest konkuren didukung. Koneksi persisten dikelola secara internal.

Fetch mendukung permintaan HTTP dan HTTPS. Setiap redirect dihitung sebagai satu subrequest, dengan maksimal 12 operasi redirect per permintaan.

  • Definisi metode

    fetch(arg, init). Metode ini mengikuti spesifikasi MDN WorkerOrGlobalScope.fetch().

  • Batas metode

    • Fetch API hanya mendukung nama domain, bukan alamat IP. Port default: 80 (HTTP), 443 (HTTPS).

    • Properti credentials, referrer, referrerPolicy, cache, dan integrity dari parameter init tidak berpengaruh.

    • redirect secara default bernilai follow, yang mengikuti respons 3xx dari origin. Atur redirect ke manual untuk menonaktifkan pengikutan redirect.

    Catatan
    • Mode Fetch khusus browser tidak berlaku. Di CDN, DCDN, atau ESA, CROS fetch dapat mengambil data dari origin mana pun.

    • Panjang total URL permintaan tidak boleh melebihi 4 KB.

    • Sumber daya yang difetch dalam format terkompresi gzip akan didekompresi secara default. Tambahkan parameter manual untuk menonaktifkan dekompresi. Bagian Dekompresi mencakup detailnya.

  • Tetapkan periode timeout

    • Fungsi timeout

      /**
       * Implementasi kontrol timeout permintaan
       *
       * @param {Number} timeout Periode timeout, dalam ms
       * @param {Object} config Konfigurasi timeout
       *   - @param {Object|Funtion} handler Nilai yang dikembalikan saat timeout
       * @returns
       */
      const RequestTimeout = (timeout, config) => {
        return new Promise((resolve) => {
          const { handler = null } = config;
          let timer = setTimeout(() => {
            clearTimeout(timer);
            timer = null;
      
            const defaultRes = (typeof handler === 'function' ? handler() : handler) || {};
            resolve(defaultRes);
          }, timeout);
        });
      };
    • Pemanggilan contoh

      const KV_TIMEOUT = 1000;
      let edgekv = new EdgeKV({
        namespace: KV_NS,
      });
      
      let kvRequest = edgekv.get(key, getType);
      let timeoutPromise = RequestTimeout(KV_TIMEOUT, {
        handler: {
          res: {},
          errorMessage: `kv request timeout (${KV_TIMEOUT}ms)`,
        }
      });
      
      let resp = await Promise.race([
        kvRequest,
        timeoutPromise,
      ]);
      
      if (resp === undefined) {
        return "kv not found, key = " + key;
      } else {
        return resp;
      }

Redirect

Fetch mengikuti redirect 3xx (301, 302, 303, 307, 308). Tentukan salah satu dari tiga perilaku redirect berikut:

  • {redirect: "manual"}: Tidak mengikuti redirect 3xx. Anda harus menangani redirect secara manual.

  • {redirect: "error"}: Kesalahan dilemparkan untuk respons 3xx.

  • {redirect: "follow"}: (Default) Mengikuti redirect 3xx. Maksimal 20 redirect dapat diikuti.

Perilaku redirect berdasarkan kode status:

Kode status

Detail pengalihan

301, 302, 303, 308

Metode permintaan diubah menjadi GET, dan badan diabaikan.

307

Hanya metode GET yang diikuti. Kesalahan dilaporkan untuk metode lainnya.

Catatan

Redirect menggunakan header Location, yang wajib ada. Header Location yang tidak ada menyebabkan kesalahan.

  • Header Location dapat berisi daftar URL yang dipisahkan koma (,). Hanya URL pertama yang digunakan, sisanya diabaikan.

  • Header Location dapat berisi URL absolut atau URL relatif.

Dekompresi

Fetch API memungkinkan Anda mengonfigurasi mode dekompresi, seperti fetch("https://www.example.com",{decompress: "manual"}). Parameter decompress mendukung nilai-nilai berikut:

  • manual: tidak mendekompresi data. Jika server mengembalikan data terkompresi saat permintaan fetch, data yang diterima oleh EdgeRoutine (ER) juga dalam kondisi terkompresi.

  • decompress: secara otomatis mendekompresi data. Ini adalah nilai default. Fetch API mendukung kompresi Gzip. ER secara otomatis mendeteksi atau mendekompresi data berdasarkan header Content-Encoding. Setelah ER mendekompresi data, ER mengubah nilai Content-Encoding. Jika parameter Gzip dihapus, Anda dapat mengonfigurasi pengaturan berikut untuk mencegah pengecualian selama transmisi data:

    • content-encoding: gzip: ER mengenali nilai Content-Encoding dan mendekompresi data.

    • content-encoding: gzip, identity: ER mengenali nilai Content-Encoding dan mendekompresi data.

    Catatan

    Algoritma selain Gzip menyebabkan pengecualian.

  • fallbackIdentity: Efek nilai ini mirip dengan nilai decompress. Jika ER tidak dapat mengenali nilai ini, ER tidak mendekompresi data.

Penting

Setelah Fetch API secara otomatis mendekompresi data, Anda tidak dapat meneruskan header Content-Length sesuai kebutuhan jika respons berisi header Content-Length. Hal ini karena header Content-Length menunjukkan ukuran data sebelum dekompresi.

content-length

Ketika content-length diatur, Fetch mengirimkan badan menggunakan encoding content-length. Tanpa content-length, Fetch mengirimkan seluruh data badan menggunakan encoding chunked.

  • Pengaturan content-length

    • Jika content-length adalah angka non-negatif: Fetch membaca dan mengirimkan jumlah byte yang ditentukan dari aliran badan. Data dikirim menggunakan encoding content-length. Jika content-length bernilai 0, tidak ada data yang dikirim.

    • Jika content-length adalah nilai tidak valid: Fetch mengirimkan seluruh data dalam badan menggunakan encoding chunked.

  • Contoh

    Fetch mendekompresi konten secara otomatis. Header content-length pada respons tetap mencerminkan ukuran sebelum dekompresi. Jika Anda memodifikasi badan sebelum meneruskan, pastikan bahwa content-length sesuai dengan ukuran badan aktual. Ketidaksesuaian content-length menyebabkan pengiriman konten yang salah.

    Pada contoh ini, client mengirim permintaan POST dengan header content-length. Jika Anda membuat permintaan Fetch baru dengan menggunakan kembali header client, content-length mungkin tidak sesuai dengan ukuran badan baru. Selalu verifikasi ukuran badan saat meneruskan header.

    export default {
      fetch(request) {
        return handleRequest(request)
      }
    }
    async function handleRequest(request) {
      return fetch("http://www.example.com", {
        headers: request.headers,
        method: request.method,
        body: "SomeData"
      });
    }

Header

  • Definisi

    Untuk informasi lebih lanjut tentang objek Headers, lihat Headers.

  • Batas

    Header mencatat jumlah sumber daya memori yang dikonsumsi. Ukuran maksimum objek Headers adalah 8 KB. Jika ukuran objek Headers melebihi batas ini, pengecualian JavaScript dilemparkan.

  • Blacklist

    Fetch API menggunakan blacklist header. Jika Anda mencoba membaca atau menulis header yang ada dalam blacklist, pengecualian dilemparkan. Tabel berikut menjelaskan header yang termasuk dalam blacklist.

    • expect

    • te

    • trailer

    • upgrade

    • proxy-connection

    • connection

    • keep-alive

    • dnt

    • host

    • Header yang dicadangkan

Request

  • Definisi

    Mengikuti spesifikasi MDN Request.

  • Batas

    Properti Request berikut tidak didukung di CDN, DCDN, atau ESA.

    • context

    • credentials

    • destination

    • integrity

    • mode

    • referrer

    • referrerPolicy

    • cache

  • Penggunaan umum

    • Ambil metode permintaan: request.method.

    • Ambil URL permintaan: request.url.

    • Ambil header permintaan: request.headers.

    • Ambil muatan permintaan: request.body. Badan merupakan objek ReadableStream.

    • Ambil JSON: await request.json().

    • Ambil data formulir: await request.formData().

    • Ambil string UTF-8: await request.text().

    Sebagai ekstensi non-standar, request.ignore mengosongkan aliran badan di tingkat socket tanpa memuatnya ke memori VM JavaScript, sehingga menghindari penundaan GC. Panggil await request.ignore() ketika Anda tidak memerlukan badan permintaan. Waktu proses mengembalikan koneksi ke pool setelah badan sepenuhnya dibaca.

Response

  • Definisi

    Mengikuti spesifikasi MDN Response.

  • Batas

    Properti useFinalURLS dan error tidak didukung di CDN, DCDN, atau ESA.

  • Penggunaan umum

    • Ambil kode respons: response.status.

    • Ambil frasa alasan respons: response.statusText.

    • Ambil header respons: response.headers.

    • Ambil URL respons: response.url. Ini adalah URL akhir setelah semua redirect.

    • Ambil semua URL redirect (non-standar): response.urlList. Response mengimplementasikan mixin badan seperti Request, sehingga metode pengambilan badan yang sama berlaku.

FormData

  • Definisi

    Untuk informasi lebih lanjut tentang operasi FormData, lihat FormData.

  • Batas

    Operasi FormData mirip dengan operasi Headers. FormData membatasi ukuran header. Jika ukuran header melebihi batas atas, pengecualian dilemparkan. Jika Anda mengirim FormData sebagai badan permintaan HTTP, content-type secara default diatur ke form-data/multipart.

URLSearchParams

  • Definisi

    Untuk informasi lebih lanjut tentang operasi URLSearchParams, lihat URLSearchParams().

  • Batas

    Jika Anda mengirim URLSearchParams sebagai badan permintaan HTTP, content-type secara default diatur ke application/x-www-form-urlencode. Ukuran data tidak boleh melebihi 1.000 byte.

Blob dan File

  • Definisi

    • Untuk informasi lebih lanjut tentang operasi Blob, lihat Blob.

    • Untuk informasi lebih lanjut tentang operasi File, lihat File.

  • Batas

    ER mendukung kelas Blob dan File, yang memenuhi standar operasi Blob dan File. ER tidak dapat membaca atau menulis file. Anda dapat meneruskan kelas Blob dan File yang didukung ER ke badan respons. Nilai header content-type sama dengan tipe MIME dalam operasi Blob atau File.