Actualizar versiones de los controladores

Versión 6.0 cambio disruptivo

• La versión 6.0 del controlador de Node.js requiere Node.js v16.20.1 o posterior.

• El driver elimina el soporte para el comando asistente addUser(). Utiliza el comando createUser de MongoDB Shell en su lugar.

• El driver elimina el soporte para la operación collStats. Use el operador de agregación $collStats en su lugar.

• El driver remueve todas las opciones obsoletas con el prefijo ssly la opción tlsCertificateFile en el tipo MongoClientOptions. Cree un objeto SecureContext o establezca las opciones con prefijo tlsen su instancia MongoClientOptions en su lugar.

• El controlador lee archivos establecidos en las opciones de conexión tlsCAFile y tlsCertificateKeyFile cuando se llama al método MongoClient.connect(), no cuando se crea la instancia de MongoClient.

• El driver remueve las opciones de conexión keepAlive y keepAliveInitialDelay. El valor de keepAlive se establece permanentemente en true y el valor de keepAliveInitialDelay se establece en 300000 milisegundos (300 segundos).

• El método Db.command() acepta sólo las opciones que no están relacionadas con un comando específico. Para obtener más información sobre estas opciones, consulta la sección Opciones de comando de la guía Ejecutar un comando.

• Si añades mongodb-client-encryption como dependencia, el número de la versión principal debe coincidir con el de Node.js driver. Por ejemplo, el controlador Node.js v6.x.x requiere mongodb-client-encryption v6.x.x.

• Los métodos de cifrado automático ya están en el driver Node.js. Debe importar estos métodos desde el controlador en lugar de desde mongodb-client-encryption.

• Se eliminó el constructor ObjectId que aceptaba una string de 12 caracteres.

• Se modificaron los métodos abortTransaction() y commitTransaction() para que devuelvan null en lugar de los resultados brutos del comando.

• Se eliminaron los asistentes de opciones de conexión que aceptaban valores distintos de true o false como valores booleanos. Debes proporcionar valores true o false en la cadena de conexión o en el constructor de MongoClient.

• Se eliminó el constructor de tipo BSON Binary que aceptaba una string.

• El método Binary.write() ya no acepta una string para guardar en el objeto BSON binario.

• La API ClientEncryption devuelve promesas en lugar de callbacks.

• El paquete socks, que permite la compatibilidad con el proxy SOCKS5, es una dependencia opcional de igual a igual. Debe instalar el paquete para habilitar SOCKS5 en su aplicación. Para aprender más, consultá Habilitar compatibilidad con el proxy SOCKS5.

• Si se inicia una sesión en un cliente y luego se pasa esa sesión a otro cliente, el driver lanza un error al realizar cualquier operación en la sesión.

• La opción includeResultMetadata para los métodos de operación compuesta está false por defecto. Consulta la sección Métodos de funcionalidad incorporada de la guía de Operaciones Compuestas para más información.

• El método withSession() devuelve el valor que la función proporcionada devuelve. En versiones anteriores del controlador, este método devuelve undefined. El método withTransaction() devuelve el valor que devuelve la función de retorno. En versiones anteriores del driver, este método devuelve la respuesta del comando del servidor, que varía dependiendo de la versión del MongoDB Server o del tipo al que el driver se conecta. Para obtener más información sobre las transacciones, consulta las guías de la API de transacciones conveniente y la Core API y la guía de Transacciones.

• Se elevó la versión mínima de la dependencia opcional kerberos a 2.0.1 y se eliminó el soporte para la versión 1.x.

• Se elevó la versión mínima de la dependencia opcional zstd a 1.1.0.

Version 5.0 Cambios disruptivos

• El controlador ya no es compatible con Node.js v12 o versiones anteriores. Si desea utilizar esta versión del driver, debe utilizar Node.js v14.20.1 o superior.

• El controlador remueve el soporte para funciones de retorno en favor de una API basada en Promesas. La siguiente lista proporciona algunas estrategias para que los usuarios de función de retorno adopten esta versión:

  • Migrar a la API basada en promesas (recomendado)

  • Utiliza la API basada en promesas y util.callbackify

  • Agregue mongodb-legacy para continuar usando funciones de retorno

  Para obtener más información sobre estas estrategias, consulta el registro de cambios v5.0.

• El controlador elimina el soporte para los métodos auxiliares Collection.insert(), Collection.update() y Collection.remove(). La siguiente lista proporciona instrucciones sobre cómo reemplazar la funcionalidad de los métodos eliminados:

  • Migrar de Collection.insert() a insertOne() o insertMany()

  • Migrar de Collection.update() a updateOne() o updateMany()

  • Migrar de Collection.remove() a deleteOne() o deleteMany()

• El driver ya no incluye por defecto los módulos del AWS SDK.

• El controlador ya no importa automáticamente el paquete bson-ext.

• El driver remueve el soporte para librerías personalizadas Promise. El driver ya no es compatible con la opción promiseLibrary de MongoClient y la exportación Promise.set que permite especificar una librería Promise personalizada.

• El driver remueve la compatibilidad con el asistente Collection.mapReduce().

• El tipo BulkWriteResult ya no tiene la propiedad enumerable públicamente result.

• Se han eliminado los siguientes tipos, opciones y métodos:

  • BulkResult.lastOp() Método

  • opTime propiedades de BulkResult

  • BulkWriteOptions.keepGoing Opción

  • WriteConcernError.err() Método

  • AddUserOptions.digestPassword Opción

  • Kerberos gssapiCanonicalizeHostName option

  • slaveOk se eliminaron las opciones y el método en favor de secondaryOk

  • ObjectID tipo eliminado en favor de ObjectId

  • AsyncIterator interfaz eliminada a favor de AsyncGenerator

Versión 4.0 cambios disruptivos

• El controlador ya no es compatible con Node.js v12.8 o anterior. Si desea utilizar esta versión del controlador, debe utilizar Node.js v12.9 o superior.

• Cursor los tipos ya no extienden directamente Readable.

• No puedes usar una instancia ChangeStream como iterador después de usarla como EventEmitter. Tampoco puedes hacer lo contrario—usar una instancia de EventEmitter como iterador después de haberla usado como ChangeStream.

• Los siguientes métodos ya no aceptan un parámetro de función de retorno:

  • Collection.find()

  • Collection.aggregate()

  • Db.aggregate()

• El valor por defecto de la opción de conexión maxPoolSize ahora es 100.

• El controlador ya no admite la opción gssapiServiceName Kerberos. Utilice authMechanismProperties.SERVICE_NAME en su lugar.

• El driver ya no acepta tipos no booleanos, como 0 o 1, para opciones booleanas.

• El tipo db.collection ya no acepta una función de retorno.

• El tipo Db ya no es un EventEmitter. Puedes escuchar cualquier evento directamente desde la instancia MongoClient.

• El driver remueve la compatibilidad con el asistente Collection.group().

• El driver ya no incluye la API GridStore obsoleta.

Para obtener más información sobre estos cambios, consulta el registro de cambios de la v4.0.

Versión 4.2 Cambios en el soporte de lanzamiento del servidor

• El controlador v4.2 deja de admitir MongoDB Server v3.4 y versiones anteriores. Para usar la v4.2 driver, tu servidor de MongoDB debe ser v3.6 o posterior. Para aprender cómo actualizar tu implementación de MongoDB Server, consulta las notas de versión en el manual de MongoDB Server.