next() (جلب المستند التالي)

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

next() (جلب المستند التالي)

تُعيد next() المستند التالي في مؤشر وتتقدّم به: `db.users.find().next()`. استدعاؤها بعد نفاد المؤشر يرفع خطأً، لذا اقرنها بـ hasNext(): `while (cursor.hasNext()) { const doc = cursor.next() }`. وهي البدائية منخفضة المستوى للتكرار اليدوي على المؤشر.

📝 الصيغة

db.<collection>.find(<filter>).next()

القيمة المرجعة：المستند التالي؛ يرمي خطأً عند استنفاد المؤشر.

▶ مثال

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

// next: سحب أول 3 مستندات يدويًا
const cursor = db.users.find()
for (let i = 0; i < 3; i++) {
  print(cursor.next().name)
}

المخرجات：

Alice
Bob
Cara

📌 ملاحظات

• next() ترفع خطأً بمجرد نفاد المؤشر
• اقرنها بـ hasNext() لتكرار آمن
• اتجاه واحد فقط — لا يمكنك الرجوع خطوة

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

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

📚 دروس ذات صلة

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

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

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

من نحن