bulkInsert( )

Adds a number of items to a collection.

The bulkInsert() method returns a Promise that resolves after the items have been added to the specified collection. The Promise is rejected if the current user does not have "create" permissions for the collection. Items are skipped if they include an _id property whose value matches an existing ID in the collection. This means that bulkInsert() cannot overwrite an existing item in the collection.

Calling the bulkInsert() method triggers the beforeInsert() and afterInsert() events for each item that is inserted, if these events have been defined.

When inserting items into a collection that has a reference field, set the values of the reference fields to the referenced item's _id value or the entire referenced item object.

The bulkInsert() method adds the following properties and values to the item when it adds it to the collection:

• _id: A unique identifier for an item in a collection, if the item doesn't have one or has one that is undefined. You can optionally provide your own ID. Once an ID is assigned to an item it cannot be changed.
• _createdDate: The date the item was added to the collection.
• _updatedDate: The date the item was modified. When the item is first added, the createdDate and updatedDate are the same.

Any valid JavaScript object can be added as a property value. The bulkInsert() method maintains the structure of the specified object. For example, objects that contain nested objects, arrays, or arrays with nested objects are all added to the collection as defined.