Merge branch '9.0' into codex/remove-nolistener-option-from-code

Author: vkarpov15

.eslintrc.js

@@ -39,7 +39,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        node: [16, 18, 20, 22, 24]
+        node: [18, 20, 22, 24]
         os: [ubuntu-22.04, ubuntu-24.04]
         mongodb: [6.0.15, 7.0.12, 8.0.0]
         include:

.github/workflows/test.yml

@@ -1,3 +1,10 @@
+8.18.2 / 2025-09-22
+===================
+ * fix(document): prevent $clone() from converting mongoose arrays into vanilla arrays #15633 #15625
+ * fix(connection): use correct collection name for model when using useConnection() #15637
+ * fix(connection): propagate changes to _lastHeartbeatAt to useDb() child connections #15640 #15635
+ * types: fix schema property type definition in SchemaType #15631
+
 8.18.1 / 2025-09-08
 ===================
  * types: correct type inference for maps of maps #15602

CHANGELOG.md

@@ -1,37 +1,4 @@
 # Mongoose in the Browser
 
-Mongoose supports creating schemas and validating documents in the browser.
-Mongoose's browser library does **not** support saving documents, [queries](http://mongoosejs.com/docs/queries.html), [populate](http://mongoosejs.com/docs/populate.html), [discriminators](http://mongoosejs.com/docs/discriminators.html), or any other Mongoose feature other than schemas and validating documents.
-
-Mongoose has a pre-built bundle of the browser library. If you're bundling your code with [Webpack](https://webpack.js.org/), you should be able to import Mongoose's browser library as shown below if your Webpack `target` is `'web'`:
-
-```javascript
-import mongoose from 'mongoose';
-```
-
-You can use the below syntax to access the Mongoose browser library from Node.js:
-
-```javascript
-// Using `require()`
-const mongoose = require('mongoose/browser');
-
-// Using ES6 imports
-import mongoose from 'mongoose/browser';
-```
-
-## Using the Browser Library {#usage}
-
-Mongoose's browser library is very limited. The only use case it supports is validating documents as shown below.
-
-```javascript
-import mongoose from 'mongoose';
-
-// Mongoose's browser library does **not** have models. It only supports
-// schemas and documents. The primary use case is validating documents
-// against Mongoose schemas.
-const doc = new mongoose.Document({}, new mongoose.Schema({
-  name: { type: String, required: true }
-}));
-// Prints an error because `name` is required.
-console.log(doc.validateSync());
-```
+As of Mongoose 9, [Mongoose's browser build is now in the `@mongoosejs/browser` npm package](https://github.com/mongoosejs/mongoose-browser).
+The documentation has been moved to the [`@mongoosejs/browser` README](https://github.com/mongoosejs/mongoose-browser?tab=readme-ov-file#mongoosejsbrowser).

browser.js

@@ -18,20 +18,13 @@ Below are the [semver](http://semver.org/) ranges representing which versions of
 
 | MongoDB Server |                    Mongoose                    |
 | :------------: | :--------------------------------------------: |
-|     `8.x`      |                    `^8.7.0`                    |
-|     `7.x`      |               `^7.4.0 \| ^8.0.0`               |
-|     `6.x`      |          `^6.5.0 \| ^7.0.0 \| ^8.0.0`          |
-|     `5.x`      |   `^5.13.0` \| `^6.0.0 \| ^7.0.0 \| ^8.0.0`    |
-|    `4.4.x`     |    `^5.10.0 \| ^6.0.0 \| ^7.0.0 \| ^8.0.0`     |
-|    `4.2.x`     |     `^5.7.0 \| ^6.0.0 \| ^7.0.0 \| ^8.0.0`     |
-|    `4.0.x`     | `^5.2.0 \| ^6.0.0 \| ^7.0.0 \| ^8.0.0 <8.16.0` |
-|    `3.6.x`     | `^5.0.0 \| ^6.0.0 \| ^7.0.0 \| ^8.0.0 <8.8.0`  |
-|    `3.4.x`     |               `^4.7.3 \| ^5.0.0`               |
-|    `3.2.x`     |               `^4.3.0 \| ^5.0.0`               |
-|    `3.0.x`     |         `^3.8.22 \| ^4.0.0 \| ^5.0.0`          |
-|    `2.6.x`     |          `^3.8.8 \| ^4.0.0 \| ^5.0.0`          |
-|    `2.4.x`     |               `^3.8.0 \| ^4.0.0`               |
+|     `8.x`      |                 `^8.7.0 | ^9.0.0`              |
+|     `7.x`      |            `^7.4.0 \| ^8.0.0 \| ^9.0.0`        |
+|     `6.x`      |            `^7.0.0 \| ^8.0.0 \| ^9.0.0`        |
+|     `5.x`      |            `^6.0.0 \| ^7.0.0 \| ^8.0.0`        |
+|    `4.4.x`     |            `^6.0.0 \| ^7.0.0 \| ^8.0.0`        |
+|    `4.2.x`     |            `^6.0.0 \| ^7.0.0 \| ^8.0.0`        |
+|    `4.0.x`     |       `^6.0.0 \| ^7.0.0 \| ^8.0.0 <8.16.0`     |
+|    `3.6.x`     |       `^6.0.0 \| ^7.0.0 \| ^8.0.0 <8.8.0`      |
 
 Mongoose `^6.5.0` also works with MongoDB server 7.x. But not all new MongoDB server 7.x features are supported by Mongoose 6.x.
-
-Note that Mongoose `5.x` dropped support for all versions of MongoDB before `3.0.0`. If you need to use MongoDB `2.6` or older, use Mongoose `4.x`.