Docs Home → Develop Applications → MongoDB Manual
Binary.createFromBase64()
On this page
Definition
Creates a binary object from a base64 value.
Syntax
Binary.createFromBase64( <base64String> [ , <subType> ] )
Method Fields
The method accepts the following fields:
Field | Type | Description | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
base64String | String | Specifies a string that contains a base64 value. For example,
"SGVsbG8gV29ybGQhCg==". | ||||||||||||||||
subType | Integer | Optional. Specifies a binary subtype.
|
Examples
The following examples show how to add a binary object to a document
using Binary.createFromBase64() and how the binary object appears in
the output when retrieved.
Create Collection Containing Document with Binary Object
The following example creates a collection named
binaryObjectsFromBase64:
db.binaryObjectsFromBase64.insertOne( { _id: 0, binaryObject: Binary.createFromBase64( "SGVsbG8gV29ybGQhCg==" ) } )
The binaryObject field contains the binary object created from the
string specified in Binary.createFromBase64().
Retrieve Document from Collection with Binary Object
The following example retrieves the document:
db.binaryObjectsFromBase64.findOne( { _id: 0 } )
Note
Starting in mongosh 2.0.0, binary objects are shown
as Binary.createFromBase64( <base64String> ) values instead of
Binary( Buffer.from( <base64String> ) ) values. This only changes
the display of binary values.
Example output, starting in mongosh 2.0.0:
{ _id: 0, binaryObject: Binary.createFromBase64("SGVsbG8gV29ybGQhCg==") }