database.DataSnapshot class

واجهة تمثّل لقطة بيانات لقاعدة بيانات Firebase في الوقت الفعلي.

Signature:

export declare class DataSnapshot implements database.DataSnapshot 

التنفيذ: data.DataSnapshot

الشركات المصنِّعة

أماكن إقامة

الطُرق

base.DataSnapshot.(دالة إنشائية)

إنشاء مثيل جديد لفئة DataSnapshot

Signature:

constructor(data: any, path?: string, // path is undefined for the database root
    app?: App, instance?: string);

المَعلمات

قاعدة البيانات.DataSnapshot.instance

Signature:

instance: string;

قاعدة البيانات.DataSnapshot.key

المفتاح (الجزء الأخير من المسار) الخاص بموقع DataSnapshot هذا.

يعتبر الرمز المميز الأخير في موقع قاعدة البيانات هو المفتاح الخاص به. على سبيل المثال، "ada" هو المفتاح للعقدة /users/ada/. يؤدي الوصول إلى المفتاح في أي DataSnapshot إلى عرض مفتاح الموقع الجغرافي الذي أنشأه. ومع ذلك، يؤدي الوصول إلى المفتاح على عنوان URL الجذر لقاعدة بيانات إلى إرجاع null.

Signature:

get key(): string | null;

قاعدة البيانات.DataSnapshot.ref

تعرض [Reference](/docs/reference/admin/node/admin.database.Reference) إلى موقع قاعدة البيانات حيث حدثت عملية الكتابة المطلوبة. لديه إذن وصول كامل للقراءة والكتابة.

Signature:

get ref(): database.Reference;

data.DataSnapshot.child()

تحصل على DataSnapshot للموقع الجغرافي في المسار النسبي المحدّد.

ويمكن أن يكون المسار النسبي اسمًا فرعيًا بسيطًا (مثل "ada") أو مسارًا أعمق مفصولاً بشرطة مائلة (مثل "ada/name/first").

Signature:

child(childPath: string): DataSnapshot;

المَعلمات

المرتجعات:

نبذة عن البيانات

data.DataSnapshot.exists()

تعرض true إذا كانت DataSnapshot تحتوي على أي بيانات. وهو أكثر فعالية قليلاً من استخدام snapshot.val() !== null.

true إذا كانت قيمة DataSnapshot هذه تحتوي على أي بيانات وبخلاف ذلك، false.

Signature:

exists(): boolean;

المرتجعات:

قيمة منطقية

data.DataSnapshot.exportVal()

تصدِّر هذه السياسة محتوى DataSnapshot بالكامل ككائن JavaScript.

محتوى DataSnapshot كقيمة JavaScript (كائن أو مصفوفة أو سلسلة أو رقم أو قيمة منطقية أو null).

Signature:

exportVal(): any;

المرتجعات:

أي

base.DataSnapshot.for مستندات()

لتعداد DataSnapshot من العناصر الثانوية.

لا تضمن طريقة عمل كائنات JavaScript أنّ ترتيب البيانات في كائن JavaScript الذي يعرضه val() سيطابق الترتيب على الخادم ولا مع ترتيب أحداث child_added. وهنا يأتي دور forEach(). ويضمن هذا الإجراء إمكانية تكرار عناصر DataSnapshot الثانوية بترتيب طلبات البحث.

في حال عدم استخدام طريقة orderBy*() صريحة، يتم عرض النتائج مرتبة حسب المفتاح (ما لم يتم استخدام الأولويات، وفي هذه الحالة، يتم عرض النتائج حسب الأولوية).

Signature:

forEach(action: (a: DataSnapshot) => boolean | void): boolean;

المَعلمات

المرتجعات:

قيمة منطقية

data.DataSnapshot.getPriority()

الحصول على قيمة الأولوية للبيانات في DataSnapshot

بدلاً من استخدام الأولوية، يمكن للتطبيقات ترتيب المجموعات حسب السمات العادية. راجع [فرز البيانات وتصفيتها](/docs/database/web/lists-of-data#sorting_and_filtering_data).

قيمة أولوية البيانات.

Signature:

getPriority(): string | number | null;

المرتجعات:

سلسلة | الرقم | فارغ

قاعدة البيانات.DataSnapshot.hasChild()

تعرض true إذا كان المسار الفرعي المحدد يحتوي على بيانات (لا تتبع null).

Signature:

hasChild(childPath: string): boolean;

المَعلمات

المرتجعات:

قيمة منطقية

data.DataSnapshot.hasChildren()

تعرض ما إذا كان DataSnapshot يحتوي على أي خصائص فرعية غير تابعة لـ null أم لا.

يمكنك استخدام hasChildren() لتحديد ما إذا كان هناك أي أطفال في DataSnapshot. إذا كان الأمر كذلك، يمكنك تعدادها باستخدام forEach(). وفي حال عدم التطابق، يعني ذلك أنّ هذه اللقطة تحتوي على قيمة أولية (يمكن استردادها باستخدام val()) أو تكون فارغة (في هذه الحالة، تعرض val() القيمة null).

true إذا كانت هذه اللقطة تحتوي على أي عناصر ثانوية غير ذلك false.

Signature:

hasChildren(): boolean;

المرتجعات:

قيمة منطقية

data.DataSnapshot.numChildren()

تعرض عدد الخصائص الفرعية لهذه DataSnapshot.

عدد المواقع الفرعية الخاصة بهذا DataSnapshot

Signature:

numChildren(): number;

المرتجعات:

رقم

data.DataSnapshot.toJSON()

تعرض تمثيلاً بتنسيق JSON لهذا الكائن.

تمثّل هذه السمة تمثيلاً بتنسيق JSON لهذا العنصر.

Signature:

toJSON(): Record<string, unknown>;

المرتجعات:

سجلّ<string، غير معروف>

data.DataSnapshot.val()

لاستخراج قيمة JavaScript من DataSnapshot

استنادًا إلى البيانات في DataSnapshot، قد تعرض الطريقة val() نوعًا عدديًا (سلسلة أو رقم أو قيمة منطقية) أو مصفوفة أو كائن. وقد يعرض أيضًا null، ما يشير إلى أن DataSnapshot فارغة (لا تحتوي على بيانات).

محتوى اللقطة كقيمة JavaScript (كائن أو مصفوفة أو سلسلة أو رقم أو قيمة منطقية أو null).

Signature:

val(): any;

المرتجعات:

أي