Class CollectionInsertManyError

Overview

Represents an error that occurred during a (potentially paginated) insertMany operation on a Collection.

Contains the inserted IDs of the documents that were successfully inserted, as well as the cumulative errors that occurred during the operation.

If the operation was ordered, the insertedIds will be in the same order as the documents that were attempted to be inserted.

Example

try {
  await collection.insertMany([
    { _id: 'id1', desc: 'An innocent little document' },
    { _id: 'id2', desc: 'Another little document minding its own business' },
    { _id: 'id2', desc: 'A mean document commiting _identity theft' },
    { _id: 'id3', desc: 'A document that will never see the light of day-tabase' },
  ], { ordered: true });
} catch (e) {
  if (e instanceof CollectionInsertManyError) {
    console.log(e.message); // "Document already exists with the given _id"
    console.log(e.insertedIds()); // ['id1', 'id2']
    console.log(e.errors()); // [DataAPIResponseError(...)]
  }
}
Copy

Collections vs Tables

There is a sister TableInsertManyError class that is used for insertMany operations on tables. It's identical in structure, but uses the appropriate SomeRow type for the IDs.

See

• Collection.insertMany
• TableInsertManyError