Error CORS di json-server biasanya tergantung versi yang kamu jalankan. Post ini membahas json-server 0.17.4, rilis stabil terakhir. v1 masih beta dan cara kerjanya berbeda.
Kenapa CORS muncul di json-server
Browser menerapkan same-origin policy. Kalau frontend jalan di http://localhost:3000 dan json-server di http://localhost:3001, browser menganggap keduanya origin yang berbeda karena port-nya tidak sama. Setiap fetch atau XHR dari frontend ke json-server akan diblokir, kecuali server membalas dengan CORS header yang sesuai.
Error-nya kira-kira begini:
Access to fetch at 'http://localhost:3001/users' from origin 'http://localhost:3000'
has been blocked by CORS policy: No 'Access-Control-Allow-Origin' header is present.
Yang sudah dilakukan json-server 0.17
CLI 0.17.4 dan jsonServer.defaults() sudah mengaktifkan CORS bawaan. Coba kirim request dengan header Origin:
curl -i -H 'Origin: http://localhost:3000' http://localhost:3001/users
Response mengembalikan origin tadi di Access-Control-Allow-Origin dan menambahkan Access-Control-Allow-Credentials: true. Preflight OPTIONS dibalas 204 berisi method dan header yang diminta browser. Jadi di 0.17 tanpa setup tambahan, CORS sudah jalan.
Kalau error-nya tetap muncul, cek dulu ini:
- Server dijalankan dengan
--no-cors(ataunoCors: truedidefaults()). - Server tidak jalan, atau port-nya salah. Browser juga melaporkan itu sebagai error CORS.
- Kamu pakai json-server v1 beta, yang mengirim
Access-Control-Allow-Origin: *dan tidak punya API untuk scripting. Penjelasannya ada di bawah.
Kapan perlu server.js sendiri
Tulis server sendiri kalau kamu ingin mengatur header, misalnya hanya mengizinkan satu origin. Buat server.js di root project:
const jsonServer = require('json-server');
const server = jsonServer.create();
const router = jsonServer.router('db.json');
server.use(jsonServer.defaults({ noCors: true }));
server.use((req, res, next) => {
res.setHeader('Access-Control-Allow-Origin', 'http://localhost:3000');
res.setHeader('Access-Control-Allow-Credentials', 'true');
res.setHeader('Access-Control-Allow-Methods', 'GET, POST, PUT, PATCH, DELETE, OPTIONS');
res.setHeader('Access-Control-Allow-Headers', 'Content-Type, Authorization');
if (req.method === 'OPTIONS') {
return res.sendStatus(204);
}
next();
});
server.use(router);
server.listen(3001, () => {
console.log('JSON Server is running on port 3001');
});
Jalankan dengan:
node server.js
noCors: true mematikan CORS bawaan supaya tidak bentrok dengan punya kamu. Middleware ini jalan sebelum router, jadi header-nya menempel di setiap response.
Kenapa handler preflight penting
Untuk request non-sederhana, yaitu yang membawa JSON body, custom header seperti Authorization, atau memakai method PUT, PATCH, DELETE, browser mengirim preflight request OPTIONS lebih dulu untuk menanyakan apakah server mengizinkannya. Pengecekan OPTIONS di middleware langsung membalas request itu, lalu request yang sebenarnya bisa lewat.
Wildcard atau origin spesifik
Access-Control-Allow-Origin: * aman untuk dev lokal selama kamu tidak mengirim credentials. Semua origin diizinkan.
Kalau kamu perlu cookie atau credentials: 'include' di fetch, browser menolak wildcard origin. Hal yang sama berlaku untuk Access-Control-Allow-Headers: *, yang di request ber-credentials dianggap sebagai nama header literal. Tulis origin dan tiap header secara eksplisit, seperti di kode di atas.
json-server v1 beta hanya ESM dan tidak punya require('json-server') maupun jsonServer.create(). Kamu hanya bisa menjalankannya sebagai CLI, dan origin-nya *. Untuk request ber-credentials, tetap di 0.17.4 atau pasang dev proxy seperti opsi server.proxy di Vite, supaya browser melihat satu origin.
Ringkasan cara fix
json-server 0.17 menangani CORS secara bawaan, jadi cek --no-cors atau port yang salah sebelum menulis apa pun. Tulis server.js sendiri hanya kalau kamu butuh header tertentu, dan sebut origin serta header secara eksplisit kalau mengirim credentials. Di v1 beta, pakai proxy.