find() (الاستعلام عن مستندات)

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

find() (الاستعلام عن مستندات)

تستعلم find() عن مستندات مطابقة لشرط وتُعيد مؤشرًا (Cursor). وهي أبسط طرق القراءة: الوسيط الأول هو شرط الاستعلام، والثاني هو الإسقاط الذي يتحكم في الحقول المُعادة. المؤشر كسول — لا تُجلب البيانات إلا عند التكرار (toArray/forEach/next).

📝 الصيغة

db.<collection>.find(<query>, <projection>)

⚙️ المعلمات

القيمة المرجعة：مؤشر

▶ مثال

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

// find: مستخدمون أكبر من 20 عامًا، الاسم فقط
const cursor = db.users.find(
  { age: { $gt: 20 } },
  { name: 1, age: 1, _id: 0 }
)
cursor.forEach(u => print(u.name))

المخرجات：

Alice
Bob

📌 ملاحظات

• يُعيد مؤشرًا وليس مصفوفة؛ استهلكه بـ toArray()/forEach()/next()
• لا يمكن خلط قيمتي 1 و0 في الإسقاط (باستثناء _id)
• find() للقراءة فقط؛ لا تُعدَّل المستندات أبدًا
• في mongosh، تطبع find() المجردة أول 20 مستندًا؛ اكتبها لتصفّح المزيد

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

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

📚 دروس ذات صلة

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

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

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

من نحن