Docs Menu
Docs Home
/
MongoDB Shell
/
Reference
/
EJSON

EJSON.deserialize()

On this page

  • Syntax
  • Method Fields
  • Behavior
  • Example
  • Create the Example File
  • Import the Example File from the Command Line
  • Learn More

The EJSON.deserialize() method converts Extended JSON objects to BSON objects.

Syntax

The method has this syntax:

EJSON.deserialize( object, [ options ] )

Method Fields

The method takes the following fields:

Field
Type
Necessity
Description
object
EJSON object
Required
EJSON object to convert. For example, an array of documents.
options
string
Optional

Modifies the output object types. The only option is { relaxed: <boolean> }.

Boolean Value
Description
true
Return plain JavaScript object types. Default is true.
false
Return BSON object types.

Behavior

You can run EJSON.deserialize() from an interactive mongosh session or from the system command line using --eval.

To run EJSON.deserialize() from an interactive mongosh session, use:

EJSON.deserialize( object, [ options ] )

To run EJSON.deserialize() from the system command line, use:

mongosh --eval "EJSON.deserialize( object, [ options ] )"

Example

Create the sales collection:

db.sales.insertMany( [
   { custId: 345, purchaseDate: ISODate("2023-07-04"),
     quantity: 4, cost: Decimal128("100.60") },
   { custId: 346, purchaseDate: ISODate("2023-07-12"),
     quantity: 3, cost: Decimal128("175.45") },
   { custId: 486, purchaseDate: ISODate("2023-08-01"),
     quantity: 9, cost: Decimal128("200.53") }
] )

The following sections show how to create an example file and then import the file with an EJSON.deserialize() example.

Create the Example File

The following example retrieves the sales documents as an array and saves the results to a file named salesDeserialize.json on the computer's file system:

let salesCollection = EJSON.stringify( db.sales.find().toArray() )
fs.writeFileSync( 'salesDeserialize.json', salesCollection )

Import the Example File from the Command Line

To import the salesDeserialize.json file and create a new collection named salesFromDeserializeFile, exit mongosh and then run this example from the command line:

# Note: The example is formatted to fit the page.
mongosh --quiet  --eval "db.salesFromDeserializeFile.insertMany( \
   EJSON.deserialize( JSON.parse ( \
   fs.readFileSync( 'salesDeserialize.json', 'utf8' ) ) ) )"

In the example:

  • fs.readFileSync() reads the salesDeserialize.json file and interprets the content as utf8 Unicode character strings.

  • JSON.parse() converts the strings read from the file to JSON.

  • EJSON.deserialize() outputs JSON.

  • db.salesFromDeserializeFile.insertMany() creates and populates the salesFromDeserializeFile collection using the JSON returned by EJSON.deserialize().

Note

You could use EJSON.parse() in the previous example, which is a simpler approach. JSON.parse() and EJSON.deserialize() provide more flexibility.

Learn More

  • EJSON deserialize method

  • EJSON documentation

Back

EJSON

Next

EJSON.parse()

On this page