PENAWARAN Langkah besar dimulai dari sini. Lihat promo
JAGOWEB INSIGHT

Tutorial Menghitung Grapheme Teks Produk dengan Intl.Segmenter di Node.js

Bandingkan unit UTF-16, titik kode, dan grapheme pada teks produk. Jalankan contoh Node.js lokal lalu uji huruf gabungan, bendera, serta emoji keluarga.

Mengapa angka panjang teks dapat berbeda

Pengelola katalog sering meminta batas karakter untuk nama atau ringkasan produk. Sebelum menambahkan penghitung, tentukan dahulu apa yang dihitung. Pada JavaScript, panjang string tidak selalu sama dengan jumlah bentuk karakter yang dipahami pembaca. Huruf dengan tanda gabungan dan sejumlah emoji dapat tersusun dari beberapa bagian. Jika istilah karakter dibiarkan kabur, editor dapat melihat satu bentuk di layar sementara aplikasi melaporkan angka yang lebih besar, lalu mengira ada masalah pada datanya.

Tutorial ini membuat laporan tiga ukuran dari string yang sama: unit UTF-16, titik kode Unicode, dan grapheme. Hasilnya membantu pengembang serta pengelola konten menyepakati arti penghitung sebelum menggunakannya pada formulir. Contoh berjalan secara lokal dengan bahan rekaan. Tidak ada ringkasan yang dipotong atau dikirim ke website. Latihan berfokus pada pembuktian unit hitung, sehingga keputusan tentang batas konten dapat dibuat berdasarkan kebutuhan nyata, bukan kebiasaan memakai properti panjang tanpa meninjau artinya.

Teks e dengan aksen gabungan dibandingkan melalui dua unit UTF-16, dua titik kode, dan satu grapheme.
Satu bentuk huruf yang tampak utuh dapat tersusun dari lebih dari satu bagian pada representasi teks.

Prasyarat dan kontrak data latihan

Siapkan Node.js yang menyediakan Intl.Segmenter, editor teks UTF-8, serta folder latihan terpisah. Periksa versi melalui node --version dan catat hasilnya. Kemampuan tersebut harus diperiksa pada lingkungan yang benar-benar menjalankan kode; jangan menyimpulkan semua server mendukungnya hanya karena contoh berhasil di laptop. Skrip berikut berhenti dengan pesan yang jelas jika Segmenter tidak tersedia. Ia tidak memasang paket, mengganti versi runtime, atau mengubah pengaturan aplikasi Anda.

Masukan fungsi harus berupa string primitif. Angka, objek, dan nilai null sengaja ditolak agar tidak diubah diam-diam menjadi teks yang mungkin berbeda dari maksud pengelola. String kosong tetap sah dan menghasilkan nol. Spasi, baris baru, tanda baca, serta ejaan asli dipertahankan. Catat kontrak ini sebelum menghubungkannya dengan formulir produk. Jika bisnis ingin mengabaikan spasi tepi, perlakukan itu sebagai aturan penyuntingan terpisah yang dijelaskan dan diuji, bukan perubahan tersembunyi di dalam penghitung.

Teks asli masuk ke Segmenter, menghasilkan daftar segmen yang dapat digabung kembali dan hitungan untuk laporan.
Pemeriksaan menghitung segmen tanpa memotong, memangkas spasi, atau mengganti isi teks produk.

Langkah 1: bedakan tiga unit pengukuran

MDN menjelaskan bahwa properti length pada string JavaScript menghitung unit UTF-16. Iterasi string melalui bentuk sebar dapat menghitung titik kode, tetapi titik kode pun belum selalu sama dengan grapheme. Sebuah bendera dapat dibentuk oleh dua titik kode, sedangkan rangkaian emoji keluarga memuat beberapa karakter penghubung. Perbedaan ini bukan bukti teks rusak. Setiap ukuran menjawab pertanyaan yang berbeda tentang representasi string yang sedang diproses.

Untuk pembanding sederhana, gunakan Toko yang menghasilkan empat pada ketiga ukuran. Kemudian gunakan huruf e diikuti tanda aksen gabungan. Contoh tersebut menghasilkan dua unit UTF-16, dua titik kode, dan satu grapheme. Bentuk gabungan ini berguna karena perbedaannya dapat diuji tanpa bergantung pada kalimat panjang. Catat angka beserta nama unitnya di laporan; menyimpan angka saja akan menyulitkan orang lain memahami apakah yang dibandingkan benar-benar ukuran yang setara.

Langkah 2: simpan kode dan pilih granularity

Simpan kode lengkap berikut sebagai latihan-grapheme.mjs. Konstruktor dibuat dengan locale id-ID dan granularity grapheme. Metode segment mengembalikan objek yang dapat diiterasi, kemudian Array.from mengambil properti segment menjadi daftar string. Daftar tersebut dipakai untuk menghitung jumlah grapheme sekaligus melihat pembagian yang dihasilkan. Kode tidak menormalkan atau mengubah huruf, sehingga isi masukan dapat dibandingkan kembali dengan gabungan semua segmennya setelah pemeriksaan selesai.

Kode latihan lengkap — simpan sebagai latihan-grapheme.mjs: import {pathToFileURL} from 'node:url';

if (typeof Intl.Segmenter !== 'function') {
  throw new Error('Lingkungan ini belum menyediakan Intl.Segmenter.');
}
const segmenter = new Intl.Segmenter('id-ID', {granularity: 'grapheme'});
export function analisisTeks(teks) {
  if (typeof teks !== 'string') throw new TypeError('Masukan harus string.');
  const segmen = Array.from(segmenter.segment(teks), item => item.segment);
  return {
    teks,
    unitUTF16: teks.length,
    titikKode: [...teks].length,
    grapheme: segmen.length,
    segmen
  };
}
if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
  const contoh = ['', 'Toko', 'e\u0301', '\u{1F1EE}\u{1F1E9}',
    '\u{1F468}\u200D\u{1F469}\u200D\u{1F467}\u200D\u{1F466}'];
  console.log(JSON.stringify(contoh.map(analisisTeks), null, 2));
}

Bagian contoh memakai penulisan escape Unicode agar urutan karakter gabungan dapat disalin dengan tepat. Escape itu menjadi karakter ketika JavaScript membaca string; ia bukan rangkaian huruf yang dihitung secara harfiah sebagai nama kode. Gunakan kode utuh terlebih dahulu. Setelah memahami hasil dasar, Anda dapat menambahkan string latihan lain pada daftar contoh, dengan tetap mempertahankan pembanding yang diketahui hasilnya supaya perubahan perilaku tidak terlewat ketika sumber data diperluas.

Langkah 3: jalankan dan cocokkan keluaran

Buka terminal pada folder latihan lalu jalankan node latihan-grapheme.mjs. Keluaran JSON menampilkan teks asli, tiga hitungan, dan daftar segmen. Untuk string kosong, ketiga hitungan harus nol dan daftar segmen kosong. Untuk Toko, ketiganya empat. Jika hasil berbeda, periksa apakah file yang dijalankan sama dengan file yang baru disimpan, apakah encoding benar, dan apakah contoh sudah diubah. Jangan melanjutkan penilaian terhadap nama produk nyata sebelum pembanding sederhana sesuai.

Pada contoh huruf beraksen gabungan, pastikan segmen berisi satu string yang tetap menyimpan dua titik kode asal. Penghitungan tidak mengharuskan teks diubah menjadi bentuk penyimpanan lain. Jika terminal menggambar aksen dengan posisi kurang baik, baca juga angka dan sumber latihan, bukan hanya bentuk yang terlihat. Tampilan font terminal dapat berbeda dari browser, sedangkan tujuan langkah ini adalah memeriksa pembagian string yang dihasilkan oleh lingkungan Node.js yang Anda catat.

Langkah 4: uji bendera dan emoji berangkai

Contoh bendera Indonesia menghasilkan empat unit UTF-16, dua titik kode, dan satu grapheme. Contoh keluarga pada kode menghasilkan sebelas unit UTF-16, tujuh titik kode, dan satu grapheme. Periksa ketiga angka pada keluaran, bukan hanya jumlah segmennya. Tambahkan huruf biasa setelah salah satu contoh dan pastikan hitungan grapheme bertambah satu. Percobaan pembanding ini menunjukkan bahwa fungsi tetap menghitung bagian teks lain, bukan sekadar mengenali seluruh masukan sebagai satu simbol.

Uji pula satu spasi di tengah dua huruf, tanda baca, dan baris baru. Catat bahwa contoh tidak membuang bagian tersebut sebelum menghitung. Untuk verifikasi sederhana, gabungkan daftar segmen dengan pemisah kosong lalu cocokkan dengan teks asal. Isi yang pulih harus sama persis. Jika Anda kelak membuat fitur pemotongan, pengujian itu menjadi pekerjaan baru dengan aturan tambahan; hasil hitungan saja belum memastikan ringkasan hasil potongan tetap jelas secara bahasa atau sesuai tujuan halaman produk.

Langkah 5: sepakati penggunaan hasil pada website

Bawa laporan contoh kepada orang yang menetapkan batas konten. Jelaskan bahwa grapheme berguna untuk menyatakan unit teks yang lebih dekat dengan karakter yang dipersepsi pengguna, tetapi bukan pengukur lebar visual. Dua nama dengan jumlah grapheme sama dapat mengambil ruang berbeda karena bentuk huruf, font, ukuran, dan tata letak. Penghitung juga tidak menetapkan batas byte penyimpanan atau panjang keluaran layanan lain. Masing-masing perlu diuji dengan satuan yang memang dipakai oleh sistem tersebut.

Jika penghitung akan dipasang di editor, samakan penjelasan dan aturan pada sisi aplikasi yang terkait. Jangan mengganti validasi server hanya berdasarkan demonstrasi lokal. Tentukan pula bagaimana hasil diperiksa ketika lingkungan runtime diperbarui atau data berisi rangkaian Unicode yang lebih baru. Simpan daftar kasus pembanding beserta versi lingkungan agar tim mempunyai dasar saat menilai perubahan. Kebijakan teks yang dipahami bersama lebih membantu daripada angka batas yang terlihat tegas tetapi satuannya berbeda di setiap lapisan.

Kesalahan umum dan verifikasi ulang

Kesalahan umum adalah menyebut length sebagai jumlah karakter terlihat untuk semua masukan, menyamakan titik kode dengan grapheme, atau mengganti granularity menjadi word tetapi tetap memakai label karakter. Kesalahan lain ialah menganggap hitungan membuktikan teks pasti muat dalam satu baris. Ulangi contoh kosong, huruf biasa, aksen gabungan, bendera, dan keluarga setelah perubahan kode. Uji penolakan data yang bukan string pada fungsi agar masalah sumber data terlihat sejak awal, bukan tersamarkan oleh konversi otomatis.

Untuk membahas pengelolaan katalog, kunjungi JagoWeb https://www.jagoweb.com/ serta halaman Website Toko Online https://www.jagoweb.com/website-toko-online. Bawa contoh nama dan ringkasan produk yang mewakili kebutuhan Anda beserta laporan unit hitungnya. Diskusikan perilaku editor yang diinginkan tanpa menganggap penghitung tertentu sudah tersedia pada setiap paket. Hasil latihan dapat menjadi bahan permintaan yang konkret: unit apa yang dihitung, data apa yang diterima, dan bukti apa yang harus cocok sebelum fitur digunakan oleh tim konten.

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