v5.0.0-alpha.0

🚧 Testing Build Only

This alpha build is intended for internal testing only. Adopt at your own risk.

Changes listed in HISTORY.md.

5.0.0-alpha.0 diff 4.7.0 (2022-12-16)

v4.7.0

The MongoDB Node.js team is pleased to announce version 4.7.0 of the bson package!

Release Highlights

This release adds automatic UUID support. Now when serializing or deserializing BSON you can work directly with the UUID type without explicit conversion methods. The UUID class is now a subclass of binary so all existing code will continue to work (including the explicit conversion methods .toUUID/.toBinary). The same automatic support for UUID is also present in EJSON .parse/.stringify.

Take a look at the following for the expected behavior:

const document = BSON.deserialize(bytes)
// { uuid: UUID('xxx') }
BSON.serialize(document)
// Buffer < document with uuid (binary subtype 4) >

Special thanks to @aditi-khare-mongoDB for all her hard work on this feature!! 🎉

Features

• NODE-4405: support serializing UUID class (#508) (f5dc9ed)
• NODE-4419: UUID class deserialization (#509) (ff2b975)
• NODE-4506: Make UUID a subclass of binary (#512) (e9afa9d)
• NODE-4535: automatically promote UUIDs when deserializing and parsing UUIDs (#513) (1dc7eae)

---

Documentation

• API: https://github.com/mongodb/js-bson#readme
• Changelog: https://github.com/mongodb/js-bson/blob/main/HISTORY.md#change-log

We invite you to try the bson library immediately, and report any issues to the NODE project.

v4.6.5

The MongoDB Node.js team is pleased to announce version 4.6.5 of the bson package!

Release Highlights

Along with some other bug fixes listed below in this release we've fixed the float parser logic for both deserialize and serialize to use JS Dataview APIs. The most delightful part of this change is an improvement to performance of serializing 64-bit floats. 🎉 🐎

- cpu: Apple M1
- cores: 8
- os: darwin
- ram: 16GB
- iterations: 1,000,000
testing: Double Serialization

current           - v 4.6.5 - avg 0.00024913ms
previous release  - v 4.6.4 - avg 0.00036335ms
previous major    - v 1.1.6 - avg 0.00036459ms

Bug Fixes

• NODE-3630: remove float parser and test edge cases for Double (#502) (54ca603)
• NODE-4211: Do not require crypto in browser builds (#500) (b32ab40)
• NODE-4302: remove downlevel ts and typesVersions (#501) (651b60e)
• NODE-4381: handle __proto__ well in EJSON (#506) (4bda57d)

Documentation

• API: https://github.com/mongodb/js-bson#readme
• Changelog: https://github.com/mongodb/js-bson/blob/main/HISTORY.md#change-log

We invite you to try the bson library immediately, and report any issues to the NODE project.

v4.6.4

The MongoDB Node.js team is pleased to announce version 4.6.4 of the bson package!

Performance

• perf(NODE-4194): improve objectId constructor performance (#498)

Documentation

• API: https://github.com/mongodb/js-bson#readme
• Changelog: https://github.com/mongodb/js-bson/blob/main/HISTORY.md#change-log

We invite you to try the bson library immediately, and report any issues to the NODE project.

v4.6.3

The MongoDB Node.js team is pleased to announce version 4.6.3 of the bson package!

Release Highlights

This release improves documentation for BSON type classes by adding an @category tag to the doc comments.

Documentation

• API: https://github.com/mongodb/js-bson#readme
• Changelog: https://github.com/mongodb/js-bson/blob/main/HISTORY.md#change-log

We invite you to try the bson library immediately, and report any issues to the NODE project.

v4.6.2

The MongoDB Node.js team is pleased to announce version 4.6.2 of the bson package!

Release Highlights

This release includes a few fixes to the ObjectId class, including performance improvements in ObjectId.equals.

Bug Fixes

• MONGOSH-1155: update error message in ObjectId class (#493) (67fbc7c)
• NODE-3015: ObjectId.equals should use Buffer.equals for better performance (#478) (8305bdf)
• NODE-3962: correct type for ObjectiId._bsontype (#480) (9671773)

Documentation

• API: https://github.com/mongodb/js-bson#readme
• Changelog: https://github.com/mongodb/js-bson/blob/main/HISTORY.md#change-log

We invite you to try the bson library immediately, and report any issues to the NODE project.

v4.6.1

The MongoDB Node.js team is pleased to announce version 4.6.1 of the bson package!

Release Highlights

This release includes a few fixes to the validation checks in some of our constructors.

Bug Fixes

• NODE-3760: ObjectId.isValid string and byte length match (#475) (187d1c4)
• NODE-3815: update Decimal128 constructor validation (#476) (95e8293)
• NODE-3821: nullish check before using toBSON override function (#477) (1d898b6)

Documentation

• API: https://github.com/mongodb/js-bson#readme
• Changelog: https://github.com/mongodb/js-bson/blob/master/HISTORY.md#change-log

We invite you to try the bson library immediately, and report any issues to the NODE project.

v4.6.0

The MongoDB Node.js team is pleased to announce version 4.6.0 of the bson package!

Release Highlights

This release adds a new BSON validation option that allows top-level keys to have utf-8 validation disabled or enabled, either on a global or key-specific scale, rather than defaulting to automatic utf-8 validation across all keys. Additionally, it includes a bug fix which allows BSONError and BSONTypeError to be checked with instanceof checks.

Features

• NODE-3740: Implement root and top level key utf-8 validation settings for BSON (#472) (07019a0)

Bug Fixes

• NODE-3724: Fix BSONTypeError and BSONError to correctly handle instanceof checks (#471) (d8f334b)

Documentation

• API: https://github.com/mongodb/js-bson#readme
• Changelog: https://github.com/mongodb/js-bson/blob/master/HISTORY.md#change-log

We invite you to try the bson library immediately, and report any issues to the NODE project.

v4.5.4

The MongoDB Node.js team is pleased to announce version 4.5.4 of the bson package!

Release Highlights

This release notably includes a fix to the ObjectId constructor ensuring correct handling of invalid input.

Bug Fixes

• NODE-3640: Fix Int32 constructor to coerce its argument to int32 (#466) (d388f1e)
• NODE-3662: error checking to make sure that ObjectId results in object with correct properties (#467) (5f99b1b)

Documentation

• API: https://github.com/mongodb/js-bson#readme
• Changelog: https://github.com/mongodb/js-bson/blob/master/HISTORY.md#change-log

We invite you to try the bson library immediately, and report any issues to the NODE project.

v4.5.3

The MongoDB Node.js team is pleased to announce version 4.5.3 of the bson package!

Release Highlights

This release includes a few minor changes for spec compliance, primarily around validation, as detailed below:

Bug Fixes

• NODE-3493: code and symbol tests are partially testing the wrong types (#459) (80d7f03)
• NODE-3534: add subtype 0x6 and 0x7 constants on Binary class (#461) (52cfe9c)
• NODE-3629: correct corpus runner and add null checks (#464) (d75102d)

Documentation

• API: https://github.com/mongodb/js-bson#readme
• Changelog: https://github.com/mongodb/js-bson/blob/master/HISTORY.md#change-log

We invite you to try the bson library immediately, and report any issues to the NODE project.