insertOne()

إدراج مستند واحد insertOne()

insertOne() تضيف مستندًا واحدًا لمجموعة، وترجع _id المُنشأ تلقائيًّا إن لم تحدّده.

أبسط عملية كتابة في MongoDB. إذا لم يحتوِ المستند على _id، تولّد MongoDB واحدًا تلقائيًّا من نوع ObjectId. تفشل العملية بالكامل (لا كتابة جزئية) إذا خالف المستند فهرسًا فريدًا أو قواعد تحقّق (validator).

الصياغة

db.collection.insertOne(<document>)

📄 مثال

const result = db.users.insertOne({
  name: "براء",
  email: "baraa@example.com"
})

console.log(result.insertedId)

أهم المعاملات

المعامل	الوظيفة
document	الكائن المراد إدراجه

💡 نصائح عملية

لإدراج عدّة مستندات دفعة واحدة بكفاءة أعلى من استدعاء insertOne() بحلقة، استخدم insertMany()

⚠️ أخطاء شائعة

تجاهل معالجة خطأ E11000 عند إدراج قيمة موجودة مسبقًا في حقل عليه فهرس فريد (unique)

🎓 تريد فهم الصورة الكاملة خطوة بخطوة؟ ابدأ من مسار MONGODB الكامل بالعربي.

📚 للتعمق التقني الكامل بالإنجليزية: MDN Web Docs