URL dan String Kueri

URL dan String Kuery

Lapisan URL mengimplementasikan parsing gaya WHATWG — perilaku yang sama diterapkan oleh peramban — sehingga URL yang diekstrak dari dokumen dapat diselesaikan dan dinormalisasi seperti yang dilakukan oleh agen pengguna yang sesungguhnya.


Penguraian dan Validasi

URL.parse() mengurai URL absolut atau relatif; URL.can_parse() memberikan jawaban mengenai keabsahan tanpa membuat objek. Kegagalan penguraian memunculkan URLParseError yang bertipe.

String Kuery

URLSearchParams membaca dan mengedit parameter kueri: append(), get(), get_all(), has(), dan delete() mencakup proses bolak-balik, mempertahankan semantik multi-nilai.


Tips dan Praktik Terbaik

  • Gunakan can_parse() untuk validasi murah di filter; buat dengan parse() hanya ketika Anda membutuhkan komponen tersebut
  • Ingat kunci kueri dapat berulang — gunakan get_all() ketika sebuah parameter mungkin muncul lebih dari sekali
  • Tangkap URLParseError daripada memvalidasi terlebih dahulu dengan ekspresi reguler

Masalah Umum

MasalahPenyebabPerbaikan
URL relatif gagal diuraiTidak ada base yang disediakanSediakan base sesuai URL.parse()
Hanya nilai kueri pertama yang dikembalikanMenggunakan get() pada kunci yang berulangGunakan get_all()
Karakter aneh di komponenNormalisasi WHATWG sedang bekerjaDiharapkan — ini cocok dengan perilaku peramban

FAQ

Apakah parsing mengikuti standar WHATWG?

Ya — normalisasi dan pemisahan komponen mencerminkan perilaku peramban.

Bagaimana cara memeriksa URL tanpa memparsenya?

URL.can_parse() mengembalikan validitas tanpa konstruksi objek.

Apakah saya dapat mengedit query string di tempat?

Ya — URLSearchParams mendukung operasi append/get/has/delete secara round-trip.


API Reference Ringkasan

Kelas/MetodeDeskripsi
URL.parseMengurai URL
URL.can_parsePemeriksaan keabsahan tanpa konstruksi
URLSearchParams.appendTambahkan parameter kueri
URLSearchParams.get_allSemua nilai untuk sebuah kunci
URLParseErrorKegagalan parsing bertipe

Lihat Juga

 Bahasa Indonesia