Lewati ke konten
FrAIFlow

Solusi / Pengodean dan URL

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.

Dua kegagalan dekode berbeda
Ilustrasi buatan penulis berdasarkan contoh yang dipertahankan; bukan tangkapan layar aplikasi.

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.

Cocokkan byte dengan teks yang dimaksud
Ilustrasi buatan penulis berdasarkan contoh yang dipertahankan; bukan tangkapan layar aplikasi.

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.

Escape persen tunggal dan %92 lama sama-sama memunculkan URIError; UTF-8 %E2%80%99 didekode menjadi tanda kutip tunggal kanan.
Penjelasan asli yang dipertahankan.
Keluaran uji sintetis tercatat untuk memperbaiki UTF-8 persen-encoded tidak valid
Hasil decodeURIComponent Node.js tercatat untuk masukan persen-encoded valid dan tidak valid. Ini tangkapan keluaran pengujian tercatat, bukan aplikasi pelapor aslinya. Buka gambar bukti ukuran penuh.

Sumber dan bacaan terkait