[Snyk] Upgrade mongodb from 3.5.9 to 6.20.0 #1634
Open
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Snyk has created this PR to upgrade mongodb from 3.5.9 to 6.20.0.
ℹ️ Keep your dependencies up-to-date. This makes it easier to fix existing vulnerabilities and to more quickly identify and fix newly disclosed vulnerabilities when they affect your project.
The recommended version is 385 versions ahead of your current version.
The recommended version was released 22 days ago.
Issues fixed by the recommended upgrade:
SNYK-JS-BL-608877
Release notes
Package name: mongodb
6.20.0 (2025-09-17)
The MongoDB Node.js team is pleased to announce version 6.20.0 of the
mongodb
package!Release Notes
Collection
andDb
objects now provide references to theirDb
andMongoClient
const client = new MongoClient(process.env.MONGODB_URI);
const db = client.db('test');
assert(db.client === client); // returns the MongoClient associated with the Db object
const collection = db.collection('test');
assert(collection.db === db); // returns the Db associated with the Collection object
Hint is supported with unacknowledged writes for delete, update and findAndModify commands on servers that support hint
The driver no longer throws errors when
hint
is provided to unacknowledged writes fordelete
,update
andfindAndModify
commands in the following circumstances:update
commands.delete
andfindAndModify
commands on servers >=4.4.ServerCapabilities and ReadPreference.minWireVersion are deprecated
Neither the
ServerCapabilities
class nor theReadPreference.minWireVersion
property were ever intended for public use and, internally, are effectively dead code with the driver's minimum supported server version being 4.2.Driver info and metadata MongoClient options have been deprecated.
These will be made internal in a future major release:
driverInfo
additionalDriverInfo
metadata
extendedMetadata
CommandOperationOptions.retryWrites
is deprecatedCommandOperationOptions.retryWrites
is deprecated. This per‑command option has no effect; the Node.js driver only honorsretryWrites
when configured at the client level (MongoClient options) or via the connection string. Do not use this option on individual commands. There is no runtime behavior change because it was already ignored, but it will be removed in an upcoming major release and may cause type or build errors in code that references it. To control retryable writes, setretryWrites
in MongoClient options or includeretryWrites=true|false
in the connection string.ChangeStream
.tryNext()
now updatesresumeToken
to prevent duplicates after resumeWhen
.tryNext()
returns a change document, the driver now caches itsresumeToken
, aligning its behavior with.next()
and the'change'
event. If.tryNext()
returnsnull
(no new changes), nothing is cached, which is unchanged from previous behavior.Previously,
.tryNext()
did not update theresumeToken
, so a resumable error could cause a resume from an older token and re-deliver already processed changes. With this release, resumes continue from the latest token observed via.tryNext()
, preventing duplicates.Applications that poll change streams with
.tryNext()
in non-blocking loops benefit directly. There are no API changes; if you previously tracked and passedresumeAfter
orstartAfter
manually, you can now rely on the driver’s built-in token caching.Huge thanks to @ rkistner for bringing this bug to our attention and for sharing code to reproduce it. Huge thanks as well to @ Omnicpie for investigating and implementing a fix.
Change Streams now resume on
MongoServerSelectionError
When the driver encounters a
MongoServerSelectionError
while processing a Change Stream (e.g., due to a transient network issue or during an election), it now treats the error as resumable and attempts to resume using the latest cached resume token.This applies to both iterator and event-emitter usage:
There are no API changes. If you previously caught
MongoServerSelectionError
and implemented manual resume logic, you can now rely on the driver’s built-in resume mechanism, which uses the cached resume token from the change event’s_id
to continue without losing events.Huge thanks to @ grossbart for bringing this bug to our attention, investigating it and for sharing code to reproduce it!
MongoClient.appendMetadata()
ignores duplicate metadataMongoClient.appendMetadata()
will no longer append metadata if it duplicates the metadata already appended to the MongoClient.Features
retryWrites
inCommandOperationOptions
(#4661) (620972d)Bug Fixes
resumeToken
inChangeStream.tryNext()
(#4636) (8331a93)Documentation
We invite you to try the
mongodb
library immediately, and report any issues to the NODE project.6.19.0 (2025-08-26)
The MongoDB Node.js team is pleased to announce version 6.19.0 of the
mongodb
package!Release Notes
Experimental Support for Queryable Encryption Text Field Prefix, Suffix and Substring Queries
Important
Substring, prefix and suffix search are in preview and should be used for experimental workloads only. These features are unstable and their security is not guaranteed until released as Generally Available (GA). The GA version of these features may not be backwards compatible with the preview version.
When using Queryable Encryption with both automatic encryption and explicit encryption, text fields can now be queried using prefix, suffix and substring queries. This feature requires
mongodb-client-encryption@>=6.5.0
.Allow a
secureContext
for Auto Encryption and Client Encryption TLS optionsThis can be provided in the
tlsOptions
option both both objects.import { ClientEncryption, MongoClient } from 'mongodb';
const caFile = await fs.readFile(process.env.CSFLE_TLS_CA_FILE);
const certFile = await fs.readFile(process.env.CSFLE_TLS_CLIENT_CERT_FILE);
const secureContextOptions = {
ca: caFile,
key: certFile,
cert: certFile
};
const options = {
keyVaultNamespace: 'db.coll',
kmsProviders: {
aws: {}
}
},
tlsOptions: {
aws: {
secureContext: tls.createSecureContext(secureContextOptions),
}
}
};
const client = this.configuration.newClient({}, { autoEncryption: { ...options, schemaMap } });
const clientEncryption = new ClientEncryption(client, options);
collection.findOne()
andcollection.find()
will no longer potentially leave open cursors on the serverThe
findOne
command will now always set thelimit
option to1
andsingleBatch
totrue
. Thelimit
,noCursorResponse
andbatchSize
options have also been deprecated, and the command will guarantee no more cursors can be orphaned and nokillCursors
command will be potentially executed.find
will now setlimit
tobatchSize + 1
when both options were equal, to avoid leaving cursors open.Clients no longer send a ping on connect
When authentication is enabled, the
MongoClient
will no longer send aping
command when connecting since it is unnecessary. Instead it will check a connection out of the pool to force the initial handshake, and check it back in.Features
Documentation
We invite you to try the
mongodb
library immediately, and report any issues to the NODE project.6.18.0 (2025-07-22)
The MongoDB Node.js team is pleased to announce version 6.18.0 of the
mongodb
package!Release Notes
New
appendMetadata
API allows clients to add handshake metadata post constructionDriver information such as name, version, and platform are allowed:
const client = new MongoClient(process.env.MONGODB_URI);
client.appendMetadata({ name: 'my library', version: '1.0', platform: 'NodeJS' });
Cursors lazily instantiate sessions
In previous versions, sessions were eagerly allocated whenever a cursor was created, regardless of whether or not a cursor was actually iterated (and the session was actually needed). Some driver APIs (
FindCursor.count()
,AggregationCursor.explain()
andFindCursor.explain()
) don't actually iterate the cursor they are executed on. This can lead to client sessions being created and never being cleaned up.With this update, sessions are not allocated until the cursor is iterated.
Idle connections are now pruned during periods of no activity even when
minPoolSize=0
A
MongoClient
configured with amaxIdleTimeMS
andminPoolSize
of 0 is advantageous for workloads that have sustained periods of little or no activity because it allows the connection pool to close connections that are unused during these periods of inactivity. However, due to a bug in theConnectionPool
implementation, idle / perished connections were not cleaned up unlessminPoolSize
was non-zero.With the changes in this PR, the
ConnectionPool
now always cleans up idle connections, regardless ofminPoolSize
.ChangeStream event interfaces include a
wallTime
propertyThis property is available on all types with the exception of reshard collection and refine collection shard key events. Thanks to @ qhello for bringing this bug to our attention!
CommandSucceededEvent
andCommandFailedEvent
events now have adatabaseName
propertyCommandSucceededEvent
andCommandFailedEvent
now include the name of the database against which the command was executed.Deprecations
Transaction state getters are deprecated
These were for internal use only and include:
ClientMetadata
,ClientMetadataOptions
, andCancellationToken
have been deprecatedThese types will be removed in an upcoming major version of the driver.
CommandOptions.noResponse
is deprecatedCaution
noResponse
is not intended for use outside ofMongoClient.close()
. Do not use this option.The Node driver has historically supported an option,
noResponse
, that is used internally when a MongoClient is closed. This option was accidentally public. This option will be removed in an upcoming major release.Features
Bug Fixes
wallTime
property TS change stream event interfaces (#4541) (f153c6f)Documentation
We invite you to try the
mongodb
library immediately, and report any issues to the NODE project.6.17.0 (2025-06-03)
The MongoDB Node.js team is pleased to announce version 6.17.0 of the
mongodb
package!Release Notes
Support for MongoDB 4.0 is removed
Warning
When the driver connects to a MongoDB server of version 4.0 or less, it will now throw an error.
OIDC machine workflows now retry on token expired errors during initial authentication
This resolves issues of a cached OIDC token in the driver causing initial authentication to fail when the token had expired. The affected environments were
"azure"
,"gcp"
, and"k8s"
.keepAliveInitialDelay
may now be configured at theMongoClient
levelWhen not present will default to 120 seconds. The option value must be specified in milliseconds.
const client = new MongoClient(process.env.MONGODB_URI, { keepAliveInitialDelay: 100000 });
updateOne
andreplaceOne
now support asort
optionThe updateOne and replaceOne operations in each of the ways they can be performed support a sort option starting in MongoDB 8.0. The driver now supports the sort option the same way it does for find or findOneAndModify-style commands:
collection.updateOne({}, {}, { sort });
collection.replaceOne({}, {}, { sort });
collection.bulkWrite([
{ updateOne: { filter: {}, update: {}, sort } },
{ replaceOne: { filter: {}, replacement: {}, sort } },
]);
client.bulkWrite([
{ name: 'updateOne', namespace: 'db.test', filter: {}, update: {}, sort },
{ name: 'replaceOne', namespace: 'db.test', filter: {}, replacement: {}, sort }
]);
MongoClient close shuts outstanding in-use connections
The
MongoClient.close()
method now shuts connections that are in-use allowing the event loop to close if the only remaining resource was the MongoClient.Support Added for Configuring the DEK cache expiration time.
Default value is 60000. Requires using mongodb-client-encryption >= 6.4.0
For
ClientEncryption
:For auto encryption:
Update operations will now throw if
ignoreUndefined
is true and all operations are undefined.When using any of the following operations they will now throw if all atomic operations in the update are undefined and the
ignoreUndefined
option istrue
. This is to avoid accidental replacement of the entire document with an empty document. Examples of this scenario:const client = new MongoClient(process.env.MONGODB_URI);
client.bulkWrite(
[
{
name: 'updateMany',
namespace: 'foo.bar',
filter: { age: { $lte: 5 } },
update: { $set: undefined, $unset: undefined }
}
],
{ ignoreUndefined: true }
);
const collection = client.db('test').collection('test');
collection.bulkWrite(
[
{
updateMany: {
filter: { age: { $lte: 5 } },
update: { $set: undefined, $unset: undefined }
}
}
],
{ ignoreUndefined: true }
);
collection.findOneAndUpdate(
{ a: 1 },
{ $set: undefined, $unset: undefined },
{ ignoreUndefined: true }
);
collection.updateOne({ a: 1 }, { $set: undefined, $unset: undefined }, { ignoreUndefined: true });
collection.updateMany({ a: 1 }, { $set: undefined, $unset: undefined }, { ignoreUndefined: true });
Socket errors are always treated as network errors
Network errors perform an important role in the driver, impacting topology monitoring processes and retryablity. A bug in the driver's socket implementation meant that in scenarios where server disconnects occurred while no operation was in progress on the socket resulted in errors that were not considered network errors.
Socket errors are now unconditionally treated as network errors.
Features
Bug Fixes