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, danintegritydari parameterinittidak berpengaruh. -
redirectsecara default bernilaifollow, yang mengikuti respons 3xx dari origin. Aturredirectkemanualuntuk menonaktifkan pengikutan redirect.
Catatan-
Mode Fetch khusus browser tidak berlaku. Di CDN, DCDN, atau ESA,
CROS fetchdapat 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
manualuntuk 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. |
Redirect menggunakan header Location, yang wajib ada. Header Location yang tidak ada menyebabkan kesalahan.
-
Header
Locationdapat berisi daftar URL yang dipisahkan koma (,). Hanya URL pertama yang digunakan, sisanya diabaikan. -
Header
Locationdapat 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.
CatatanAlgoritma selain Gzip menyebabkan pengecualian.
-
-
fallbackIdentity: Efek nilai ini mirip dengan nilai decompress. Jika ER tidak dapat mengenali nilai ini, ER tidak mendekompresi data.
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-lengthadalah angka non-negatif: Fetch membaca dan mengirimkan jumlah byte yang ditentukan dari aliran badan. Data dikirim menggunakan encodingcontent-length. Jikacontent-lengthbernilai 0, tidak ada data yang dikirim. -
Jika
content-lengthadalah nilai tidak valid: Fetch mengirimkan seluruh data dalam badan menggunakan encoding chunked.
-
-
Contoh
Fetch mendekompresi konten secara otomatis. Header
content-lengthpada respons tetap mencerminkan ukuran sebelum dekompresi. Jika Anda memodifikasi badan sebelum meneruskan, pastikan bahwacontent-lengthsesuai dengan ukuran badan aktual. Ketidaksesuaiancontent-lengthmenyebabkan 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-lengthmungkin 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.ignoremengosongkan aliran badan di tingkat socket tanpa memuatnya ke memori VM JavaScript, sehingga menghindari penundaan GC. Panggilawait 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-typesecara default diatur keform-data/multipart.
URLSearchParams
-
Definisi
Untuk informasi lebih lanjut tentang operasi URLSearchParams, lihat URLSearchParams().
-
Batas
Jika Anda mengirim URLSearchParams sebagai badan permintaan HTTP,
content-typesecara default diatur keapplication/x-www-form-urlencode. Ukuran data tidak boleh melebihi 1.000 byte.
Blob dan File
-
Definisi
-
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-typesama dengan tipe MIME dalam operasiBlobatauFile.