$getField (الحصول على حقل بالاسم)

آخر تحديث: 2026-10-09

$getField (الحصول على حقل بالاسم)

يجلب $getField حقلًا باسمه الحرفي من مستند، دون تحليل الاسم كمسار حقل حتى لو بدأ بـ $ أو احتوى أحرفًا خاصة. الصياغة { $getField: { field: field-name, input: document } }، مع افتراض input بـ $$CURRENT. يُستخدم لأسماء الحقول الديناميكية أو الأسماء ذات الأحرف الخاصة. الحقل المفقود يُرجع null. مقارنةً بكتابة '$field' مباشرة، $getField أكثر مرونة لكنه أكثر إسهابًا.

📝 الصيغة

{ $getField: { field: <field-name>, input: <document-expression> } }

⚙️ المعلمات

القيمة المرجعة：قيمة الحقل؛ null عندما يكون الحقل مفقودًا أو الإدخال null

▶ مثال

نفّذ الأوامر التالية في mongosh المحلي لديك (يتطلب تشغيل mongod):

// $getField: جلب حقل بالاسم من المستند الحالي
db.orders.aggregate([
  { $project: {
      price: { $getField: { field: 'price', input: '$$CURRENT' } }
  } }
])

المخرجات：

{ '_id': 1, 'price': 199 }
{ '_id': 2, 'price': 59 }

📌 ملاحظات

• اسم الحقل الذي يبدأ بـ $ يُؤخذ حرفيًا لا كمسار
• input يُعرّف افتراضيًا على $$CURRENT
• الحقل المفقود يُرجع null؛ اقرنه بـ $ifNull عند الحاجة

🏷️ وسوم ذات صلة

💡 حالات ذات صلة

📚 دروس ذات صلة

❓ الأسئلة الشائعة

فريق Web-Tutorial التقني

منصة دروس برمجية يديرها عدة مطورين. كل درس يتم كتابته ومراجعته بواسطة مطورين متخصصين في المجال. نعمل على ضمان دقة وموثوقية المحتوى — إذا لاحظت أي مشكلة، فيرجى إخبارنا.

من نحن