Menulis error message yang jelas, informatif, dan mudah dipahami adalah salah satu aspek terpenting dalam meningkatkan pengalaman pengguna. Banyak aplikasi, website, dan perangkat digital gagal memberikan pesan error yang baik karena hanya menampilkan kalimat teknis, terlalu umum, atau bahkan menakutkan. Padahal, error message yang tepat dapat membantu pengguna memahami situasi, memperbaiki tindakan, dan tetap percaya diri menggunakan aplikasi. Tutorial ini membahas prinsip, contoh, dan praktik terbaik dalam menulis error message yang benar dan jelas.
Mengapa Error Message yang Baik Sangat Penting
Pesan error bukan sekadar pemberitahuan bahwa sesuatu tidak berjalan sebagaimana mestinya. Error message merupakan bagian dari komunikasi antara sistem dan pengguna. Pesan yang baik dapat:
-
Mengurangi frustrasi pengguna
-
Meningkatkan kepercayaan pada sistem
-
Mempercepat proses penyelesaian masalah
-
Mengurangi permintaan bantuan ke customer support
-
Menambah kesan profesional pada aplikasi
Sebaliknya, pesan yang buruk sering membuat pengguna bingung, salah langkah, atau merasa aplikasi rusak.
Karakter Utama Error Message yang Efektif
Sebelum membahas contoh, penting memahami karakter utama pesan error yang baik:
a. Jelas
Pengguna harus langsung tahu apa yang sedang terjadi tanpa berpikir keras.
b. Spesifik
Hindari pesan generik seperti “Terjadi kesalahan”. Berikan konteks.
c. Solutif
Beritahu apa yang harus dilakukan selanjutnya.
d. Ramah
Nada yang terlalu teknis atau menyalahkan pengguna harus dihindari.
e. Singkat
Pesan error bukan tempat untuk ceramah panjang. Harus padat tapi cukup informatif.
Kesalahan Umum dalam Menulis Error Message
Banyak error message dibuat dengan pola yang keliru. Berikut adalah kesalahan yang paling sering terjadi:
1. Terlalu teknis
Contoh: “Unhandled exception in module x86.dll at memory offset 9B23A”
Pengguna biasa tidak akan mengerti.
2. Menyalahkan pengguna
Contoh: “Anda salah memasukkan data!”
Ini membuat pengguna merasa bodoh.
3. Tidak memberikan solusi
Contoh: “Login gagal.”
Pengguna bingung harus melakukan apa.
4. Terlalu generik
Contoh: “Something went wrong.”
Tidak ada konteks apa pun.
5. Nada emosional atau dramatis
Contoh: “Oops! Kami panik karena kesalahan fatal telah terjadi!”
Terdengar tidak profesional.
Struktur Dasar Error Message yang Baik
Agar mudah dipahami, idealnya pesan error memiliki tiga komponen:
-
Apa yang terjadi
-
Kenapa itu terjadi (opsional)
-
Apa yang harus dilakukan pengguna selanjutnya
Dengan struktur ini, pengguna tidak hanya tahu masalahnya, tetapi juga langkah yang harus diambil.
Contoh Penulisan Error Message yang Buruk vs Baik
Form Login
❌ “Login gagal.”
✔️ “Email atau kata sandi salah. Coba periksa kembali data yang Anda masukkan.”
Form Pembayaran
❌ “Payment error.”
✔️ “Pembayaran tidak dapat diproses. Pastikan saldo mencukupi atau coba metode lain.”
Upload File
❌ “File rejected.”
✔️ “Ukuran file melebihi batas 5MB. Kompres file lalu coba lagi.”
Halaman Tidak Ditemukan
❌ “404 Not Found.”
✔️ “Halaman yang Anda cari tidak tersedia. Periksa URL atau kembali ke halaman utama.”
Timeout
❌ “Timeout.”
✔️ “Proses membutuhkan waktu lebih lama dari biasanya. Coba muat ulang halaman.”
Setiap contoh yang baik memberikan konteks dan solusi langsung.
Prinsip UX dalam Menulis Error Message
Error message adalah bagian dari desain UX, bukan sekadar teks teknis. Berikut prinsip-prinsip pentingnya:
a. Gunakan Bahasa Pengguna, Bukan Bahasa Developer
Kalimat seperti “server return status code 500” mungkin jelas bagi developer, tetapi tidak untuk pengguna non-teknis.
Gantilah dengan:
“Terjadi gangguan pada server. Coba lagi dalam beberapa saat.”
b. Tunjukkan Lokasi Kesalahan
Untuk form panjang, beri tahu tepat di mana kesalahan terjadi.
Contoh:
“Nomor telepon harus berisi 10–13 digit.” (letakkan di bawah input)
c. Beri Saran Solusi yang Realistis
Jangan hanya mengatakan “coba lagi nanti” jika pengguna bisa memperbaikinya sendiri sekarang.
d. Hindari Nada Menyudutkan
Gunakan kalimat netral seperti:
“Data tidak valid”
bukan
“Anda memasukkan data yang salah.”
e. Gunakan Warna yang Konsisten
Biasakan error ditandai dengan:
-
Warna merah (#ef4444)
-
Ikon alert (⚠)
-
Teks kecil di bawah input
Konsistensi warna akan membuat pengguna cepat mengenali konteks.
Kapan Harus Menampilkan Detail Teknis?
Detail teknis tidak untuk ditampilkan ke pengguna umum, tetapi tetap penting untuk debugging. Maka solusi terbaik:
-
Pengguna akhir (UI) → Pesan yang ringkas dan solutif
-
Tim teknis (log system) → Detail error yang lengkap
Contoh tampilan ideal:
UI pengguna:
“Terjadi kesalahan saat memproses permintaan Anda. Coba lagi dalam beberapa detik.”
Log internal:Error: SQLSTATE[23000] Integrity constraint violation – duplicate entry on users.email
Dengan begitu pengalaman pengguna tetap terjaga, sementara tim tetap punya informasi lengkap.
Menambahkan Humor? Boleh, Tapi Hati-Hati
Humor bisa membuat error terasa lebih ringan, tetapi jangan berlebihan atau mengganggu proses kerja.
Contoh humor yang aman:
“Oops! Sepertinya jaringan sedang ngopi dulu. Coba lagi sebentar.”
Contoh humor yang buruk:
“Yah, aplikasi kita meledak. Maaf ya!”
Terlalu dramatis dan tidak profesional.
Gunakan humor hanya pada konteks yang santai, seperti blog atau website hiburan, bukan aplikasi perbankan atau e-commerce.
Membuat Error Message Khusus untuk Mobile
Pengguna mobile cenderung:
-
Tidak sabar
-
Menggunakan layar kecil
-
Mengandalkan gesture cepat
-
Sering berada di tempat dengan internet tidak stabil
Maka error message harus:
-
Lebih pendek
-
Ditempatkan di area mudah dilihat
-
Disertai tombol aksi jelas (misalnya “Coba Lagi”)
Contoh:
“Koneksi terputus. Ketuk untuk mencoba lagi.”
Cek Error Message dari Sudut Pandang Pengguna
Sebelum final, tanyakan:
-
Apakah user langsung tahu masalahnya?
-
Apakah dia tahu langkah berikutnya?
-
Apakah bahasanya mudah?
-
Apakah tone-nya sopan dan profesional?
Jika semua “ya”, maka error message sudah tepat.
Kesimpulan
Menulis error message yang membantu bukan hanya soal menyampaikan bahwa terjadi kesalahan, tetapi bagaimana memberikan penjelasan yang jelas, ramah, dan memberi solusi agar pengguna dapat melanjutkan aktivitas tanpa frustrasi. Dengan memahami prinsip-prinsip dasar seperti kejelasan, spesifikasi, nada netral, dan orientasi solusi, setiap aplikasi dapat memberikan pengalaman yang jauh lebih baik.
Dengan menerapkan praktik terbaik ini, kamu tidak hanya membuat pesan error yang informatif tetapi juga memperkuat profesionalitas aplikasi secara keseluruhan.