أمثلة رسائل الخطأ: السيئ والجيد والرائع بعد إعادة الكتابة
ثماني رسائل خطأ صعدنا بها من رمز خام إلى نص يستطيع الناس التصرف بناءً عليه. شرح لكل درجة، والصيغة ذات الأسطر الثلاثة وراء الرسائل الرائعة، وقائمة تحقق لمراجعتك القادمة.
تخبر رسالة الخطأ الرائعة الناس بثلاثة أشياء: ماذا حدث، ولماذا حدث، وماذا يفعلون بعد ذلك، مع زر ينفذ ذلك. معظم المنتجات تتوقف عند الأول، وكثير منها لا يتجاوز الرمز. فيما يلي ثماني رسائل خطأ صعدنا بها من السيئ إلى الرائع، مع سبب كل درجة، وصيغة تستطيع استخدامها في الرسالة القادمة التي تكتبها.
ما الذي يتغير من السيئ إلى الرائع
سيئة
رائعة
الرسالة السيئة مكتوبة للخادم. رمز 403 حالة حقيقية ودقيقة، لكن القارئ لا يتعلم منها شيئا يستفيد منه. أما الرسالة الرائعة فمكتوبة للإنسان: تسمّي الملف، وتشرح أنه خاص، وتذكر من يستطيع فتحه، وتحوّل الخطوة التالية إلى نقرة واحدة.
كل درجة تضيف شيئا واحدا:
| الدرجة | ماذا تعطي الناس | ماذا تتركه ناقصا |
|---|---|---|
| سيئة | رمز أو كلمة غامضة مثل "فشل" | ماذا حدث، ولماذا، وماذا يفعلون |
| جيدة | ماذا حدث، بكلمات بسيطة | لماذا، وماذا يفعلون بعد ذلك |
| رائعة | ماذا حدث، ولماذا، والخطوة التالية على زر | لا شيء يحتاجون إلى تقديره |
1. لا صلاحية وصول
سيئة
Error 403.
رمز حالة. صحيح للمطور، وفارغ للجميع غيره.جيدة
ليس لديك صلاحية الوصول إلى هذا الملف.
تقول ما حدث بكلمات القارئ. لكنها تتركه عالقا.رائعة
هذا الملف خاص. اطلب من سام صلاحية الوصول وسنخبرك حين تصبح لك.
تقول لماذا (إنه خاص)، ومن يستطيع الحل (سام)، وماذا يحدث بعد ذلك. الزر هو طلب الوصول، فيصبح الطلب نقرة واحدة.
يعني 403 أن الشخص مسجّل الدخول لكنه بلا صلاحية. هذا الفرق مهم للنص: لا يحتاجون إلى تسجيل الدخول مجددا، بل إلى من يشارك الملف معهم.
2. بطاقة مرفوضة
سيئة
فشلت المعاملة.
"فشلت" بلا فاعل. هل هي البطاقة أم المتجر أم الاتصال؟جيدة
تم رفض بطاقتك.
تسمّي السبب الذي يستطيع الناس التصرف حياله.رائعة
تم رفض بطاقتك. بنكك رفض العملية. جرّب بطاقة أخرى، أو اطلب من بنكك الموافقة عليها.
تضع المشكلة عند البنك لا عند الشخص، وتعطي مخرجين. الزر هو استخدام بطاقة أخرى، وهو الأسرع.
أخطاء الدفع تحمل أكبر قدر من المال وأكبر قدر من الإحراج. لا تلُم أحدا، وأبقِ المخرج في الشاشة نفسها.
3. ملف كبير جدا
سيئة
خطأ في الرفع.
قد يعني أي شيء، فيعيد الناس رفع الملف نفسه ويصطدمون بالحائط نفسه.جيدة
هذا الملف كبير جدا.
السبب، لكن دون مقدار الزيادة.رائعة
حجم هذا الفيديو 2.4 GB. والحد الأقصى 2 GB. قصّه قليلا وحاول مجددا.
الرقمان معا، فيرى الناس أن الفرق صغير. الزر هو قص الفيديو، فيحل المشكلة دون مغادرة التطبيق.
حين يكون هناك حد، اذكر الحد. لا يستطيع الناس إصلاح رقم لم يُخبَروا به.
4. انقطاع الاتصال
سيئة
خطأ في الشبكة.
تبدو كأن شيئا انكسر، وربما كأن العمل ضاع.جيدة
أنت غير متصل.
بسيطة، لكن أول قلق في رأس أي شخص هو "هل ضاعت تغييراتي؟"رائعة
أنت غير متصل. تغييراتك محفوظة على هذا الهاتف وستتزامن عند عودتك.
تجيب عن القلق قبل أن يُطرح. الزر هو حاول مجددا.
5. تسجيل الخروج
سيئة
Error 401: Unauthorized.
"Unauthorized" تُقرأ كاتهام، وهي رمز مرة أخرى.جيدة
انتهت جلستك.
دقيقة، لكن "الجلسة" كلمة مطورين.رائعة
تم تسجيل خروجك. مرّت 30 يوما. سجّل الدخول مجددا وسنعيدك إلى هنا.
تشرح السبب وتعد الناس بألا يفقدوا مكانهم. الزر هو تسجيل الدخول.
رمز 401 عكس 403: الشخص غير مسجّل الدخول، أو انتهى تسجيل دخوله. إرساله إلى شاشة الدخول هو الحل، وقول إنه سيعود إلى حيث كان يزيل سبب التردد.
ثلاث أخرى بكتابة جديدة
القواعد نفسها تنطبق على مواقف لم تغطها الخمسة السابقة. هذه الأمثلة الثلاثة من عندنا.
سيئة
Error 500. حدث خطأ ما.
الرمز لا يضيف شيئا، و"ما" اعتراف بأننا لا نعرف.جيدة
تعذر علينا حفظ تغييراتك.
تتحمل المسؤولية وتسمّي ما فشل.رائعة
تعذر علينا حفظ تغييراتك. الخطأ من جهتنا لا من جهتك. نصّك ما زال هنا، فحاول مجددا بعد دقيقة.
تقول من المخطئ وأن شيئا لم يضع. الزر هو احفظ مجددا.
سيئة
Too many requests.
لغة آلة لشخص ربما أصبح منزعجا أصلا.جيدة
محاولات كثيرة جدا. حاول لاحقا.
واضحة، لكن "لاحقا" قد تعني دقيقة أو يوما.رائعة
محاولات كثيرة جدا. لأجل أمانك، تم إيقاف تسجيل الدخول 15 دقيقة. يمكنك إعادة تعيين كلمة المرور الآن بدلا من ذلك.
تعطي مدة الانتظار والسبب وطريقا أسرع. الزر هو إعادة تعيين كلمة المرور.
سيئة
رابط غير صالح.
توحي بأن الشخص كتب شيئا خاطئا.جيدة
انتهت صلاحية هذه الدعوة.
السبب الحقيقي، دون لوم.رائعة
انتهت صلاحية هذه الدعوة. تستمر الدعوات 7 أيام. اطلب من مايا إرسال دعوة جديدة.
تقول لماذا تنتهي صلاحية الروابط ومن يستطيع الإصلاح. الزر هو اطلب دعوة جديدة.
الصيغة: ماذا حدث، ولماذا، وماذا تفعل بعد ذلك
كل رسالة رائعة أعلاه تناسب الأسطر الثلاثة نفسها:
[What happened, in the reader's words.]
[Why, in one short sentence.]
[What to do next.] [Button: the next step as a verb]
| الرسالة | ماذا حدث | لماذا | ماذا تفعل بعد ذلك |
|---|---|---|---|
| لا صلاحية وصول | هذا الملف خاص | المدعوون فقط يستطيعون فتحه | طلب الوصول |
| بطاقة مرفوضة | تم رفض بطاقتك | بنكك رفض العملية | استخدام بطاقة أخرى |
| ملف كبير | حجم هذا الفيديو 2.4 GB | الحد الأقصى 2 GB | قص الفيديو |
| بلا اتصال | أنت غير متصل | التغييرات محفوظة على هذا الهاتف | حاول مجددا |
| تسجيل خروج | تم تسجيل خروجك | مرّت 30 يوما | تسجيل الدخول |
سطر "لماذا" هو أول ما تحذفه الفرق، وهو الذي يمنع تذكرة الدعم القادمة.
قائمة تحقق لمراجعتك القادمة
- لا رموز خام. أبقِ 403 و401 و500 في السجلات، بعيدا عن الرسالة.
- لا لوم. "بنكك رفض العملية"، لا "أدخلت بطاقة غير صالحة".
- اذكر الأرقام. حد الحجم، مدة الانتظار، عدد الأيام.
- زر واحد، باسم فعل. "قص الفيديو"، لا "موافق".
- قل ما تم الاحتفاظ به. إن لم يضع شيء، قل ذلك.
- لا تؤكد وجود الحسابات عند الدخول. "كلمة مرور خاطئة" تخبر الغريب أن الحساب موجود. قل بدلا من ذلك "البريد وكلمة المرور غير متطابقين".
- ثم افحص اللون. الكلمات تحمل الخطأ، واللون والأيقونة يدعمانها. ورقتنا عن لون رسالة الخطأ فيها درجات الأحمر للوضعين الفاتح والداكن.
ورقة
لون رسالة الخطأ: 8 درجات حمراء بدلا من #FF0000
الورقة الشقيقة لهذه: الكلمات هنا، والألوان والأيقونات والكود هناك.
الأسئلة الشائعة
كيف تكتب رسالة خطأ جيدة؟
قل ما حدث بكلمات بسيطة، ولماذا حدث في جملة قصيرة واحدة، وماذا تفعل بعد ذلك. ضع الخطوة التالية على زر باسم فعل، مثل حاول مجددا أو استخدام بطاقة أخرى.
ما أمثلة رسائل الخطأ السيئة؟
الرموز الخام والكلمات الغامضة: "Error 403" و"Error 401: Unauthorized" و"فشلت المعاملة" و"خطأ في الرفع" و"خطأ في الشبكة". كلها دقيقة ولا تخبر الناس ماذا يفعلون.
هل يجب أن تعرض رسائل الخطأ رموز الأخطاء؟
ليس كرسالة. الرمز يفيد الدعم والمطورين، فأبقِه في السجلات أو في نص صغير تحت الرسالة الحقيقية إن طلب فريق الدعم ذلك.
ما الفرق بين رسالة الخطأ 401 و403؟
401 تعني أن الشخص غير مسجّل الدخول أو انتهى تسجيل دخوله، فيجب أن توجهه الرسالة إلى تسجيل الدخول. و403 تعني أنه مسجّل الدخول لكن تنقصه الصلاحية، فيجب أن تخبره الرسالة بمن يستطيع منحه الوصول.
لماذا لا ينبغي أن يقول خطأ الدخول "كلمة مرور خاطئة"؟
لأنه يؤكد وجود الحساب، وهذا يساعد من يخمّن الحسابات. توصي إرشادات الأمان برسالة عامة واحدة للبريد الخاطئ أو كلمة المرور الخاطئة.
المصادر
- رموز حالة HTTP: 403 Forbidden و401 Unauthorized على MDN.
- إرشادات رسائل الخطأ، Nielsen Norman Group.
- الكتابة، Apple Human Interface Guidelines.
- المصادقة ورسائل الخطأ، OWASP Cheat Sheet Series.
- نُشر أولا على شكل كاروسيل على UX Brainy.
Want every error, empty and loading state written and designed as one system? Our team designs product UI with the words in it from the first draft.
Get Started
