PENAWARAN Langkah besar dimulai dari sini. Lihat promo
JAGOWEB INSIGHT

Tutorial Format Harga Rupiah di Website dengan Intl.NumberFormat dan Uji Data

Latih format rupiah memakai Intl.NumberFormat, pisahkan angka dari teks tampilan, lalu uji nilai nol, batas data, dan opsi pecahan sebelum diterapkan pada katalog.

Angka harga dan kalimat harga memiliki tugas berbeda

Kartu produk yang menampilkan harga dengan rapi membantu pembeli membandingkan pilihan. Masalah muncul ketika teks berawalan Rp disimpan kembali sebagai nilai perhitungan, atau pemisah ribuan dianggap sebagai tanda desimal. Tutorial ini mengajak Anda membuat fungsi penyajian sederhana sebelum menyambungkannya ke antarmuka toko. Seluruh latihan berjalan pada berkas lokal dengan harga rekaan. Tidak diperlukan akun toko, koneksi basis data, maupun transaksi pembayaran untuk mengetahui apakah fungsi menerima data yang sesuai.

Bayangkan sebuah katalog menyimpan harga dua belas ribu lima ratus rupiah sebagai angka 12500. Angka itu menjadi bahan perhitungan, sementara kalimat harga dibuat ketika ditampilkan. Pilihan tersebut memudahkan tim meninjau sumber kesalahan: apakah nilai awal sudah salah, atau hanya cara penyajiannya yang berbeda. Contoh tidak menetapkan cara menghitung pajak, diskon, kurs, maupun pembulatan tagihan. Semua keputusan tersebut harus mengikuti aturan bisnis yang dirumuskan terpisah dari latihan pemformatan.

Alur bilangan harga mentah melewati pemeriksaan sebelum menjadi teks rupiah pada kartu produk.
Nilai contoh dipertahankan sebagai angka; format rupiah hanya dibuat pada lapisan penyajian.

Prasyarat dan batas aturan latihan

Siapkan editor teks, terminal, dan Node.js yang menyediakan Intl.NumberFormat serta dukungan locale id-ID. Gunakan folder latihan baru yang tidak berisi data pelanggan. Periksa keberadaan runtime dengan perintah node --version, kemudian simpan berkas dengan ekstensi .mjs agar pemuatan modulnya jelas. Anda juga dapat mempelajari gagasan yang sama di browser, tetapi langkah pelaksanaan di sini memakai Node. Hasil latihan tidak memerlukan pemasangan paket tambahan atau akses jaringan.

Tetapkan kontrak masukan: fungsi hanya menerima tipe Number berupa bilangan bulat aman yang tidak negatif, dalam satuan rupiah. Nol diterima; teks, pecahan, nilai negatif, NaN, dan Infinity ditolak. Kontrak ini sengaja sempit agar mudah diuji. Sistem yang membutuhkan pecahan, nilai pengembalian dana, atau nominal di luar rentang aman perlu rancangan berbeda. Jangan mengubah seluruh data toko menjadi bulat hanya agar dapat melewati contoh ini; sesuaikan model dan aturan dengan kebutuhan nyata.

Pemisahan bagian mata uang, angka, dan pemisah serta daftar masukan yang ditolak fungsi latihan.
Format dan validasi mempunyai tugas berbeda; aturan latihan membatasi harga ke rupiah bulat tidak negatif.

Langkah 1: tentukan locale, mata uang, dan jumlah pecahan

Buat objek formatter dengan locale id-ID, style currency, serta currency IDR. Ketiganya menyatakan bahasa penyajian dan mata uang yang ditampilkan. Tambahkan minimumFractionDigits nol dan maximumFractionDigits nol untuk contoh rupiah bulat. Menuliskan kedua opsi membuat maksud latihan terbaca saat ditinjau rekan kerja. Anda tidak sedang mengonversi mata uang; nominal 12500 tetap mewakili jumlah rupiah yang sama sebelum dan sesudah dipanggil oleh formatter.

Dokumentasi konstruktor MDN menjelaskan pilihan style, currency, dan opsi digit. Spesifikasi ECMA-402 memisahkan konfigurasi digit dari proses penyajian. Karena itu, jangan menyimpulkan bahwa penghilangan pecahan secara visual adalah kebijakan keuangan yang sudah benar. Bila data 12500.5 masuk, fungsi latihan menolaknya sebelum pemformatan. Dengan batas ini, tutorial tidak menyembunyikan pecahan melalui tampilan yang tampak rapi. Tim dapat memutuskan penanganan pecahan dengan bukti sumber data yang terlihat.

Langkah 2: simpan fungsi dan data uji dalam berkas

Salin kode lengkap berikut ke latihan-rupiah.mjs. Fungsi tampilHarga memeriksa Number.isSafeInteger dan tanda nilai sebelum memanggil format. Daftar katalog berisi nol, angka ribuan, dan angka jutaan untuk melihat beberapa bentuk keluaran. Daftar kedua berisi contoh yang sengaja salah. Penanganan galat pada perulangan memungkinkan seluruh contoh diperiksa dalam sekali jalan, tanpa menghentikan terminal pada penolakan pertama. Jangan mengganti daftar tersebut dengan informasi transaksi pelanggan.

Kode latihan lengkap — simpan sebagai latihan-rupiah.mjs:

const rupiah = new Intl.NumberFormat('id-ID', {
  style: 'currency', currency: 'IDR',
  minimumFractionDigits: 0, maximumFractionDigits: 0
});

function tampilHarga(nilai) {
  if (!Number.isSafeInteger(nilai) || nilai < 0) {
    throw new TypeError('Gunakan bilangan bulat rupiah yang aman dan tidak negatif');
  }
  return rupiah.format(nilai);
}

const katalog = [0, 12500, 1500000];
for (const harga of katalog) console.log(harga, '=>', tampilHarga(harga));
console.log('Opsi:', rupiah.resolvedOptions());
console.log('Bagian:', rupiah.formatToParts(12500));

for (const nilai of ['12.500', -1, 12500.5, NaN, Infinity, 9007199254740992]) {
  try { console.log('Uji:', nilai, tampilHarga(nilai)); }
  catch (galat) { console.log('Ditolak:', String(nilai), galat.message); }
}

export {rupiah, tampilHarga, katalog};

Perhatikan bahwa objek formatter dibuat sekali di luar fungsi. Pemisahan tersebut membuat konfigurasi mudah ditemukan dan dipakai berulang untuk daftar harga dengan aturan yang sama. Nilai keluaran fungsi adalah teks, bukan angka baru. Pertahankan harga mentah pada variabel asal dan gunakan teks hanya saat menyajikan informasi. Jika komponen halaman perlu mengurutkan harga, gunakan nilai angka semula. Mengurutkan kalimat harga menurut abjad dapat menghasilkan urutan yang tidak sesuai besar nominal.

Langkah 3: jalankan dan periksa kasus yang diterima

Buka terminal pada folder latihan, lalu jalankan node latihan-rupiah.mjs. Tiga baris awal harus memperlihatkan bahwa nol, 12500, dan 1500000 diterima. Cari penanda rupiah serta kelompok angka yang mudah dibaca pada lingkungan Anda. Untuk nominal ribuan, bagian integer yang digabung kembali harus mewakili 12500. Untuk jutaan, hasil tetap merepresentasikan satu juta lima ratus ribu, bukan angka yang berubah karena pemisah ditafsirkan ulang.

Jangan membuat pemeriksaan portabel yang bergantung pada satu karakter spasi tertentu di antara simbol dan angka. MDN mengingatkan bahwa keluaran format dapat berbeda antarpelaksanaan, termasuk penggunaan spasi yang tidak dapat diputus. Teks terlihat sama belum tentu memiliki susunan karakter identik. Catat hasil aktual beserta versi runtime bila membandingkan komputer pengembang dan server. Pemeriksaan tampilan akhir di browser tetap diperlukan ketika fungsi ini kelak dimasukkan ke komponen katalog.

Langkah 4: baca opsi dan bagian hasil sebagai bukti

Lihat keluaran Opsi dan pastikan currency bernilai IDR, style currency, serta kedua jumlah pecahan bernilai nol. Bagian ini membantu menemukan konfigurasi yang ternyata berbeda dari maksud kode. Sesudah itu, baca keluaran Bagian. formatToParts memecah teks menjadi objek dengan type dan value, misalnya currency, integer, group, atau literal. Urutannya mengikuti format yang dipilih. Gabungan semua value harus menghasilkan teks yang sama dengan pemanggilan format untuk angka yang sama.

Untuk pemeriksaan manual, tandai bagian currency dan semua bagian integer. Jangan memasukkan pemisah group ke perhitungan nominal. Pembacaan bagian berguna ketika desain perlu memberi gaya berbeda pada simbol mata uang, tetapi setiap bagian tetap mempunyai urutan dan konteks. Jangan membuang literal sembarangan hanya untuk mengejar bentuk tertentu. Bila desain membutuhkan penyesuaian lanjutan, uji hasilnya pada ukuran layar dan pembaca layar yang memang dipakai audiens, tanpa menganggap pengujian terminal menggantikan pengujian tersebut.

Langkah 5: pastikan data yang melanggar kontrak ditolak

Periksa enam baris Ditolak. Teks 12.500 ditolak karena fungsi tidak menerima string berformat tampilan, bukan karena formatter tidak memiliki kemampuan menangani string pada kondisi lain. Nilai negatif, pecahan, NaN, Infinity, dan bilangan di luar rentang aman juga harus ditolak. Dengan demikian, kontrak lokal yang Anda susun terlihat dalam hasil. Jika salah satu diterima, baca kembali kondisi penjaga dan pastikan Anda menjalankan berkas yang baru disimpan.

Ubah satu anggota katalog sementara menjadi pecahan, jalankan lagi, lalu amati bahwa pemanggilan tanpa penanganan galat pada daftar utama berhenti dengan kesalahan. Kembalikan daftar seperti semula setelah memahami perilakunya. Percobaan ini mengajarkan bahwa penolakan data harus ditangani oleh aplikasi secara sengaja. Pada antarmuka nyata, tampilkan pesan yang membantu penanggung jawab memperbaiki sumber nominal; jangan menampilkan harga nol sebagai pengganti otomatis karena pembeli dapat mengartikannya sebagai produk gratis.

Kesalahan umum dan verifikasi ulang sebelum integrasi

Kesalahan pertama adalah memberi label IDR pada nominal yang sebenarnya masih dalam satuan lain. Kesalahan berikutnya ialah menghapus semua titik dan koma dari masukan tanpa mengetahui format asalnya. Contoh juga tidak cocok dijadikan kalkulator keuangan dengan angka pecahan hanya dengan menghapus kondisi penjaga. Tetapkan satuan, rentang, dan aturan di batas penerimaan data. Pemformatan menjadi langkah akhir setelah nilai tersebut lolos pemeriksaan, bukan alat untuk menebak maksud masukan yang ambigu.

Ulangi tiga kasus diterima dan enam kasus ditolak sesudah perubahan kode. Simpan contoh hasil, versi runtime, dan keputusan aturan harga agar peninjau memahami konteksnya. Untuk kebutuhan situs bisnis, lihat pilihan layanan di JagoWeb https://www.jagoweb.com/ dan halaman Website Toko Online https://www.jagoweb.com/website-toko-online. Saat berdiskusi dengan pengembang, bawa contoh nominal dan keluaran yang diinginkan. Tanyakan cara aturan penyajian diterapkan pada halaman produk serta keranjang, dengan pemeriksaan perhitungan dan pembayaran sebagai pekerjaan tersendiri.

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