PENAWARAN Langkah besar dimulai dari sini. Lihat promo
JAGOWEB INSIGHT

Tutorial Mengurutkan Nama Katalog dengan Intl.Collator tanpa Mengubah Array Asal

Urutkan nama seperti Paket 1, Paket 2, dan Paket 10 dengan Intl.Collator, pertahankan data asal, lalu uji nama setara serta masukan yang tidak sesuai.

Nama yang mengandung angka membutuhkan aturan yang jelas

Katalog website sering memakai nama dengan bagian angka, seperti Paket 1, Paket 2, dan Paket 10. Ketika daftar diurutkan sebagai teks biasa, hasilnya belum tentu sesuai cara pembaca membandingkan nomor tersebut. Masalah lain muncul ketika fungsi pengurutan mengubah daftar yang masih dipakai komponen lain. Tutorial ini membuat fungsi lokal yang menyusun nama dengan aturan bahasa, mempertimbangkan bagian angka, serta mengembalikan array hasil tanpa menggeser urutan array sumber.

Semua data latihan adalah produk rekaan. Fungsi tidak mengambil katalog dari jaringan, menyentuh basis data, atau mengubah urutan produk pada toko nyata. Tujuannya menyiapkan contoh yang mudah dibaca saat berdiskusi dengan pengembang. Aturan urut perlu disepakati: apakah nomor dalam nama diperlakukan secara numerik, apakah huruf besar kecil membedakan posisi, dan apa yang dilakukan ketika dua nama dinilai setara. Keputusan tersebut membuat hasil lebih mudah dijelaskan daripada sekadar menyebut daftar sudah alfabetis.

Daftar empat nama paket sebelum pengurutan dan sesudah numeric collation, dengan identitas item tetap terlihat.
Urutan tampilan berubah menjadi Paket 1, Paket 2, paket 2, Paket 10 tanpa mengubah daftar asal.

Prasyarat dan kontrak masukan latihan

Siapkan editor teks, terminal, serta Node.js yang mendukung Intl.Collator dan locale id-ID. Periksa runtime melalui node --version, lalu gunakan folder latihan baru untuk menyimpan berkas .mjs. Program tidak memerlukan paket tambahan. Bagian awal kode memeriksa dukungan locale sebelum melanjutkan, sehingga lingkungan yang tidak memenuhi prasyarat tidak diam-diam memakai aturan bahasa bawaan. Catat versi runtime ketika menyimpan hasil agar rekan mengetahui konteks pengujian yang digunakan.

Fungsi menerima array yang setiap itemnya memiliki nama berupa teks terisi tanpa spasi pada awal atau akhir. Nama kosong dan bentuk yang tidak sesuai ditolak. Ini kontrak sederhana untuk latihan, bukan aturan universal semua katalog. Identitas item dipertahankan sebagai data terpisah dari nama. Dua produk dapat mempunyai tampilan nama yang mirip, sehingga pengurutan tidak boleh sekaligus dianggap sebagai pemeriksaan keunikan identitas atau perintah menghapus produk yang terlihat sama.

Dua nama dengan perbedaan huruf besar kecil dinilai setara lalu memakai posisi asal sebagai pemutus urutan.
Kesetaraan dalam aturan urut tidak menyatakan bahwa dua produk mempunyai identitas yang sama.

Langkah 1: tentukan locale dan pilihan perbandingan

Gunakan locale id-ID agar maksud bahasa terbaca dalam kode. Pilihan usage sort menyatakan fungsi dipakai untuk pengurutan. numeric true membuat bagian angka dibandingkan secara numerik pada aturan kolasi, sedangkan sensitivity base dipakai pada contoh untuk menyetarakan perbedaan seperti huruf besar kecil. Dokumentasi konstruktor menjelaskan bahwa pilihan yang berbeda mengubah hal-hal yang dianggap berbeda. Jangan mengganti opsi sekadar agar satu contoh tampak benar tanpa memeriksa nama lain yang dipakai katalog.

Perbandingan bahasa dapat berbeda menurut locale. Karena itu, jangan menganggap semua aksen dan huruf mempunyai hubungan yang identik pada setiap bahasa. Untuk katalog nyata, buat contoh nama yang mewakili isinya dan bahas hasil yang diinginkan dengan pemilik konten. Tutorial ini membuktikan keadaan rekaan yang disebutkan, bukan menjanjikan bahwa satu konfigurasi merupakan aturan urut terbaik untuk seluruh bahasa. Kode tetap menyimpan ejaan asli agar keputusan penyajian tidak mengubah nama produk secara diam-diam.

Langkah 2: simpan fungsi dan daftar produk

Salin kode lengkap berikut ke latihan-urut.mjs lalu simpan dalam UTF-8. Program membuat salinan array, memeriksa nama, dan membungkus tiap item bersama posisi asalnya. Perbandingan nama menjadi keputusan utama. Jika hasil perbandingan nol, selisih posisi asal menentukan urutan kedua item. Sesudah pengurutan, pembungkus dilepas sehingga hasil berisi item aslinya. Pembagian tahap ini memudahkan Anda meninjau mengapa sebuah produk muncul sebelum produk lain.

Kode latihan lengkap — simpan sebagai latihan-urut.mjs: if (!Intl.Collator.supportedLocalesOf(['id-ID']).length) {

  throw new Error('Runtime latihan perlu mendukung locale id-ID');
}
const pembanding = new Intl.Collator('id-ID', {
  usage: 'sort', numeric: true, sensitivity: 'base'
});

function urutNama(data) {
  if (!Array.isArray(data)) throw new TypeError('Masukan harus berupa array');
  const salinan = Array.from(data);
  if (salinan.some(item => typeof item?.nama !== 'string' ||
      !item.nama.trim() || item.nama !== item.nama.trim())) {
    throw new TypeError('Setiap nama harus berupa teks terisi tanpa spasi tepi');
  }
  return salinan.map((item, posisi) => ({item, posisi}))
    .sort((a, b) => pembanding.compare(a.item.nama, b.item.nama) || a.posisi - b.posisi)
    .map(hasil => hasil.item);
}

const katalog = [
  {id: 'a', nama: 'Paket 10'},
  {id: 'b', nama: 'Paket 2'},
  {id: 'c', nama: 'Paket 1'},
  {id: 'd', nama: 'paket 2'}
];
console.log('Asal:', katalog.map(p => p.id + ':' + p.nama));
console.log('Urut:', urutNama(katalog).map(p => p.id + ':' + p.nama));
console.log('Asal sesudah:', katalog.map(p => p.id + ':' + p.nama));
console.log('Opsi:', pembanding.resolvedOptions());

export {pembanding, urutNama, katalog};

Dokumentasi Array.sort menjelaskan bahwa metode tersebut mengurutkan array yang dipanggil secara langsung. Dalam contoh, sort dipakai pada array pembungkus yang baru dibuat, sehingga urutan katalog sumber tetap terjaga. Hasil ini bukan salinan mendalam seluruh objek produk. Item pada keluaran masih merujuk objek yang sama. Bila aplikasi kemudian mengubah isi objek itu, perubahannya dapat terlihat melalui rujukan lain. Pisahkan kebutuhan mengurutkan daftar dari kebutuhan menyalin dan menyunting seluruh data.

Langkah 3: jalankan dan bandingkan daftar asal

Buka terminal pada folder latihan dan jalankan node latihan-urut.mjs. Baris Urut seharusnya menampilkan identitas c, b, d, lalu a, dengan nama Paket 1, Paket 2, paket 2, lalu Paket 10. Baris Asal dan Asal sesudah harus tetap mempunyai urutan a, b, c, d. Baca identitas bersama nama agar item yang hanya berbeda kapitalisasi tidak tertukar ketika Anda menilai hasil. Pemeriksaan ini menunjukkan perubahan urutan hasil dan pemeliharaan array sumber sebagai bukti yang berbeda.

Lihat juga keluaran Opsi untuk mengetahui pilihan yang benar-benar dipakai runtime. Pastikan numeric bernilai true dan sensitivity bernilai base. Bila hasil berbeda, periksa versi berkas, dukungan locale, dan konfigurasi sebelum mengubah data contoh. Simpan keluaran aktual sebagai bahan tinjauan. Jangan menganggap urutan yang kebetulan cocok pada komputer pertama cukup untuk mewakili seluruh lingkungan yang kelak menjalankan komponen. Persyaratan tampilan perlu diuji ulang pada runtime tujuan ketika fungsi diintegrasikan.

Langkah 4: periksa nama setara dan tanda hasil compare

Pada pilihan contoh, Paket 2 dan paket 2 dapat dinilai setara oleh pembanding. Fungsi memakai posisi asal untuk menjaga b tetap mendahului d. Coba menukar posisi dua item tersebut dalam salinan data, lalu jalankan kembali dan periksa urutan pasangan yang setara. Item tidak digabung atau dihapus; keduanya tetap ada. Pengamatan ini membantu menjelaskan bahwa kesetaraan untuk kebutuhan pengurutan berbeda dari kesamaan identitas produk atau kesamaan seluruh atributnya.

MDN menjelaskan bahwa hasil compare dipakai melalui tandanya: negatif, nol, atau positif. Jangan menulis aturan yang hanya bekerja jika hasilnya persis minus satu atau satu. Dalam contoh, nilai perbandingan langsung diteruskan ke sort, sedangkan nol mengaktifkan pemutus posisi asal. Jika menulis pemeriksaan tambahan, bandingkan tandanya dengan nol. Angka pembanding bukan jarak popularitas, skor kecocokan, maupun ukuran berapa banyak karakter yang berbeda, sehingga tidak tepat digunakan sebagai metrik bisnis.

Langkah 5: coba nama tidak valid lalu pulihkan data

Pada salinan latihan, ganti satu nama menjadi teks kosong, angka, atau teks dengan spasi tepi. Simpan dan jalankan lagi. Fungsi harus menolak masukan dengan TypeError, bukan meneruskan nilai ambigu ke pengurutan. Setelah memahami hasilnya, pulihkan nama yang valid dan ulangi daftar acuan. Jangan memperbaiki masalah hanya dengan membuang semua pemeriksaan. Bila aplikasi ingin mendukung normalisasi spasi, tentukan tahap dan aturan tersebut secara terpisah agar sumber perubahan tetap dapat ditelusuri.

Tambahkan beberapa nama rekaan yang mewakili isi katalog Anda, lalu tulis urutan yang diharapkan sebelum menjalankan program. Pemeriksaan tersebut membantu menemukan asumsi yang belum disepakati, misalnya penggunaan tanda baca atau penomoran dengan awalan tertentu. Program ini hanya mengurutkan nama; pengurutan harga atau jumlah stok memerlukan data angka dan aturan lain. Jangan mengambil angka dari kalimat harga yang sudah diformat lalu menganggap pembanding nama menggantikan pemeriksaan nilai bisnis tersebut.

Kesalahan umum dan verifikasi ulang sebelum integrasi

Kesalahan yang perlu dihindari meliputi memakai sort langsung pada array sumber, menghapus item karena compare menghasilkan nol, serta menyamakan hasil numerik kolasi dengan pengurutan seluruh objek berdasarkan nilai angka. Periksa kembali jumlah item, identitas, ejaan, dan urutan sumber setelah perubahan fungsi. Gunakan juga masukan kosong dan nama yang salah untuk memeriksa batas kontrak. Catatan pengujian sebaiknya menyebutkan pasangan atau daftar yang digunakan, bukan hanya pernyataan umum bahwa urutan terlihat rapi.

Untuk membahas pengembangan katalog bisnis, kunjungi JagoWeb https://www.jagoweb.com/ dan halaman Website Toko Online https://www.jagoweb.com/website-toko-online. Bawa daftar nama yang representatif serta urutan yang Anda inginkan. Tanyakan bagaimana aturan itu diterapkan pada tampilan, pencarian, dan proses pengambilan data yang relevan. Hasil latihan dapat menjadi acuan awal yang terukur, sementara integrasi pada toko nyata tetap memerlukan pemeriksaan jumlah produk, pembagian halaman, dan pengalaman pengguna secara menyeluruh.

Bacaan terkait

Sumber dan referensi

← Kembali ke semua insight
LANJUT BELAJAR

Bekal untuk ide berikutnya.

LANGKAH BERIKUTNYA UNTUK Jagoweb

Ide Anda punya tempat. Kita mulai bareng.

Mulai dari nama domain, website pertama, atau kebutuhan aplikasi. Ceritakan rencana Anda kepada tim Jagoweb.

Temukan pilihan Anda
Tim Jagoweb siap mendiskusikan kebutuhan Jagoweb