Memperbaiki pengodean persen yang tidak valid dalam URL
Nilai URL mencapai aplikasi, tetapi decodeURIComponent() memunculkan URIError. Sebelum mengganti tanda baca, pisahkan dua kegagalan: escape persen tidak lengkap dan escape byte lengkap yang bukan UTF-8 valid.
Temukan batas tempat nilai berubah
Misalnya kotak pencarian menerima 50% off, tetapi membuka tautan hasilnya membuat halaman gagal. Tanda persen adalah teks biasa di kotak pencarian. Tanda itu menjadi khusus hanya ketika kode menganggap teks tersebut komponen URL yang sudah dikodekan. Catat nilai yang diharapkan di setiap batas: teks pengguna, URL terserialisasi, dan nilai yang dibaca halaman penerima. Yang dicari ketidaksesuaian pengodean, bukan tanda baca untuk dihapus.
Gunakan contoh tidak sensitif, bukan menyalin tautan reset kata sandi atau kueri pelanggan asli ke konsol atau isu publik. Pertama coba decodeURIComponent("%25"): hasil yang diharapkan satu tanda persen. Lalu coba contoh gagal memakai fungsi bantu terlindungi dalam “Tolak masukan tidak valid tanpa menjatuhkan halaman” di bawah. Jika kontrol valid bekerja tetapi contoh gagal, dekoder tidak rusak secara universal; data masukannya perlu diperiksa.
Bedakan escape rusak dari UTF-8 tidak valid
Karakter % tunggal tidak memiliki nilai byte dua digit. Sebaliknya, %92 secara sintaks adalah escape byte, tetapi byte tersebut tidak dapat berdiri sendiri dalam UTF-8. Laporan publik menunjukkan kedua kesalahan, termasuk byte tanda kutip lama dan %AF tersendiri.
decodeURIComponent("%"); // URIError
decodeURIComponent("%92"); // URIError
decodeURIComponent("%25"); // %
decodeURIComponent("%C2%AF"); // ¯
decodeURIComponent("%E2%80%99"); // ’
Contoh uji Node v24.19.0 yang dipertahankan mereproduksi hasil ini serta menguji %91, %AF, dan kutip kiri UTF-8. Bunyi kesalahan peramban bisa berbeda; keberhasilan atau penolakan masukan persis itulah bukti berguna.
Buat query string tanpa merangkai escape persen manual
Untuk tautan baru, berikan teks asli kepada URL API dan biarkan API menserialisasi parameter. Di sisi penerima, baca parameter melalui API yang sama. Jangan langsung mendekode ulang nilai yang dikembalikan:
const link = new URL("https://example.com/search");
link.searchParams.set("q", "50% off & café");
const received = new URL(link.href).searchParams.get("q");
console.log(received); // 50% off & café
Ini URL contoh, bukan endpoint FrAIFlow. Perbedaan pentingnya antara komponen terkode dan nilai yang sudah diparsing. Dekode kedua dapat mengubah teks yang sepenuhnya sah seperti 50% off menjadi exception. Ingat juga bahwa tanda plus pada parameter kueri bergaya formulir ditangani berbeda dari plus literal yang diberikan langsung ke decodeURIComponent(); gunakan parser sesuai format.
Perbaiki pembuatnya, bukan menebak karakter
Simpan contoh gagal persis secara privat dan tanyakan pengodean karakter yang dipakai kepada pembuat. %92 tunggal mungkin mengisyaratkan konvensi byte lama, tetapi byte saja tidak memastikan asalnya. Jangan diam-diam mengganti menjadi apostrof dalam ID akun, tanda tangan, atau nama berkas. Kembalikan kesalahan berguna, pertahankan masukan asli bagi pengguna, dan perbaiki pengodean pada sumber jika memungkinkan.
Setelah perubahan, uji persen literal, kata beraksen, kutip melengkung, tanda plus, dan ampersand. Setiap nilai harus melewati proses buat tautan → buka tautan → baca nilai tanpa perubahan. Masukan tidak valid harus menghasilkan kesalahan terkendali, bukan menghentikan halaman lainnya. Pemeriksaan ini memverifikasi kontrak format; bukan membenarkan dekode berulang sampai string tampak terbaca.
Tolak masukan tidak valid tanpa menjatuhkan halaman
function decodeComponent(value) {
try { return { ok: true, value: decodeURIComponent(value) }; }
catch (error) {
if (!(error instanceof URIError)) throw error;
return { ok: false, error: "Invalid encoded component" };
}
}
Batas ini melaporkan kegagalan tanpa diam-diam mengubah pengenal. Ia tidak dapat menemukan pengodean sumber yang tidak diketahui. Dekode hanya sebanyak yang diwajibkan kontrak format: persen yang tersisa setelah dekode berhasil bukan alasan untuk putaran lain. Hindari unescape() yang usang sebagai solusi UTF-8, dan jangan masukkan token atau nilai kueri privat ke log diagnostik publik.
