Pencarian artikel tanpa API: indeks kecil yang bekerja di browser
Cara merancang pencarian lokal untuk koleksi artikel kecil, dengan ranking sederhana, keluaran aman, dan batas ukuran indeks.

Kebutuhan yang sengaja dibatasi
Pencarian Kawunganten ditujukan untuk koleksi panduan yang kecil, bukan untuk memahami semua pertanyaan seperti asisten percakapan. Indeks dibentuk dari judul, ringkasan, topik, dan teks artikel. Browser mencocokkan kata yang dicari dengan data itu tanpa mengirim permintaan ke API pencarian.
Coba halaman pencarian dengan kata “backup”, “JSON”, atau “tema”. Hasil seharusnya mengarah ke pembahasan yang relevan, bukan membalas dengan jawaban yang dikarang. Ketika tidak ada kecocokan, situs sebaiknya mengatakannya secara jelas.
Satu sumber data untuk isi dan indeks
Indeks dibuat pada saat halaman dibangun, menggunakan sumber artikel yang sama. Dengan begitu, artikel yang dihapus tidak seharusnya tetap muncul sebagai hasil. Judul yang diperbarui juga tidak perlu diedit pada beberapa file yang terpisah.
{
"url": "/backup-website-yang-benar-benar-bisa-dipulihkan/",
"title": "Backup website belum selesai sebelum berhasil dipulihkan",
"topic": "hosting",
"summary": "Memeriksa cadangan kode, konfigurasi, dan data aktif.",
"text": "Isi artikel yang telah dibersihkan dari tag HTML..."
}Struktur di atas adalah ilustrasi satu entri, bukan seluruh indeks situs. Jangan memasukkan email pembaca, draft rahasia, atau data operasional ke indeks yang dikirim ke browser. Apa pun yang ada di dalamnya pada dasarnya menjadi data publik.
Peringkat sederhana yang bisa dijelaskan
Pisahkan kata pencarian, samakan kapitalisasi, lalu cari kecocokan pada beberapa bidang. Judul dan frasa utuh dapat memperoleh bobot lebih tinggi daripada kecocokan yang hanya ada pada tubuh artikel. Untuk beberapa kata, hasil yang memenuhi semuanya biasanya lebih berguna daripada hasil dengan hanya satu kata umum.
Peringkat ini bukan ukuran kualitas universal. Bobot perlu diuji dengan pertanyaan nyata. Jika pencarian “error 401” menempatkan artikel tema Flutter di atas panduan HTTP, periksa indeks dan aturan bobotnya, bukan menambahkan animasi pada daftar hasil.
Dalam uji komponen pencarian versi ini, kata “tema” semula ikut cocok dengan bagian kata “sitemap”. Artikel sitemap lalu muncul lebih tinggi daripada panduan tema Flutter. Perbaikannya adalah mencocokkan batas kata sebelum menghitung bobot. Sesudah perubahan, uji “tema” menempatkan panduan tema Flutter di urutan pertama. Konsekuensinya: potongan kata seperti “tem” tidak dianggap sama dengan kata lengkap.
Jangan menampilkan jumlah hasil yang belum benar-benar dihitung. Batasi panjang input supaya pencarian yang tidak masuk akal tidak membebani browser. Tampilkan status ketika belum ada kata atau hasil kosong, dan sediakan tombol untuk membersihkan pencarian.
Render hasil tanpa mengubah input menjadi HTML
const link = document.createElement('a');
link.href = item.url;
link.textContent = item.title;
container.appendChild(link);Gunakan textContent untuk teks, bukan merangkai input pengguna menjadi innerHTML. Perbedaan keduanya dijelaskan pada MDN [1]. Validasi pula URL hasil terhadap format internal yang diizinkan; teks yang aman tidak membuat skema URL berbahaya menjadi aman.
Jika menambahkan sorotan kata, bangun node teks dan elemen mark secara terkontrol. Jangan mengganti substring pada HTML mentah dengan ekspresi yang berasal langsung dari input. Untuk koleksi kecil, hasil yang bersih tanpa sorotan lebih baik daripada penyorotan yang membuka celah baru.
Ukuran indeks dan privasi tetap punya batas
Indeks yang memuat seluruh teks perlu diunduh. Karena itu, muat hanya pada halaman yang membutuhkan pencarian. Untuk koleksi yang jauh lebih besar, indeks penuh bisa membebani koneksi serta memori dan perlu diganti dengan strategi lain.
Memproses pencarian di browser tidak berarti alamat URL selalu privat. Bila kata pencarian menjadi parameter URL lalu halaman dimuat ulang atau dibagikan, alamat tersebut dapat tercatat pada log hosting. Jangan menempelkan kata sandi atau data sensitif ke kolom pencarian. Penjelasan ini juga dicantumkan dalam kebijakan privasi.
Pencarian lokal ini tidak memakai model bahasa. Menamainya “AI” akan memberi harapan yang tidak sesuai kemampuan. Nama fitur seharusnya menjelaskan apa yang sungguh-sungguh dikerjakannya.
Uji kosong, gagal, dan tanpa JavaScript
Coba huruf besar-kecil, beberapa kata, karakter khusus, input kosong, serta topik yang tidak ada. Uji dengan keyboard dan pastikan perubahan jumlah hasil diumumkan bagi pembaca yang menggunakan teknologi bantu. Jika penyimpanan browser ditolak, pencarian tetap harus bekerja karena tidak memerlukan localStorage.
Tanpa JavaScript, sediakan daftar artikel yang dapat dibuka langsung. Situs tidak harus menyamarkan keterbatasannya. Jalan keluar yang sederhana dan berfungsi lebih baik daripada form pencarian yang tampak aktif tetapi tidak dapat menghasilkan apa pun.
Pencarian yang baik mengurangi jarak dari pertanyaan ke bacaan. Setelah fitur itu bekerja, fokus berikutnya tetap kualitas dan kejelasan artikel yang ditemukan, bukan menambah hasil sebanyak mungkin.
Rujukan untuk memeriksa konsepnya
Dokumentasi resmi dan standar di bawah membantu pembaca meninjau istilah serta langkah teknis. Tautan ini bukan klaim bahwa setiap contoh dalam artikel telah diuji di semua perangkat atau hosting.
- MDN: Array.filter()
Dasar memfilter koleksi artikel pada browser.
Laporkan bagian artikel yang perlu diperbaiki agar redaksi dapat memeriksa informasi dan sumbernya.
Kirim koreksi ke redaksi