معالجة أخطاء التحقق في الإجراءات
أعد أخطاء التحقق وأعد ملء حقول النموذج باستخدام fail() وActionData
معالجة أخطاء التحقق في الإجراءات درس مجاني في Sveltejs Academy على CoddyKit. هذا هو الدرس 4 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في Sveltejs Academy، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة Sveltejs Academy 4 دروس في المجموع.
المساعد fail
استخدم fail() لإعادة أخطاء التحقق مع حالة ليست من فئة 2xx من دون إطلاق استثناء.
import { fail } from "@sveltejs/kit";
if (!email) return fail(400, { email, missing: true });رمز الحالة
الوسيط الأول هو حالة HTTP (عادةً 400 في حالة التحقق).
حمولة الخطأ
الوسيط الثاني هو البيانات المُرسلة مرة أخرى إلى الصفحة. ضمّن إدخال المستخدم لإعادة تعبئة الحقول.
القراءة في الصفحة
تتلقى الصفحة خاصية form التي تحتوي على نتيجة الإجراء.
<script>
export let form;
</script>
{#if form?.missing}<p>Please enter an email.</p>{/if}إعادة تعبئة الحقول
مرّر القيمة المُرسلة مرة أخرى عبر fail واملأ الحقول مسبقًا لتجنب إعادة إدخالها.
<input name="email" value={form?.email ?? ""} />أخطاء على مستوى الحقل
استخدم مفاتيح أخطاء منفصلة لكل حقل لتوفير واجهة مستخدم دقيقة.
return fail(400, { errors: { email: "Invalid" } });الدمج مع التحقق باستخدام مخطط
استخدم مكتبات مثل Zod أو Valibot على الخادم لتحليل البيانات بأمان من حيث الأنواع.
تجنب إطلاق الاستثناءات للتحقق
يؤدي إطلاق الاستثناءات إلى صفحات الأخطاء؛ بينما يُبقي fail المستخدم في النموذج.
إعادة ضبط النموذج عند النجاح
عند النجاح، امسح حالة النموذج بإعادة قيم فارغة أو بإعادة التوجيه.
الاستخدام مع use:enhance
تتحدّث خاصية form من دون إعادة تحميل، بفضل enhance.
إمكانية الوصول
أعلن عن الأخطاء باستخدام aria-live لكي تقرأها برامج قراءة الشاشة.
تحقق سريع
ماذا تعيد fail()؟
مراجعة
استخدم fail() لأخطاء التحقق. وتقرأ الصفحة هذه الأخطاء من خاصية form لتوفير ملاحظات واضحة للمستخدم.
الأسئلة الشائعة
هل درس «معالجة أخطاء التحقق في الإجراءات» مجاني؟
نعم — نص درس «معالجة أخطاء التحقق في الإجراءات» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة Sveltejs Academy، انتقل إلى CoddyKit PRO. تتضمن دورة Sveltejs Academy 4 دروس في المجموع.
ماذا ستتعلم في «معالجة أخطاء التحقق في الإجراءات»؟
أعد أخطاء التحقق وأعد ملء حقول النموذج باستخدام fail() وActionData تتمرن على Sveltejs Academy مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.
هل أحتاج إلى خبرة سابقة لأبدأ Sveltejs Academy؟
لا تُشترط خبرة سابقة. Sveltejs Academy على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 4 من أصل 4.
كم من الوقت يستغرق درس «معالجة أخطاء التحقق في الإجراءات»؟
معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.
هل يمكنني كتابة وتشغيل أكواد في درس Sveltejs Academy هذا؟
نعم. كل درس في Sveltejs Academy يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.
جميع الدروس في هذه الدورة
- +page.server.js مع الإجراءات
- توجيه use:enhance
- التحسين التدريجي للنماذج
- معالجة أخطاء التحقق في الإجراءات