mongosh Changelog¶

v1.0¶

Released July 9, 2021

New features in this release:

• All the static methods of the Node.js driver BSON classes are now available. Specifically, you can use ObjectId.createFromTime(unixTimestampSeconds) instead of the legacy shell’s ObjectId.fromDate(dateObj).
• When connected to an Atlas deployment, the default mongosh prompt displays Atlas instead of Enterprise.
• The cursor referred to when using it is cleared when either db is reassigned or db.auth() / db.logout() is called.
• Minor bug fixes and improvements.

v0.15.4¶

Released July 1, 2021

New features in this release:

• mongosh now color coordinates matching brackets.

v0.15.3¶

Released June 25, 2021

New features in this release:

• mongosh now shows the current database name in prompt by default.

v0.15.1¶

Released June 22, 2021

New features in this release:

• .tar and .zip mongosh download archives now include a parent directory.
• Autocomplete is now aware of the --apiStrict flag. When --apiStrict is true, autocomplete only completes methods that work with your defined API version. For more information, see Versioned API.

Bug fixes in this release:

• mongosh can now connect to a replica set containing unhealthy nodes.

v0.14.0¶

Released May 28, 2021

New features in this release:

• When you run show collections, the type of collection is shown in the output.
• Adds sh.reshardCollection() for resharding support.
• Adds inspectCompact option to the configuration API to print each document field on its own line.

v0.13.1¶

Released May 18, 2021

New features in this release:

• When you use Ctrl+C to interrupt an operation, you interrupt operations that are running on the server, and not just local JavaScript execution.
• .editor sessions are aggregated into one item in shell history.
• Build and publish packages for all platforms in the current MongoDB 5.0 server support matrix.
• Publish Windows MSI to the download center.
• Adds a customizable REPL prompt using prompt (or your .mongoshrc.js file).
• When running against a MongoDB 5.0 deployment, shows reasons for document validation failures.
• Adds basic support for the --apiStrict flag.

v0.12.1¶

Released April 30, 2021

New features in this release:

• Adds support for the db.hello() shell method and hello database command. Use these commands in place of isMaster.
• Extends the shell customization API to allow controlling log verbosity.
• Adds autocomplete for show and use commands. For example, show collections and use test.

Bug fixes in this release:

• collStats now works properly on sharded collections.

v0.12.0¶

Released April 23, 2021

• New async rewriter, allowing for a much wider range of JavaScript features in the shell.
• Connection failure response is now more prompt if a connection is deemed unlikely to succeed.
• Adds new API for shell customization.

v0.11.0¶

Released April 8, 2021

Internal improvements and various bug fixes.

v0.10.1¶

Released April 1, 2021

Internal improvements.

v0.10.0¶

Released March 31, 2021

New features in this release:

• Support for loading a .mongoshrc.js file at startup. Use this file to bootstrap the shell with customizations and extended functionality.
• Ability to load scripts from the command line.
• Support for --eval option.
• Support for --tlsCertificateSelector on Windows and macOS.

Bug fixes in this release:

• Objects in explain output now properly expand.

v0.9.0¶

Released March 10, 2021

New features in this release:

• Support for the load() method.
• Support for AWS IAM authentication.

Bug fixes in this release:

• Autocomplete works properly when connected to secondary node.
• db.createUser() on $external database now handles password properly.
• Miscellaneous other improvements.

v0.8.2¶

Released February 24, 2021

Minor internal improvements and bug fixes.

v0.8.1¶

Released February 22, 2021

Minor internal improvements and bug fixes.

v0.8.0¶

Released February 17, 2021

New features in this release:

• Support for Client-Side Field Level Encryption.

Bug fixes in this release:

• Running setReadConcern no longer reverses db.auth() authentication operations.
• Pressing the backspace key in the password prompt no longer adds an asterisk, and now behaves as expected.
• Running UUID() without a value now generates a random UUID.

v0.7.7¶

Released February 3, 2021

New features in this release:

• explain() support for the following methods:

  • count()
  • distinct()
  • findAndModify()
  • remove()
  • update()
• Support for specifying cursor.batchSize(), and type it for more.
• Autocomplete for collection names.

Bug fixes in this release:

• mongosh no longer fails when connecting to a node in the STARTUP2 state.
• mongosh now properly displays startup warnings.
• explain() on aggregations now return accurate and complete results.

v0.6.1¶

Released November 30, 2020

New features in this release:

• Support for readPreference methods.
• Support for the session object and related session object methods.
• Support for transaction methods.

Bug fixes and miscellaneous updates in this release:

• Remove support for deprecated 3.6 CRUD methods (insert(), remove(), save(), and update()).
• Fix an issue with loading JavaScript files into mongosh.
• Fix an issue where when inserting many documents via a for loop, the loop would abort before all documents were inserted.
• Fix issue with output when printing result of a cursor.
• Update the Node REPL to use Node version 14.

v0.5.2¶

Released November 11, 2020

• Autocomplete now works properly when connected to a MongoDB 4.4.1 deployment.
• The sh.status() method now outputs correctly in the browser shell.

v0.5.0¶

Released October 12, 2020

• Adds support for replica set management methods.
• Adds support for sharded cluster management methods.

v0.4.2¶

Released October 1, 2020

• Adds support for collection names with a dot. For example, to query a collection named my.collection, you can run:

  db.my.collection.findOne()

v0.4.0¶

Released September 15, 2020

• Adds support for the following methods:

  • db.collection.mapReduce()
  • db.collection.validate()
• Adds support for maxAwaitTimeMS for cursors.

v0.3.1¶

Released September 14, 2020

v0.2.2¶

Released August 31, 2020

Past Releases¶

For information on past releases, refer to mongosh Releases on GitHub.