升级驱动程序版本

5.x 版重大更改

• 驱动程序版本 5.x 与 Node.js v12 或更早版本不兼容。如果要使用此版本的驱动程序，则必须使用 Node.js v14.20.1 或更高版本。

• 该驱动程序删除对回调的支持，转而支持基于 Promise 的 API。以下列表为回调用户提供了一些策略以采用该版本：

  • 迁移至基于 Promise 的 API（推荐）

  • 使用基于 promise 的 API 和 util.callbackify

  • 添加 mongodb-legacy 以继续使用 callback

  有关这些策略的更多信息，请参阅 v5.0 变更日志 。

• 驱动程序删除了对 Collection.insert()、Collection.update() 和 Collection.remove() 辅助方法的支持。 以下列表说明了如何替换已删除方法的功能：

  • 从 Collection.insert() 迁移到 insertOne() 或 insertMany()

  • 从 Collection.update() 迁移到 updateOne() 或 updateMany()

  • 从 Collection.remove() 迁移到 deleteOne() 或 deleteMany()

• 默认情况下，驱动程序不再包含 AWS SDK 模块。

• 该驱动程序不再自动导入 bson-ext 包。

• 该驱动程序删除了对自定义 Promise 库的支持。该驱动程序不再支持 MongoClient 的 promiseLibrary 选项以及允许指定自定义 Promise 库的 Promise.set 导出。

• 该驱动程序删除了对Collection.mapReduce()辅助程序的支持。

• BulkWriteResult 类型不再具有可公开枚举的 result 属性。

• 以下类型、选项和方法已被删除：

  • BulkResult.lastOp() 方法

  • opTime 属性，属于 BulkResult

  • BulkWriteOptions.keepGoing 选项

  • WriteConcernError.err() 方法

  • AddUserOptions.digestPassword 选项

  • Kerberos gssapiCanonicalizeHostName option

  • slaveOk 选项和方法已被删除，取而代之的是 secondaryOk

  • ObjectID 键入已删除，取而代之的是 ObjectId

  • AsyncIterator 界面已被删除，取而代之的是 AsyncGenerator

版本 4.x 重大更改

• 驱动程序版本 4.x 与 Node.js v12.8 或更早版本不兼容。如果您想使用此版本的驱动程序，必须使用 Node.js v12.9 或更高版本。

• Cursor 类型不再直接扩展 Readable。

• 在将ChangeStream实例用作EventEmitter后，您无法将其用作迭代器。您也不能反过来操作 - 在将EventEmitter实例用作ChangeStream后，将其用作迭代器。

• 以下方法不再接受 回调 参数：

  • Collection.find()

  • Collection.aggregate()

  • Db.aggregate()

• maxPoolSize 连接选项的默认值现在为 100。

• 驱动程序不再支持 gssapiServiceName Kerberos 选项。用户应改用 authMechanismProperties.SERVICE_NAME。

• 对于布尔选项，驱动程序不再接受非布尔类型，例如 0 或 1。

• db.collection 类型不再接受 回调。

• Db 类型不再是 EventEmitter。您可以监听直接来自 MongoClient 实例的任何事件。

• 该驱动程序删除了对Collection.group()辅助程序的支持。

• 驱动程序不再包含已弃用的 GridStore API。

有关这些更改的更多信息，请参阅 v4.0 变更日志。

4.2 版服务器版本支持更改

• v4.2 驱动程序不再支持 MongoDB Server v3.4 及更早版本。如要使用 v4.2 驱动程序，您的 MongoDB Server 必须是 v3.6 或更新版本。如要了解如何升级 MongoDB Server 部署，请参阅 MongoDB Server 手册中的发行说明。