# MongoDB Node.js Driver v7.1.0

- Product: MongoDB Node.js Driver (https://whatsnew.fyi/product/mongodb-node-driver)
- Vendor: MongoDB
- Date: 2026-02-04
- Version: v7.1.0
- Original notes: https://github.com/mongodb/node-mongodb-native/releases/tag/v7.1.0
- Permalink: https://whatsnew.fyi/product/mongodb-node-driver/releases/v7.1.0

What's New is an index, not a publisher: every entry below links to the vendor's own release notes, which are the authoritative source. Entries are labelled where they are hand-curated sample data, pre-releases, or drawn from a secondary source such as a developer blog.

Reuse: the summaries, labels and curation here are © What's New. Quote freely with attribution and a link back; wholesale republication of the corpus is not permitted — terms: https://whatsnew.fyi/terms. The vendors' own release notes remain their publishers'.

---

- **removed** — aws4 package is no longer required for AWS authentication
- **changed** — Driver no longer relies on Node.js util.promisify() API for improved compatibility with alternate runtimes
- **changed** — Driver now explicitly imports node:process instead of relying on global.process
- **changed** — Replace process.arch with os.arch()
- **changed** — Replace process.platform with os.platform()
- **changed** — Replace os.endianness() with BSON.NumberUtils
- **changed** — Replace process.hrtime() with performance.now()
- **changed** — Replace process.nextTick() with queueMicrotask()
- **fixed** — Connection establishment failures no longer clear the pool, preventing unnecessary connection churn in server overload scenarios
- **changed** — withTransaction now applies exponential backoff during transaction retries
- **changed** — Server selection deprioritizes servers during retries
- **changed** — OIDC authentication now supports hosts matching *.mongo.com in its default ALLOWED_HOSTS list
- **fixed** — OIDC reauthentication now works with promoteValues: false
- **fixed** — Aggregations with write stages now correctly respect secondary and secondaryPreferred read preferences due to corrected commonWireVersion initialization
- **deprecated** — RenameCollectionOptions.new_collection option is deprecated and will be removed in a future major release

##### [7.1.0](https://github.com/mongodb/node-mongodb-native/compare/v7.0.0...v7.1.0) (2026-02-02)

The MongoDB Node.js team is pleased to announce version 7.1.0 of the `mongodb` package!

##### Release Notes


###### 🧩 Runtime and platform compatibility improvements

###### `aws4` package no longer required for AWS authentication

The [aws4](https://www.npmjs.com/package/aws4) package is no longer required to use AWS authentication, reducing the dependency footprint.

###### Usages of `util.promisify` have been removed

The driver no longer relies on Node.js’s `util.promisify()` API, which improves compatibility with alternate runtimes.

###### Explicit `node:process` import instead of `global.process`

The driver now explicitly imports `node:process` instead of relying on `global.process`, allowing bundlers and alternate runtimes to supply and optimize the `process` implementation more consistently.

###### Node-specific platform APIs replaced with standards-based equivalents

The driver replaces several Node-specific APIs with standards-based equivalents:

- `process.arch` → `os.arch()`  
- `process.platform` → `os.platform()`  
- `os.endianness()` → `BSON.NumberUtils`  
- `process.hrtime()` → `performance.now()`  
- `process.nextTick()` → `queueMicrotask()`

These changes reduce the number of patches required to run the driver outside of Node.js and improve compatibility with non-Node.js runtimes.

###### 🔁 Connection resilience and retry behavior improvements

###### Connection churn avoidance in server overload scenarios

When [server-side connection rate limiting](https://www.mongodb.com/docs/manual/reference/parameters/#mongodb-parameter-param.ingressConnectionEstablishmentRateLimiterEnabled) is enabled and the rate limiter kicks in under periods of high connection establishment,the driver will additionally churn connections by clearing the pool every time the rate limiter rejects an incoming connection request.

In this new driver release, connection establishment failures no longer clear the pool, preventing unnecessary connection churn in these scenarios.


###### `withTransaction` now applies exponential backoff during transaction retries

The convenient transaction API, `withTransaction`, now uses exponential backoff between retries when a transaction must be retried. Under high server load, this can help prevent transaction retry storms.

###### Server selection deprioritizes servers during retries

When retrying a command, the driver now deprioritizes servers during server selection, improving stability and reducing the likelihood of repeatedly targeting overloaded or previously failed servers.

###### 🔐 OIDC authentication improvements

###### Expanded the list of `ALLOWED_HOSTS` for OIDC

OIDC authentication now supports hosts matching `*.mongo.com` in its default `ALLOWED_HOSTS` list.

###### OIDC reauthentication now works with `promoteValues: false`

When `MongoClient` is configured with `promoteValues: false` (for applications that rely on raw BSON types), OIDC reauthentication now succeeds as expected.

###### ✅ Fixed read preference adherence for `$merge` and `$out` aggregations

Resolved an issue where the driver failed to detect MongoDB 5.0+ capabilities due to incorrect `commonWireVersion` initialization. As a result, aggregations with write stages now correctly respect `secondary` and `secondaryPreferred` read preferences, rather than forcing execution on the primary.

Huge thanks to @crehbichler for discovering and investigating this bug and for [implementing a fix](https://github.com/mongodb/node-mongodb-native/pull/4805)!

###### ⚠️ Deprecations

###### `RenameCollectionOptions.new_collection`

This option has been unused since driver 4.x. It is now deprecated and will be removed in a future major release. Existing code that sets this option can safely remove it with no behavioral change.


###### Features

* **NODE-5393:** aws4 no longer required for AWS authentication ([#4824](https://github.

_[Truncated at 4000 characters — full notes: https://github.com/mongodb/node-mongodb-native/releases/tag/v7.1.0]_