شارك المقالة
التحقق من وجود مستند Firestore في Flutter باستخدام exists

التحقق من وجود مستند Firestore في Flutter باستخدام exists

التحقق من وجود مستند Firestore في Flutter باستخدام DocumentSnapshot.exists، والتمييز بين مستند غير موجود وخطأ صلاحيات أو اتصال.

التحقق من وجود مستند Firestore في Flutter باستخدام DocumentSnapshot.exists، والتمييز بين مستند غير موجود وخطأ صلاحيات أو اتصال.

مستند محدد أم قائمة فرعية؟

إذا كنت تعرف معرف المستخدم، اطلب users/{uid} مباشرة وافحص exists. جلب جميع عناصر my_address لا يجيب عن وجود مستند المستخدم نفسه، بل عن وجود عناوين يمكن قراءتها. لهذا صححنا المثال ليتطابق مع عنوان الدرس. لا تستخدم قراءة مجموعة كاملة لاكتشاف مستند واحد معروف المعرف؛ الطلب المباشر أوضح ويقلل البيانات المنقولة ويجعل سبب الفشل أسهل للفهم.

معنى exists وdata

exists يوضح وجود المستند في اللقطة المعادة، بينما data قد تعيد null إذا لم يوجد. مستند موجود بخريطة فارغة يختلف عن مستند غير موجود. افحص النوع والحقول المطلوبة قبل تحويل البيانات إلى model، ولا تستخدم data()! عشوائيًا. قد توجد مستندات داخل subcollection حتى لو لم يوجد مستند الأب، لذلك لا تجعل فحص الأب دليلًا نهائيًا أن كل المسارات الفرعية فارغة.

لا تحول كل فشل إلى false

permission-denied يعني أن القراءة غير مسموحة، وليس أن المستند غير موجود. فشل الشبكة أو البيانات المحلية القديمة يحتاج سياسة مختلفة حسب عملية التطبيق. المثال يسمح بتمرير خطأ القراءة إلى طبقة العرض بدل إخفائه في false. عند الحاجة لنتيجة من الخادم دون الاعتماد على cache استخدم Source.server وافهم أنه قد يفشل عند عدم الاتصال؛ لا تستبدل بيانات المستخدم بناء على استنتاج من فشل اتصال.

التحقق قبل الإنشاء والتزامن

فحص وجود المستند ثم إنشاؤه خطوتان منفصلتان وقد ينفذهما جهازان معًا. إذا كان القرار يحتاج ضمانًا متزامنًا، استخدم transaction أو كتابة idempotent وفق نموذجك وقواعدك. في ملف مستخدم يفضل معرف Firebase Auth UID بدل معرف عشوائي كل مرة. اختبر معرفًا صحيحًا وآخر غير موجود ورفض القواعد ومستندًا خاليًا، واجعل الواجهة تميز بين لم تنشئ ملفك بعد وتعذر التحقق الآن.

المثال التطبيقي وحدوده

أضف الحزم المستوردة بإصدارات متوافقة، وهيئ Firebase قبل استخدام خدماته. المقطع يوضح الجزء المذكور في الشرح؛ إعدادات المنصة والقواعد وواجهة الحالات تظل مسؤولية المشروع المستضيف.

import 'package:cloud_firestore/cloud_firestore.dart';

Future<bool> userDocumentExists(String uid) async {
  if (uid.isEmpty || uid.contains('/')) throw ArgumentError.value(uid, 'uid');
  final snapshot = await FirebaseFirestore.instance.collection('users').doc(uid).get();
  return snapshot.exists;
}

الصور والفيديو من الشرح

المواد المرئية الأصلية محفوظة للرجوع إليها. قد تعرض إصدارًا قديمًا؛ عند الاختلاف اتبع النص والأمثلة المصححة أعلاه، خاصة في خدمات الإشعارات والروابط التي تغيرت.

التاكد من وجود doc في Flutter بإستخدام الفايربيز

مراجع التنفيذ

شاهد أيضًا
مقالات ذات صلة
🚫 مانع الإعلانات مفعل

يجب إيقاف مانع الإعلانات لاستكمال تصفح الموقع