Global Modules

JSON Web Tokens (utils.jwt)

You can create and read JSON Web Tokens with the utils.jwt interface.

utils.jwt.encode()

Generates an encoded JSON Web Token string for the payload based on the specified signingMethod and secret.

utils.jwt.encode(
   signingMethod: string,
   payload: object,
   secret: string,
   customHeaderFields: object
): string

Parameter	Type	Description
signingMethod	string	The cryptographic algorithm to use when encoding the JWT. Atlas App Services supports the following JWT signing methods: Signing Method Description "HS256" HMAC using SHA-256 "HS384" HMAC using SHA-384 "HS512" HMAC using SHA-512 "RS256" RSASSA-PKCS1-v1_5 using SHA-256 "RS384" RSASSA-PKCS1-v1_5 using SHA-384 "RS512" RSASSA-PKCS1-v1_5 using SHA-512 "ES256" ECDSA using P-256 and SHA-256 "ES384" ECDSA using P-384 and SHA-384 "ES512" ECDSA using P-512 and SHA-512 "PS256" RSASSA-PSS using SHA-256 and MGF1 with SHA-256 "PS384" RSASSA-PSS using SHA-384 and MGF1 with SHA-384 "PS512" RSASSA-PSS using SHA-512 and MGF1 with SHA-512
payload	object	A JSON object that specifies the token's claims and any additional related data.
secret	string	A secret string that App Services uses to sign the token. The value of the string depends on the signing method that you use: Signing Methods Description "HS256" "HS384" "HS512" A random string. "RS256" "RS384" "RS512" An RSA-SHA private key in PKCS#8 format. "PS256" "PS384" "PS512" An RSA-PSS private key in PKCS#8 format. "ES256" "ES384" "ES512" An ECDSA private key in PKCS#8 format.
customHeaderFields	object	A JSON object that specifies additional fields to include in the JWT's JOSE header.

Returns:	A JSON Web Token string encoded for the provided payload.

Example

Consider the following JWT claims object:

{
  "sub": "1234567890",
  "name": "Joe Example",
  "iat": 1565721223187
}

We can encode the claims object as a JWT string by calling utils.jwt.encode(). The following function encodes the JWT using the HS512 signing method and the secret "SuperSecret":

exports = function() {
  const signingMethod = "HS512";
  const payload = {
    "sub": "1234567890",
    "name": "Joe Example",
    "iat": 1565721223187
  };
  const secret = "SuperSecret";
  return utils.jwt.encode(signingMethod, payload, secret);
}

HIDE OUTPUT

"eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvZSBTY2htb2UiLCJpYXQiOjE1NjU3MjEyMjMxODd9.-QL15ldu2BYuJokNWT6YRiwZQIiIpvq6Kyv-C6qslNdNiUVxo8zqLJZ1iEkNf2yZKMIrQuMCtIC1tzd2H31AxA"

utils.jwt.decode()

Decodes the payload of the provided JSON Web Token string. The value of key must correspond to the secret value that was used to encode the JWT string.

utils.jwt.decode(
   jwtString: string,
   key: string,
   returnHeader: boolean
): object

Parameter	Type	Description
jwtString	string	A JSON Web Token string that encodes a set of claims signed with a secret value.
key	string	A string that App Services uses to verify the token signature. The value of the string depends on the signing method that you use: Signing Methods Description "HS256" "HS384" "HS512" The random string that was used to sign the token. "RS256" "RS384" "RS512" The RSA-SHA public key that corresponds to the private key that was used to sign the token. "PS256" "PS384" "PS512" The RSA-PSS public key that corresponds to the private key that was used to sign the token. "ES256" "ES384" "ES512" The ECDSA public key that corresponds to the private key that was used to sign the token.
returnHeader	boolean	If true, return the JWT's JOSE header in addition to the decoded payload.
acceptedSigningMethods	string[]	Optional. Array of accepted signing methods. For example, ["PS256", "HS256"]. This argument should be included to prevent against known JWT security vulnerabilities.

Returns:	If returnHeader is false, returns the decoded EJSON payload. If returnHeader is true, returns an object that contains the JOSE header in the header field and the decoded EJSON payload in the payload field. { "header": { "<JOSE Header Field>": <JOSE Header Value>, ... }, "payload": { "<JWT Claim Field>": <JWT Claim Value>, ... } }

Example

Consider the following signed JWT string:

"eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvZSBTY2htb2UiLCJpYXQiOjE1NjU3MjEyMjMxODd9.-QL15ldu2BYuJokNWT6YRiwZQIiIpvq6Kyv-C6qslNdNiUVxo8zqLJZ1iEkNf2yZKMIrQuMCtIC1tzd2H31AxA"

The JWT was signed using the HS512 signing method with the secret value "SuperSecret". We can decode the JWT's claims object utils.jwt.decode(). The following function decodes the JWT string into an EJSON object:

exports = function(jwtString) {
  const key = "SuperSecret";
  return utils.jwt.decode(jwtString, key, false, ["HS512"]);
}

HIDE OUTPUT

{
  "sub": "1234567890",
  "name": "Joe Example",
  "iat": { "$numberDouble": 1565721223187 }
}

Cryptography (utils.crypto)

You can encrypt, decrypt, sign, and verify data using cryptographic algorithms with the utils.crypto interface.

utils.crypto.encrypt()

Generates an encrypted text string from the provided text using the specified encryption method and key.

utils.crypto.encrypt(
  encryptionType: string,
  message: string,
  key: string
): BSON.Binary

Parameter	Type	Description
encryptionType	string	The type of encryption with which to encrypt the message. The following encryption types are supported: AES Encryption ("aes")
message	string	The text string that you want to encrypt.
key	string	A cryptographic key used to encrypt the text. The key you should use depends on the encryption method: Encryption Type Encryption Key AES A 16-byte, 24-byte, or 32-byte random string

Returns:	A BSON Binary object that contains the text string encrypted with the specified encryption type and key.

Example

Assume that we have defined a value named aesEncryptionKey that contains the following 32-byte AES encryption key:

"603082712271C525E087BD999A4E0738"

With this AES key, we can encrypt a message into a base64 string using the following function:

exports = function() {
  const message = "MongoDB is great!"
  const key = context.values.get("aesEncryptionKey");
  const encryptedMessage = utils.crypto.encrypt("aes", message, key);
  return encryptedMessage.toBase64();
}

HIDE OUTPUT

"WPBuIvJ6Bity43Uh822dW8QlVYVJaFUiDeUjlTiJXzptUuTYIKPlXekBQAJb"

utils.crypto.decrypt()

Decrypts the provided text string using the specified encryption type and key. If both the encryption type and key are the same as those used to encrypt, this returns the original, unencrypted text.

utils.crypto.decrypt(
  encryptionType: string,
  encryptedMessage: BSON.Binary,
  key: string
): BSON.Binary

Parameter	Type	Description
encryptionType	string	The type of encryption that was used to encrypt the provided text. The following encryption types are supported: AES Encryption ("aes")
encryptedMessage	BSON.Binary	A BSON Binary that encodes the encrypted text string that you want to decrypt.
key	string	A cryptographic key used to decrypt the text. The key you should use depends on the encryption type: Encryption Type Encryption Key AES A 16-byte, 24-byte, or 32-byte random string

Returns:	A BSON Binary object that contains the decrypted message. If the provided encrypted message was encrypted with the specified method and key, then the decrypted message is identical to the original message.

Example

Assume that we have defined a Value named aesEncryptionKey that contains the following 32-byte AES encryption key:

"603082712271C525E087BD999A4E0738"

We can use this AES key to decrypt any base64 string that was encrypted with the same key using the following function:

exports = function(encryptedMessage) {
  // The encrypted message must be a BSON.Binary
  if(typeof encryptedMessage === "string") {
    encryptedMessage = BSON.Binary.fromBase64(encryptedMessage)
  }
  const key = context.values.get("aesEncryptionKey");
  const decryptedMessage = utils.crypto.decrypt("aes", encryptedMessage, key);
  return decryptedMessage.text();
}

HIDE OUTPUT

"MongoDB is great!"

utils.crypto.sign()

Generates a cryptographically unique signature for a message using a private key. The signature can be verified with the corresponding public key to ensure that the signer has access to the private key and that the message content has not been altered since it was signed.

utils.crypto.sign(
  encryptionType: string,
  message: string,
  privateKey: string,
  signatureScheme: string
): BSON.Binary

Parameter	Type	Description
encryptionType	string	The type of encryption that was used to generate the private/public key pair. The following encryption types are supported: RSA Encryption ("rsa")
message	string	The text string that you want to sign.
privateKey	string	A private key generated with the specified encryption type. Important Key Format Not all RSA keys use the same format. App Services can only sign messages with a private key that conforms to the standard PKCS#1 format. Private keys in this format have the header -----BEGIN RSA PRIVATE KEY-----. You can use the following shell script to generate a valid RSA private/public key pair and save each key to its own text file: # Generate an RSA SSH key pair # Save the key to a file called `rsa_key` when prompted ssh-keygen -t rsa -m PEM -b 2048 -C "2048-bit RSA Key" # Private Key cat rsa_key > rsa.private.txt # Public Key ssh-keygen -f rsa_key.pub -e -m pem > rsa.public.txt
signatureScheme	string	Optional. Default: "pss" The padding scheme that the signature should use. App Services supports signing messages with the following schemes: Probabilistic signature scheme ("pss") PKCS1v1.5 ("pkcs1v15")

Returns:	A BSON.Binary cryptographic signature for the message signed using the specified private key.

Example

Assume that we have defined a value named rsaPrivateKey that contains the following RSA private key:

-----BEGIN RSA PRIVATE KEY-----
MIICXAIBAAKBgQDVsEjse2qO4v3p8RM/q8Rqzloc1lee34yoYuKZ2cemuUu8Jpc7
KFO1+aJpXdbSPZNhGLdANn8f2oMIZ1R9hgEJRn/Qm/YyC4RPTGg55nzHqSlziNZJ
JAyEUyU7kx5+Kb6ktgojhk8ocZRkorM8FEylkrKzgSrfay0PcWHPsKlmeQIDAQAB
AoGAHlVK1L7kLmpMbuP4voYMeLjYE9XdVEEZf2GiFwLSE3mkJY44033y/Bb2lgxr
DScOf675fFUAEK59ATlhxfu6s6rgx+g9qQQ+mL74YZWPqiZHBPjyMRaBalDVC4QF
YJ+DopFcB8hY2ElXnbK70ALmVYNjw3RdmC97h0YfOsQcWW0CQQD18aeuPNicVnse
Ku22vvhvQYlabaQh4xdkEIxz1TthZj48f61wZwEMipYqOAc5XEtDlNnxgeipv0yF
RHstUjwXAkEA3m0Br/U/vC9evuXppWbONana08KLgfELyd3Uw9jG7VKJZTBH5mS8
7CB68aEF8egrJpo8Ss8BkWrvCxYDb4Y77wJAUlbOMZozVtvpKidrIFR9Lho91uWA
Hsw9h4W20AzibXBig7SnJ0uE4WMAdS/+0yhgFkceVCmO8E2YW8Gaj4jJjwJASxtg
AHy+ItuUEL4uIW4Pn8tVW0BMP3qX0niXyfI/ag/+2S5uePv3V3y4RzNqgH83Yved
+FziWKpVQdcTHeuj/QJBAJl1G3WFruk0llIoKKbKljaEiCm1WCTcuEPbdOtkJYvO
9ZYQg/fji70FERkq2KHtY7aLhCHzy0d4n9xgE/pjV+I=
-----END RSA PRIVATE KEY-----

With this RSA key, we can sign a message using the following function:

exports = function() {
  const message = "MongoDB is great!"
  const rsaPrivateKey = context.values.get("rsaPrivateKey");
  const signature = utils.crypto.sign("rsa", message, rsaPrivateKey, "pss");
  return signature.toBase64();
}

HIDE OUTPUT

"SpfXcJwPbypArt+XuYQyuZqU52YCAY/sZj2kiuin2b6/RzyM4Ek3n3spOtqZJqxn1tfQavxIX4V+prbs74/pOaQkCLekl9Hoa1xOzSKcGoRd8U+n1+UBY3d3cyODGMpyr8Tim2HZAeLPE/D3Q36/K+jpgjvrJFXsJoAy5/PV7iEGV1fkzogmZtXWDcUUBBTTNPY4qZTzjNhL4RAFOc7Mfci+ojE/lLsNaumUVU1/Eky4vasmyjqunm+ULCcRmgWtGDMGHaQV4OXC2LMUe9GOqd3Q9ghCe0Vlhn25oTh8cXoGpd1Fr8wolNa//9dUqSM+QYDpZJXGLShX/Oa8mPwJZKDKHtqrS+2vE6S4dDWR7zKDza+DeovOeCih71QyuSYMXSz+WWGgfLzv/syhmUXP/mjqgLmJU6Kwg5htajDoylpzLC0BLGT4zDZEwBrq/AjwRs/EPjYdFgGCt1WCbbVlDyXvvH1ekDrzACzumhiMSZNNa+ZH3JmMJxTCQWDfiTeAfkauaaZHKIj2q2/QE7vuAhNcVPJ2YgpXnvnQHJpEZBc/Y3Q6JLxom6+cGC4P//9d++r2cwzXIkqD+wSGZVSVtpm5CLtWMRSK5FX2dv16bM+LE8ozoRvtMUDTrQ8SSSDGxyuYbvN9b2fYYPcWpCMchqOBXV6eZGoMldaHX3Qy5h8="

utils.crypto.verify()

Checks that the provided signature is valid for the specified message and public key.

If the signature is valid, it guarantees that the signer has access to the corresponding private key and that the message content has not been altered since it was signed.

utils.crypto.verify(
  encryptionType: string,
  message: string,
  publicKey: string,
  signature: BSON.Binary,
  signatureScheme: string
): boolean

Parameter	Type	Description
encryptionType	string	The type of encryption that was used to generate the private/public key pair. The following encryption types are supported: RSA Encryption ("rsa")
message	string	The text string for which you want to verify the signature. If the signature is valid, this is the exact message that was signed.
publicKey	string	The public key for which you want to verify the signature. If the signature is valid, this is the corresponding public key of the private key that was used to sign the message. Important Key Format Not all RSA keys use the same format. App Services can only verify signatures with RSA keys that conform to the standard PKCS#1 format. Public keys in this format have the header -----BEGIN RSA PUBLIC KEY-----. You can use the following shell script to generate a valid RSA private/public key pair and save each key to its own text file: # Generate an RSA SSH key pair # Save the key to a file called `rsa_key` when prompted ssh-keygen -t rsa -m PEM -b 2048 -C "2048-bit RSA Key" # Private Key cat rsa_key > rsa.private.txt # Public Key ssh-keygen -f rsa_key.pub -e -m pem > rsa.public.txt
signature	BSON.Binary	The signature that you want to verify.
signatureScheme	string	Optional. Default: "pss" The padding scheme that the signature uses. App Services supports verifying signatures that use the following schemes: Probabilistic signature scheme ("pss") PKCS1v1.5 ("pkcs1v15")

Returns:	A boolean that, if true, indicates whether or not the signature is valid for the provided message and public key.

Example

We received a message with a signature in BSON.Binary format and want to verify that the message was signed with the private key that corresponds to the sender's RSA public key:

-----BEGIN RSA PUBLIC KEY-----
MIGJAoGBANWwSOx7ao7i/enxEz+rxGrOWhzWV57fjKhi4pnZx6a5S7wmlzsoU7X5
omld1tI9k2EYt0A2fx/agwhnVH2GAQlGf9Cb9jILhE9MaDnmfMepKXOI1kkxDIRT
JTuTHn4pvqS2CiOGTyhxlGSiszwUTKWSsrOBKt9rLQ9xYc+wqWZ5AgMBAAE=
-----END RSA PUBLIC KEY-----

With this RSA key, we can verify a message signed with the correspdoning private key using the following function:

exports = function() {
  const rsaPublicKey = context.values.get("rsaPublicKey");
  const message = "MongoDB is great!"
  const signature = BSON.Binary.fromBase64("SpfXcJwPbypArt+XuYQyuZqU52YCAY/sZj2kiuin2b6/RzyM4Ek3n3spOtqZJqxn1tfQavxIX4V+prbs74/pOaQkCLekl9Hoa1xOzSKcGoRd8U+n1+UBY3d3cyODGMpyr8Tim2HZAeLPE/D3Q36/K+jpgjvrJFXsJoAy5/PV7iEGV1fkzogmZtXWDcUUBBTTNPY4qZTzjNhL4RAFOc7Mfci+ojE/lLsNaumUVU1/Eky4vasmyjqunm+ULCcRmgWtGDMGHaQV4OXC2LMUe9GOqd3Q9ghCe0Vlhn25oTh8cXoGpd1Fr8wolNa//9dUqSM+QYDpZJXGLShX/Oa8mPwJZKDKHtqrS+2vE6S4dDWR7zKDza+DeovOeCih71QyuSYMXSz+WWGgfLzv/syhmUXP/mjqgLmJU6Kwg5htajDoylpzLC0BLGT4zDZEwBrq/AjwRs/EPjYdFgGCt1WCbbVlDyXvvH1ekDrzACzumhiMSZNNa+ZH3JmMJxTCQWDfiTeAfkauaaZHKIj2q2/QE7vuAhNcVPJ2YgpXnvnQHJpEZBc/Y3Q6JLxom6+cGC4P//9d++r2cwzXIkqD+wSGZVSVtpm5CLtWMRSK5FX2dv16bM+LE8ozoRvtMUDTrQ8SSSDGxyuYbvN9b2fYYPcWpCMchqOBXV6eZGoMldaHX3Qy5h8=")
  const isValid = utils.crypto.verify("rsa", message, rsaPublicKey, signature, "pss");
  return isValid; // true if the signature matches, else false
}

HIDE OUTPUT

true

utils.crypto.hmac()

Generates an HMAC signature from the provided input and secret. This is useful when communicating with third-party HTTP services that require signed requests.

utils.crypto.hmac(
  input: string,
  secret: string,
  hash_function: string,
  output_format: string
): string

Parameter	Type	Description
input	string	The input for which you would like to generate a signature.
secret	string	The secret key to use when generating the signature.
hash_function	string	The name of the hashing function to use when generating the signature. The following functions are supported: "sha1", "sha256", "sha512".
output_format	string	The format of the generated signature. Can be either "hex" for a hex string, or "base64" for a Base64 string.

Returns:	The signature of the input, in the format specified by output_format.

Example

The following function generates a sha256 signature as a base 64 string:

exports = function() {
  const signature = utils.crypto.hmac(
    "hello!",
    "super-secret",
    "sha256",
    "base64"
  )
  return signature
}

HIDE OUTPUT

"SUXd6PRMaTXXgBGaGsIHzaDWgTSa6C3D44lRGrvRak0="

utils.crypto.hash()

Generates a hash value for the provided input using the specified hash function.

utils.crypto.hash(
  hash_function: string,
  input: string | BSON.Binary
): BSON.Binary

Parameter	Type	Description
hash_function	string	The name of the hashing function. The following functions are supported: "sha1", "sha256", "md5".
input	string or BSON.Binary	Required. The input for which you would like to generate a hash value.

Returns:	A BSON.Binary object that encodes the hash value for the provided input generated by the specified hashing function.

Example

The following function hashes an input string with sha256:

exports = function() {
  return utils.crypto.hash(
    "sha256",
    "hello!"
  )
}

HIDE OUTPUT

"zgYJL7lI2f+sfRo3bkBLJrdXW8wR7gWkYV/vT+w6MIs="

BSON.ObjectId

The BSON.ObjectId type represents a 12-byte MongoDB ObjectId identifier.

BSON.ObjectId()

Constructs a BSON.ObjectId object that encodes an ObjectId

new BSON.ObjectId(id: string)

Parameter	Type	Description
id	string	Optional. A 12-byte string or a string of 24 hex characters.

Returns:	A BSON.ObjectId object that encodes the specified ObjectId string or a generated ObjectId string if none was specified.

Example

const objectId = new BSON.ObjectId("5e58667d902d38559c802b13");
const generatedObjectId = new BSON.ObjectId();

BSON.BSONRegExp

The BSON.BSONRegExp type represents a regular expression. You can use a BSON.BSONRegExp object with the $regex query operator to perform a regular expression query on a MongoDB collection.

BSON.BSONRegExp()

Constructs a BSON.BSONRegExp object from a regular expression string. You can optionally specify configuration flags.

BSON.BSONRegExp(pattern: string, flags: string)

Parameter	Type	Description
pattern	string	A regular expression pattern.
flags	string	Optional. One or more regular expression flags.

Returns:	A BSON.BSONRegExp object that encodes the provided regular expression pattern and flags.

Example

const regex = BSON.BSONRegExp("the great", "ig");

BSON.Binary

The BSON.Binary type represents a binary-encoded data string.

BSON.Binary.fromHex()

Constructs a BSON.Binary object from data represented as a hexadecimal string.

BSON.Binary.fromHex(
  hexString: string,
  subType?: number
): BSON.Binary

Parameter	Type	Description
hexString	string	A byte aligned string of hexadecimal characters (0-9 and A-F).
subType	integer	Optional. The type of data encoded in the hexadecimal string. The value must be in the range 0-255 where 0, the default value, represents a generic binary. For a full list of supported subtypes, refer to the BSON specification.

Returns:	A BSON.Binary object that encodes the provided hexadecimal string.

Example

const binary = BSON.Binary.fromHex("54657374206d65737361676520706c656173652069676e6f7265=");

BSON.Binary.prototype.toHex()

Converts the BSON.Binary object into a hexadecimal string.

BSON.Binary.prototype.toHex(): string

Returns:	A hexadecimal string representation of the provided BSON.Binary object.

Example

export = function() {
  const binary = BSON.Binary.fromHex(
     "54657374206d65737361676520706c656173652069676e6f7265="
   );
  const hexString = binary.toHex();
  return hexString
}

HIDE OUTPUT

"54657374206d65737361676520706c656173652069676e6f7265="

BSON.Binary.fromBase64()

Constructs a BSON.Binary object from data represented as a base64 string.

BSON.Binary.fromBase64(
  base64String: string,
  subType?: number
): BSON.Binary

Parameter	Type	Description
base64String	string	A string of base64 encoded characters. Note String Padding The base64-encoded string must include either one or two equals signs (=), referred to as "padding", at the end of the string. BSON.Binary.fromBase64() does not support unpadded strings.
subType	integer	Optional. The type of data encoded in the hexadecimal string. The value must be in the range 0-255 where 0, the default value, represents a generic binary. For a full list of supported subtypes, refer to the BSON specification.

Returns:	A BSON.Binary object that encodes the provided base64 string.

Example

const binary = BSON.Binary.fromBase64("VGVzdCBtZXNzYWdlIHBsZWFzZSBpZ25vcmU=");

BSON.Binary.prototype.toBase64()

Converts a BSON.Binary object into a base64 string.

BSON.Binary.prototype.toBase64(): string

Returns:	A base64 string representation of the BSON.Binary object.

Example

const binary = BSON.Binary.fromBase64("VGVzdCBtZXNzYWdlIHBsZWFzZSBpZ25vcmU=");
const base64String = binary.toBase64();

BSON.Binary.prototype.text()

Converts the BSON.Binary object into a UTF-8 string.

BSON.Binary.prototype.text(): string

Returns:	A UTF-8 string representation of the provided BSON.Binary object.

Example

const binary = BSON.Binary.fromBase64("VGVzdCBtZXNzYWdlIHBsZWFzZSBpZ25vcmU=");
const decodedString = binary.text();

BSON.MaxKey

The BSON.MaxKey type represents a value that compares higher than all other BSON values.

await collection.findOne({ date: { $lt: BSON.MaxKey } });

BSON.MinKey

The BSON.MinKey type represents a value that compares lower than all other BSON values.

await collection.findOne({ date: { $gt: BSON.MinKey } });

BSON.Int32

The BSON.Int32 type represents a 32-bit signed integer.

BSON.Int32()

Constructs a BSON.Int32 object from a 32-bit number.

BSON.Int32(low32: number): BSON.Int32

Parameter	Type	Description
low32	number	A 32-bit number.

Returns:	A BSON.Int32 object that encodes the specified integer. Returns 0 if no arguments are supplied.

Example

const int32 = BSON.Int32(42);

BSON.Long

The BSON.Long type represents a 64-bit signed integer.

BSON.Long(low32, high32)

BSON.Long(low32: number, high32: number): BSON.Long

Constructs a BSON.Long object from two 32-bit integers that represent the low 32 bits and the high 32 bits in the 64-bit Long integer.

Parameter	Type	Description
low32	integer	Optional. The long integer's 32 low bits. These bits represent the least significant digits of the number.
high32	integer	Optional. The long integer's 32 high bits. These bits represent the most significant digits of the number.

Returns:	A BSON.Long object that encodes the specified integer. Returns 0 if no arguments are supplied. BSON.Long encodes using the following formula: (high32 * (2**32)) + low32

Example

const long = BSON.Long(600206158, 342);

BSON.Double

The BSON.Double type represents a 64-bit (8-byte) floating point number.

BSON.Double(double)

Constructs a BSON.Double object from a 64-bit decimal value.

BSON.Double(double: number): BSON.Double

Parameter	Type	Description
double	number	A 64-bit decimal value.

Returns:	A BSON.Double object that encodes the specified double. Returns 0 if no argument is supplied.

Example

const double = BSON.Double(1234.5678);

BSON.Decimal128

The BSON.Decimal128 type represents a 128-bit (16-byte) floating point number. This type is intended for use cases where decimal values must round exactly, e.g. financial data.

BSON.Decimal128.fromString(decimalString)

Constructs a BSON.Decimal128 from a string representation of a decimal number.

BSON.Decimal128(decimalString: string): BSON.Decimal128

Parameter	Type	Description
decimalString	string	A string representing a decimal number, e.g. "1234.5678910123456".

Returns:	A BSON.Decimal128 that encodes the provided decimal value.

Example

const double = BSON.Decimal128.fromString("1234.5678910123456");