Pada 18 November 2026 tim SvelteKit merilis @sveltejs/adapter-cloudflare 9.0.0 yang menghapus dukungan Cloudflare Pages, bersama @sveltejs/adapter-auto 9.0.0 yang otomatis membangun untuk Cloudflare Workers, tidak lagi untuk Pages. Kalau aplikasimu dideploy ke Pages, menaikkan kedua paket itu akan merusak deploy sampai kamu pindah ke Workers dengan static assets. Dokumentasi Cloudflare tidak menyatakan Pages deprecated, tetapi menyarankan proyek baru memakai Workers. Tahan dulu versi paketmu di mayor sebelumnya sampai migrasi siap.
Lima perubahan breaking di adapter-cloudflare 9
Catatan rilis GitHub mencantumkan: opsi adapter worker kini mengendalikan apakah Worker dibangun, pengaturan main di konfigurasi Wrangler diisi otomatis, paths.assets ditolak karena tidak bisa dilayani saat preview di workerd, dukungan Cloudflare Pages dihapus, dan opsi fallback dihapus dan digantikan pengaturan Wrangler assets.not_found_handling. Ada juga fitur minor: deployment tanpa bundling (unbundled). Catatan rilis tidak punya bagian migrasi, jadi langkahnya ada di dokumentasi Svelte. Untuk adapter-auto 9.0.0, satu-satunya perubahan breaking adalah target build otomatis Cloudflare yang berpindah ke Workers.
Langkah migrasi dari Pages menurut dokumentasi Svelte
Dokumentasi adapter menulis tiga langkah: hapus pages_build_output_dir dari konfigurasi Wrangler, hapus opsi routes pada adapter dan file _routes.json, lalu ganti wrangler pages dev dan wrangler pages deploy dengan wrangler dev dan wrangler deploy. Untuk deploy otomatis dari Git, pakai Workers Builds sebagai pengganti integrasi Git Pages. Dokumentasi juga menyarankan Wrangler versi 4 untuk menguji build. Halaman Svelte tidak memuat contoh wrangler.jsonc untuk deploy baru, jadi lihat bagian "Project configuration" di panduan migrasi Cloudflare (nama, compatibility_date, assets.directory).
Yang berbeda saat pindah ke Workers
Panduan migrasi Cloudflare (terakhir diubah 12 November 2026) mencatat fitur yang hanya ada di Workers, antara lain plugin Vite Cloudflare, gradual deployments, Workers Logs, Logpush, dan Cron Triggers. Pages masih unggul di beberapa hal: Early Hints dan kontrol branch deploy lebih lengkap, serta file-based routing. Perbedaan yang paling mudah terlewat ada di domain: Workers tidak mendukung domain yang nameserver-nya tidak dikelola Cloudflare, sehingga situs dengan DNS di luar Cloudflare perlu dicek dulu sebelum cutover. File _headers dan _redirects dalam adapter hanya berlaku untuk respons static asset, tidak untuk respons dinamis SvelteKit. Preview memakai blok previews dengan "preview_urls": true, dan alamat bawaan berpindah dari pages.dev ke workers.dev. Adapter juga belum mendukung Durable Objects dan Workflows.
Urutan migrasi yang aman
Menurut kami, lakukan di branch terpisah: perbarui paket, hapus konfigurasi Pages, jalankan wrangler dev, deploy ke URL preview, lalu cek header, redirect, halaman 404, dan binding lingkungan. Pindahkan trafik produksi terakhir. Panduan Cloudflare menyarankan menghapus proyek Pages hanya setelah trafik produksi sudah berpindah. Kalau jadwalmu padat, sematkan versi mayor sebelumnya dari kedua paket supaya npm update tidak mengubah target deploy tanpa kamu sadari. Semua sumber di bawah berasal dari tim SvelteKit dan Cloudflare, dan saya belum membaca liputan media independen untuk rilis ini.
Sumber
- GitHub, catatan rilis
@sveltejs/adapter-cloudflare@9.0.0, 18 November 2026: https://github.com/sveltejs/kit/releases/tag/%40sveltejs%2Fadapter-cloudflare%409.0.0 - GitHub, catatan rilis
@sveltejs/adapter-auto@9.0.0, 18 November 2026: https://github.com/sveltejs/kit/releases/tag/%40sveltejs%2Fadapter-auto%409.0.0 - Svelte Docs, adapter-cloudflare: https://svelte.dev/docs/kit/adapter-cloudflare
- Cloudflare Docs, migrasi dari Pages ke Workers (diubah 12 November 2026): https://developers.cloudflare.com/workers/static-assets/migration-guides/migrate-from-pages/
- Cloudflare Docs, ikhtisar Pages: https://developers.cloudflare.com/pages/