Обещания

Встроенные обещания

Асинхронные операции Mongoose, такие как .save() и запросы, возвращают thenable. Это означает, что вы можете делать такие вещи, как MyModel.findOne({}).then() и await MyModel.findOne({}).exec(), если используете async/await.

Вы можете найти тип возвращаемого значения для конкретных операций в документации API. Вы также можете узнать больше о обещаниях в Mongoose.

const gnr = new Band({
  name: 'Guns N\' Roses',
  members: ['Axl', 'Slash']
});

const promise = gnr.save();
assert.ok(promise instanceof Promise);

promise.then(function(doc) {
  assert.equal(doc.name, 'Guns N\' Roses');
});

Запросы не являются обещаниями

Запросы Mongoose являются не обещаниями. У них есть функция .then() для co и async/await в качестве удобства. Если вам нужно полноценное обещание, используйте функцию .exec().

const query = Band.findOne({ name: 'Guns N\' Roses' });
assert.ok(!(query instanceof Promise));

// A query is not a fully-fledged promise, but it does have a `.then()`.
query.then(function(doc) {
  // use doc
});

// `.exec()` gives you a fully-fledged promise
const promise = Band.findOne({ name: 'Guns N\' Roses' }).exec();
assert.ok(promise instanceof Promise);

promise.then(function(doc) {
  // use doc
});

Запросы являются thenable

Хотя запросы не являются обещаниями, запросы являются thenable. Это означает, что у них есть функция .then(), поэтому вы можете использовать запросы как обещания с помощью цепочки обещаний или async await

Band.findOne({ name: 'Guns N\' Roses' }).then(function(doc) {
  // use doc
});

Нужно ли использовать exec() с await?

Существует два варианта использования await с запросами:

• await Band.findOne();
• await Band.findOne().exec();

Что касается функциональности, эти два варианта эквивалентны. Тем не менее, мы рекомендуем использовать .exec() , так как это дает вам лучшие трассировки стека.

const doc = await Band.findOne({ name: 'Guns N\' Roses' }); // works

const badId = 'this is not a valid id';
try {
  await Band.findOne({ _id: badId });
} catch (err) {
  // Without `exec()`, the stack trace does **not** include the
  // calling code. Below is the stack trace:
  //
  // CastError: Cast to ObjectId failed for value "this is not a valid id" at path "_id" for model "band-promises"
  //   at new CastError (/app/node_modules/mongoose/lib/error/cast.js:29:11)
  //   at model.Query.exec (/app/node_modules/mongoose/lib/query.js:4331:21)
  //   at model.Query.Query.then (/app/node_modules/mongoose/lib/query.js:4423:15)
  //   at process._tickCallback (internal/process/next_tick.js:68:7)
  err.stack;
}

try {
  await Band.findOne({ _id: badId }).exec();
} catch (err) {
  // With `exec()`, the stack trace includes where in your code you
  // called `exec()`. Below is the stack trace:
  //
  // CastError: Cast to ObjectId failed for value "this is not a valid id" at path "_id" for model "band-promises"
  //   at new CastError (/app/node_modules/mongoose/lib/error/cast.js:29:11)
  //   at model.Query.exec (/app/node_modules/mongoose/lib/query.js:4331:21)
  //   at Context.<anonymous> (/app/test/index.test.js:138:42)
  //   at process._tickCallback (internal/process/next_tick.js:68:7)
  err.stack;
}