Pelajari host, path, query, dan fragment URL lewat program Node.js lokal. Uji alamat relatif, alamat dasar, serta kesalahan tanpa meminta halaman ke server.

Ketahui tujuan tautan sebelum mengeditnya

Saat menyiapkan katalog atau halaman layanan, Anda mungkin menerima beberapa bentuk tautan: alamat lengkap, alamat yang diawali garis miring, dan nama halaman singkat. Bentuknya tampak mirip, tetapi hasil penafsirannya dapat berbeda ketika memakai alamat dasar tertentu. Sebelum mengganti tautan pada website, pelajari dahulu bagian alamat yang sedang dibicarakan. Penguraian URL membantu editor dan pengembang menyepakati nama host, lokasi halaman, parameter, serta penanda bagian tanpa harus menebak berdasarkan tampilan tulisan yang panjang.

Tutorial ini menggunakan program lokal kecil untuk menampilkan bagian URL. Tidak ada permintaan ke server, pencarian DNS, atau pembukaan halaman dalam program latihan. Hasilnya membantu memahami penulisan alamat, sementara ketersediaan halaman tetap memerlukan pemeriksaan lain. Pada pengujian contoh, sembilan kasus lokal diperiksa menggunakan Node.js v24.22.1. Nomor itu mencatat lingkungan pengujian artikel, bukan pernyataan tentang versi terbaru atau kewajiban mengganti versi pada komputer Anda. Semua alamat latihan merupakan contoh, bukan alamat pelanggan.

Diagram membagi sebuah URL contoh menjadi protokol, hostname, path, query, dan fragment yang berbeda warna.
Penguraian lokal memisahkan komponen alamat; hasil ini tidak menyatakan halaman atau bagian tujuan tersedia.

Prasyarat: Node.js, editor teks, dan folder latihan

Siapkan Node.js yang sudah dapat dipanggil dari terminal, editor teks biasa, serta folder latihan milik Anda. Contoh perintah memakai PowerShell di Windows. Jalankan node --version dan catat hasilnya agar pengujian berikutnya mempunyai konteks lingkungan yang jelas. Jika perintah belum tersedia, siapkan lingkungan sesuai panduan resmi Node.js sebelum memulai. Latihan tidak memerlukan pemasangan paket tambahan, akun hosting, maupun salinan konfigurasi aplikasi. Gunakan teks contoh yang disediakan agar hasil awal mudah dibandingkan.

Pisahkan folder latihan dari berkas proyek yang akan diterbitkan. Siapkan catatan dengan kolom masukan, alamat dasar bila ada, hasil yang diharapkan, dan hasil program. Anda akan menguji satu perubahan pada satu waktu sehingga penyebab perbedaan dapat ditelusuri. Hindari memakai tautan pribadi atau alamat yang berisi informasi pelanggan sebagai bahan latihan. Kebutuhan tutorial dapat dipenuhi seluruhnya oleh contoh buatan, sehingga tidak ada manfaat menambahkan data nyata hanya untuk mempelajari cara membaca struktur alamat.

Perbandingan alamat kontak dengan alamat dasar yang memakai atau tidak memakai garis miring terakhir.
Dua kasus lokal menghasilkan path berbeda karena aturan resolusi alamat relatif, bukan penempelan teks biasa.

Langkah 1: tentukan pertanyaan pemeriksaan

Mulailah dengan alamat https://katalog.example/layanan?paket=dasar#kontak. Pertanyaan latihannya adalah apakah host bernama katalog.example, path bernama /layanan, parameter memuat ?paket=dasar, dan penanda bagian memuat #kontak. Tuliskan hasil yang diharapkan ini sebelum menjalankan program. Cara tersebut membedakan pemeriksaan yang mempunyai sasaran dari kegiatan sekadar melihat keluaran terminal. Ketika nanti mencoba alamat lain, Anda dapat menilai perubahan bagian tertentu tanpa perlu menyimpulkan bahwa seluruh alamat menjadi benar atau salah sekaligus.

Dokumentasi Node.js menyediakan objek URL untuk mengurai alamat dan membaca komponennya. Program di bawah menampilkan lima properti saja agar hasil tetap ringkas: protocol, hostname, pathname, search, dan hash. Nama kolom sengaja mengikuti nama properti yang digunakan kode. Jangan mengganti label kolom pada awal latihan karena Anda akan mencocokkannya dengan hasil pengujian. Setelah memahami contoh dasar, Anda boleh menambahkan catatan editorial di luar program, misalnya halaman mana yang seharusnya memakai tautan tersebut.

Langkah 2: simpan program pembaca URL

Buat berkas periksa-url.cjs pada folder latihan, lalu salin kode latihan yang disediakan pada bagian ini. Simpan sebagai teks biasa dengan nama berkas yang benar, bukan periksa-url.cjs.txt. Program mengambil alamat dari argumen pertama dan alamat dasar opsional dari argumen berikutnya. Keluaran berhasil berbentuk JSON agar setiap komponen mudah dibaca. Keluaran gagal berupa URL_TIDAK_VALID, sehingga Anda tetap mendapatkan tanda yang jelas ketika masukan tidak dapat diurai oleh program.

Kode latihan (simpan sebagai periksa-url.cjs): const input = process.argv[2]; const base = process.argv[3]; try { const u = base === undefined ? new URL(input) : new URL(input, base); console.log(JSON.stringify({ protocol: u.protocol, hostname: u.hostname, pathname: u.pathname, search: u.search, hash: u.hash }, null, 2)); } catch { console.log('URL_TIDAK_VALID'); process.exitCode = 1; }

Buka terminal dari folder tempat berkas tersimpan. Pastikan perubahan editor sudah disimpan sebelum mencoba perintah. Program ini hanya memakai kemampuan bawaan Node.js; jangan menambahkan pustaka pemanggil jaringan untuk mengikuti latihan. Bila terminal menyatakan modul atau berkas tidak ditemukan, periksa lokasi kerja dan nama berkas terlebih dahulu. Masalah menemukan program berbeda dari masalah pada masukan URL. Pisahkan keduanya dalam catatan agar Anda tidak mengubah alamat yang sebenarnya belum pernah diproses oleh kode latihan.

Langkah 3: uji alamat lengkap dan cocokkan komponennya

Jalankan node .\periksa-url.cjs 'https://katalog.example/layanan?paket=dasar#kontak'. Tanda kutip menjaga alamat tetap sebagai satu argumen pada contoh terminal ini. Bandingkan hasil dengan sasaran pada langkah pertama. Nilai protocol yang diharapkan adalah https:, hostname adalah katalog.example, pathname adalah /layanan, search adalah ?paket=dasar, dan hash adalah #kontak. Pada pengujian lokal artikel, kelima nilai itu sesuai dengan hasil yang diharapkan. Simpan catatan hasil sebelum menambahkan variasi lain.

Perhatikan bahwa host tidak sama dengan seluruh alamat dan path tidak memuat parameter pencarian. Pemisahan ini berguna saat editor berkata “halaman salah”, tetapi yang berubah sebenarnya hanya penanda bagian. Diskusikan bagian yang tepat ketika meminta bantuan pengembang. Hasil penguraian belum membuktikan bagian kontak tersedia pada halaman tujuan atau paket dasar dikenal oleh aplikasinya. Program hanya membaca susunan alamat yang diberikan, sehingga pembahasan tentang isi halaman harus tetap dibawa ke pengujian website secara terpisah.

Langkah 4: bandingkan alamat relatif dengan dua alamat dasar

Jalankan node .\periksa-url.cjs 'kontak' 'https://katalog.example/layanan/'. Hasil pathname yang diharapkan adalah /layanan/kontak. Ulangi dengan alamat dasar https://katalog.example/layanan tanpa garis miring terakhir. Hasil pathname kini diharapkan /kontak. MDN menjelaskan bahwa penentuan alamat relatif memakai aturan resolusi, bukan sekadar menempelkan dua teks. Percobaan berpasangan ini menunjukkan alasan sebuah garis miring pada alamat dasar perlu diperhatikan saat Anda mendiskusikan tautan pendek dengan pengembang.

Selanjutnya, jalankan node .\periksa-url.cjs '/kontak' 'https://katalog.example/layanan/'. Pada contoh ini, pathname yang diharapkan kembali menjadi /kontak karena masukan diawali garis miring menuju akar. Catat tiga hasil tersebut berdampingan. Jangan mengubah tautan pada semua halaman hanya setelah mencoba satu alamat dasar. Website dapat memiliki susunan halaman berbeda, sehingga sasaran penempatan tautan perlu diketahui dahulu. Latihan ini memberi contoh yang terukur untuk percakapan tersebut, bukan kebijakan penulisan tautan yang berlaku otomatis bagi semua proyek.

Langkah 5: periksa asumsi tentang host dan jenis alamat

Coba node .\periksa-url.cjs 'https://mitra.example/info' 'https://katalog.example/layanan/'. Host hasilnya adalah mitra.example. MDN menjelaskan bahwa masukan absolut tidak memakai alamat dasar untuk menentukan hasilnya. Percobaan ini penting bila Anda mengira argumen alamat dasar selalu membatasi tujuan pada satu website. Catat bahwa program berhasil mengurai alamat, kemudian bandingkan host dengan tujuan yang diharapkan oleh pekerjaan editorial. Dua penilaian tersebut harus tetap terpisah ketika hasil dibawa ke rapat proyek.

Sebagai pembanding tambahan, jalankan node .\periksa-url.cjs 'mailto:[email protected]'. Masukan ini juga dapat diurai, tetapi protocol bernilai mailto: dan hostname kosong pada contoh tersebut. Program tidak mengirim email. Karena itu, “bisa diurai” bukan berarti “tautan halaman HTTPS yang diinginkan”. Bila pekerjaan Anda mensyaratkan hanya halaman tertentu pada host tertentu, pengembang perlu menetapkan aturan tambahan sesuai kebutuhan. Parser tidak boleh dijadikan satu-satunya penentu keamanan alamat, izin akses, maupun kesesuaian tujuan bisnis.

Langkah 6: buat kesalahan terkontrol dan lakukan verifikasi ulang

Jalankan node .\periksa-url.cjs '/kontak' tanpa alamat dasar. Hasil yang diharapkan adalah URL_TIDAK_VALID. Uji pula masukan 'https://' yang belum mempunyai host. Program menangani kesalahan penguraian dan memberikan tanda gagal yang sama. Setelah itu, perbaiki kasus pertama dengan menambahkan alamat dasar seperti pada langkah sebelumnya, lalu jalankan lagi. Anda seharusnya kembali memperoleh komponen URL. Pasangan gagal, perbaikan, dan pengujian ulang membantu memastikan Anda memahami kebutuhan setiap masukan.

Untuk menutup latihan, ulangi kasus alamat lengkap, dua variasi alamat dasar, alamat dari akar, alamat absolut milik host lain, dua kesalahan terkontrol, alamat mailto, serta host yang tampak mirip. Contoh https://katalog.example.mitra.example/kontak menghasilkan hostname katalog.example.mitra.example, bukan katalog.example. Perbedaan tersebut terlihat saat membaca nilai utuh. Sembilan kasus ini lulus pengujian program lokal dalam persiapan artikel. Tidak ada hasil akses website yang diklaim, karena pengujian hanya membandingkan komponen keluaran dan penanganan kesalahan terhadap sasaran yang telah ditentukan.

Kesalahan umum dan penggunaan hasil dalam proyek

Kesalahan yang perlu dihindari meliputi lupa menyimpan program, salah folder terminal, menghapus tanda kutip pada argumen, serta mengira alamat dasar pasti mempertahankan host. Kesalahan lain adalah membandingkan potongan host yang terlihat familier alih-alih membaca hostname secara lengkap. Saat hasil berbeda dari perkiraan, periksa masukan dan alamat dasar sebagai pasangan. Jangan langsung mengganti seluruh tautan website. Buat satu contoh kecil yang dapat diulang, kemudian bawa perbedaan yang ditemukan kepada orang yang mengelola struktur halaman.

Gunakan hasil latihan sebagai catatan penguraian, lalu lanjutkan pemeriksaan tujuan halaman bersama tim bila perubahan memang diperlukan. Untuk perencanaan nama website, halaman domain JagoWeb tersedia di https://www.jagoweb.com/domain-murah dan pengantar layanan ada di https://www.jagoweb.com/. Kebutuhan nama domain, struktur URL, serta penempatan isi halaman dapat dibahas sebagai bagian yang berkaitan dalam proyek. Catatan yang menyebut komponen secara tepat membantu pembahasan itu menjadi konkret, sekaligus menjaga agar keberhasilan parser tidak disalahartikan sebagai bukti website telah berfungsi seluruhnya.

Bacaan terkait

Sumber dan referensi