Gunakan validasi formulir HTML native untuk memberi umpan balik langsung, lalu validasi ulang setiap input di API sebelum diproses atau disimpan. Pendekatan yang kembali mengandalkan kemampuan bawaan browser mengurangi JavaScript khusus untuk pemeriksaan sederhana, tetapi browser tetap berada di sisi pengguna dan dapat dilewati.

Referensi seperti pengalaman berhenti melawan browser mengingatkan bahwa fitur native sering cukup untuk kebutuhan antarmuka umum. Prinsipnya bukan menyerahkan kontrak data kepada browser, melainkan memakai browser untuk UX dan API untuk menegakkan aturan.

Bagi tanggung jawab antara formulir dan API

Browser dapat memeriksa kondisi dasar sebelum formulir dikirim, seperti nilai wajib, format email, rentang angka, atau panjang teks. Pengguna mendapat umpan balik tanpa menunggu permintaan jaringan. Atribut HTML juga membuat aturan terlihat pada markup dan dapat berfungsi tanpa JavaScript khusus.

API harus tetap memeriksa input karena klien dapat mengirim permintaan langsung, mengubah HTML, menonaktifkan validasi, atau memakai aplikasi lain. Validasi server juga menangani aturan yang bergantung pada data terbaru atau konteks bisnis, misalnya alamat email yang sudah digunakan, hak akses, atau ketersediaan stok.

  • Formulir HTML: pemeriksaan dasar dan umpan balik segera.
  • API: validasi tepercaya, aturan bisnis, otorisasi, dan perlindungan integritas data.
  • Basis data: kendala integritas yang harus tetap benar pada tingkat penyimpanan, seperti keunikan atau nilai wajib, bila sesuai.

Gunakan atribut HTML native untuk batas yang sederhana

Contoh berikut memanfaatkan atribut bawaan tanpa menambahkan pemeriksaan JavaScript untuk aturan yang sama:

<form action="/api/accounts" method="post">
  <label for="email">Email</label>
  <input id="email" name="email" type="email" required autocomplete="email">

  <label for="password">Kata sandi</label>
  <input id="password" name="password" type="password"
         required minlength="12" autocomplete="new-password">

  <button type="submit">Buat akun</button>
</form>

required menolak nilai kosong, type="email" memeriksa bentuk dasar alamat, dan minlength menetapkan panjang minimum. Pemeriksaan format email browser tidak membuktikan bahwa alamat tersebut benar-benar ada atau dapat menerima pesan. Karena itu, API perlu menerapkan aturan yang sama bila aturan tersebut merupakan kontrak, lalu menangani verifikasi alamat secara terpisah bila diperlukan.

Jaga keselarasan aturan yang terlihat. Jika browser mensyaratkan panjang minimum 12 karakter, API sebaiknya tidak menolak kata sandi yang lebih pendek dengan batas berbeda tanpa alasan yang jelas. Namun, jangan menyalin setiap detail validasi browser secara membabi buta: server tetap menjadi sumber kebenaran dan perlu mempertimbangkan batas ukuran, normalisasi, serta aturan bisnisnya sendiri.

Rancang respons error API yang konsisten dan dapat dipetakan

Klien perlu mengetahui apakah permintaan gagal secara umum atau karena field tertentu. Gunakan format stabil dengan kode error, pesan umum, dan daftar error per field. Contoh ini memakai nama field sebagai kunci agar formulir dapat mengaitkan pesan ke kontrol yang sesuai:

{
  "error": {
    "code": "VALIDATION_FAILED",
    "message": "Periksa kembali data yang dikirim.",
    "fields": {
      "email": ["Alamat email sudah digunakan."],
      "password": ["Kata sandi harus memenuhi kebijakan akun."]
    }
  }
}

Klien dapat menampilkan pesan pada field yang cocok dan pesan umum untuk error yang tidak terkait field. Pertahankan bentuk respons yang sama untuk semua endpoint yang mengikuti kontrak ini. Tetapkan pula status HTTP yang sesuai dan dokumentasikan formatnya; klien tidak seharusnya menebak struktur error dari teks pesan.

Gunakan nama field yang konsisten antara name pada HTML dan kunci respons API, atau sediakan pemetaan eksplisit bila nama model berbeda. Jangan mengirim detail internal, kueri, stack trace, atau informasi yang dapat membantu penyerang. Pesan untuk pengguna sebaiknya spesifik secukupnya tanpa membocorkan data sensitif.

Tangani input yang lolos di browser tetapi ditolak server

Validasi browser tidak menjamin API menerima permintaan. Respons server dapat menolak input karena aturan bisnis berubah, nilai unik telah dipakai pengguna lain, atau klien melewati pemeriksaan. Perlakukan penolakan validasi sebagai alur normal, bukan sebagai kegagalan jaringan.

  1. Periksa status dan format respons API.
  2. Petakan setiap entri fields ke kontrol berdasarkan nama field.
  3. Tampilkan pesan di dekat kontrol dan sediakan ringkasan error yang dapat ditemukan.
  4. Pertahankan nilai yang aman agar pengguna tidak perlu mengisi ulang seluruh formulir.
  5. Untuk error yang tidak cocok dengan field, tampilkan pesan umum; jangan mengabaikan respons.

Bedakan error validasi dari gangguan jaringan atau error server. Jika respons tidak memiliki format yang diharapkan, tampilkan pesan umum dan catat informasi diagnostik di sisi klien atau server tanpa mencatat kata sandi maupun data sensitif. Jangan menganggap semua respons gagal sebagai kesalahan input.

Aksesibilitas: jangan hanya mengandalkan pesan visual

Setiap kontrol perlu memiliki label yang jelas. Saat API menolak field, tampilkan pesan teks yang terhubung dengan kontrol, tandai kondisi invalid, dan pastikan pesan dapat diketahui teknologi bantu. Contoh pola markup untuk field yang ditolak:

<label for="email">Email</label>
<input id="email" name="email" type="email" required
       aria-invalid="true" aria-describedby="email-error">
<p id="email-error">Alamat email sudah digunakan.</p>

Atur aria-invalid sesuai keadaan aktual dan hapus atau perbarui pesan saat field diperbaiki. Setelah pengiriman gagal, pertimbangkan memindahkan fokus ke ringkasan error atau field invalid pertama agar pengguna keyboard dapat menemukan masalah. Jangan mengandalkan warna saja untuk menandai error.

Validasi native dapat menampilkan pesan browser, tetapi tampilan dan pengumumannya berbeda antarbrowser. Jika antarmuka mengganti perilaku native dengan validasi khusus, tanggung jawab untuk memberi pesan yang terhubung, dapat diakses, dan mudah ditemukan beralih ke aplikasi.

Uji kontrak dari browser hingga API

Pengujian perlu memastikan aturan penting tidak hanya ada di satu sisi. Uji formulir untuk kondisi dasar dan uji API secara langsung dengan input yang tidak valid, tanpa bergantung pada browser untuk memblokir permintaan.

  • Uji HTML: field wajib kosong, format dasar yang salah, dan batas panjang. Pastikan pesan dapat ditemukan dan alur keyboard tetap berfungsi.
  • Uji API: kirim payload invalid langsung, termasuk nilai yang sengaja melewati pemeriksaan klien. Pastikan API menolak input dan mengembalikan struktur error yang terdokumentasi.
  • Uji pemetaan: verifikasi setiap kunci fields cocok dengan field yang benar dan error umum tampil bila tidak ada kunci yang cocok.
  • Uji aturan bisnis: simulasikan konflik atau perubahan data yang hanya dapat diketahui server, seperti email yang sudah digunakan.
  • Uji konsistensi: bandingkan batas yang terlihat di formulir dengan aturan API agar pengguna tidak menerima kejutan yang sebenarnya dapat dicegah.

Jika aturan berubah, perbarui kontrak API, validasi server, dan batas HTML yang relevan dalam perubahan yang sama. Browser mempercepat umpan balik; API tetap menentukan apakah data dapat diterima. Gunakan masing-masing untuk tanggung jawab yang tepat.