Class: MongoClient

Methods

staticMongoClient.connect(url, options, callback){Promise.<MongoClient>}

lib/mongo_client.js, line 473

Connect to MongoDB using a url as documented at

docs.mongodb.org/manual/reference/connection-string/

Note that for replicasets the replicaSet query parameter is required in the 2.0 driver

Name	Type	Description
url	string	The connection URI string
options	object	optional Optional settings Name Type Default Description poolSize number 5 optional The maximum size of the individual server pool ssl boolean false optional Enable SSL connection. sslValidate boolean true optional Validate mongod server certificate against Certificate Authority sslCA buffer optional SSL Certificate store binary buffer sslCert buffer optional SSL Certificate binary buffer sslKey buffer optional SSL Key file binary buffer sslPass string optional SSL Certificate pass phrase sslCRL buffer optional SSL Certificate revocation list binary buffer autoReconnect boolean true optional Enable autoReconnect for single server instances noDelay boolean true optional TCP Connection no delay keepAlive boolean true optional TCP Connection keep alive enabled keepAliveInitialDelay boolean 30000 optional The number of milliseconds to wait before initiating keepAlive on the TCP socket connectTimeoutMS number 30000 optional TCP Connection timeout setting family number null optional Version of IP stack. Can be 4, 6 or null (default). If null, will attempt to connect with IPv6, and will fall back to IPv4 on failure socketTimeoutMS number 360000 optional TCP Socket timeout setting reconnectTries number 30 optional Server attempt to reconnect #times reconnectInterval number 1000 optional Server will wait # milliseconds between retries ha boolean true optional Control if high availability monitoring runs for Replicaset or Mongos proxies haInterval number 10000 optional The High availability period for replicaset inquiry replicaSet string optional The Replicaset set name secondaryAcceptableLatencyMS number 15 optional Cutoff latency point in MS for Replicaset member selection acceptableLatencyMS number 15 optional Cutoff latency point in MS for Mongos proxies selection connectWithNoPrimary boolean false optional Sets if the driver should connect even if no primary is available authSource string optional Define the database to authenticate against w number | string null optional The write concern wtimeout number null optional The write concern timeout j boolean false optional Specify a journal write concern forceServerObjectId boolean false optional Force server to assign _id values instead of driver serializeFunctions boolean false optional Serialize functions on any object ignoreUndefined Boolean false optional Specify if the BSON serializer should ignore undefined fields raw boolean false optional Return document results as raw BSON buffers bufferMaxEntries number -1 optional Sets a cap on how many operations the driver will buffer up before giving up on getting a working connection, default is -1 which is unlimited readPreference ReadPreference | string null optional The preferred read preference (ReadPreference.PRIMARY, ReadPreference.PRIMARY_PREFERRED, ReadPreference.SECONDARY, ReadPreference.SECONDARY_PREFERRED, ReadPreference.NEAREST) pkFactory object null optional A primary key factory object for generation of custom _id keys promiseLibrary object null optional A Promise library class the application wishes to use such as Bluebird, must be ES6 compatible readConcern object null optional Specify a read concern for the collection (only MongoDB 3.2 or higher supported) Name Type Default Description level string 'local' optional Specify a read concern level for the collection operations, one of [local|majority]. (only MongoDB 3.2 or higher supported) maxStalenessSeconds number optional The max staleness to secondary reads (values under 10 seconds cannot be guaranteed) loggerLevel string optional The logging level (error/warn/info/debug) logger object optional Custom logger object promoteValues boolean true optional Promotes BSON values to native types where possible, set to false to only receive wrapper types promoteBuffers boolean false optional Promotes Binary BSON values to native Node Buffers promoteLongs boolean true optional Promotes long values to number if they fit inside the 53 bits resolution domainsEnabled boolean false optional Enable the wrapping of the callback in the current domain, disabled by default to avoid perf hit checkServerIdentity boolean | function true optional Ensure we check server identify during SSL, set to false to disable checking. Only works for Node 0.12.x or higher. You can pass in a boolean or your own checkServerIdentity override function validateOptions object false optional Validate MongoClient passed in options for correctness appname string optional The name of the application that created this MongoClient instance. MongoDB 3.4 and newer will print this value in the server log upon establishing each connection. It is also recorded in the slow query log and profile collections auth.user string optional The username for auth auth.password string optional The password for auth authMechanism string optional Mechanism for authentication: MDEFAULT, GSSAPI, PLAIN, MONGODB-X509, SCRAM-SHA-1 or MONGODB-CR compression object null optional Type of compression to use: snappy or zlib fsync boolean false optional Specify a file sync write concern readPreferenceTags array null optional Read preference tags numberOfRetries number 5 optional The number of retries for a tailable cursor auto_reconnect boolean true optional Enable auto reconnecting for single server instances minSize number optional If present, the connection pool will be initialized with minSize connections, and will never dip below minSize connections
callback	MongoClient~connectCallback	optional The command result callback

Returns:

Promise if no callback passed

close(force, callback){Promise}

lib/mongo_client.js, line 310

Close the db and its underlying connections

Name	Type	Description
force	boolean	Force close, emitting no events
callback	Db~noResultCallback	optional The result callback

Returns:

Promise if no callback passed

connect(callback){Promise.<MongoClient>}

lib/mongo_client.js, line 253

Connect to MongoDB using a url as documented at

docs.mongodb.org/manual/reference/connection-string/

Note that for replicasets the replicaSet query parameter is required in the 2.0 driver

Name	Type	Description
callback	MongoClient~connectCallback	optional The command result callback

Returns:

Promise if no callback passed

db(dbName, options){Db}

lib/mongo_client.js, line 353

Create a new Db instance sharing the current socket connections. Be aware that the new db instances are
related in a parent-child relationship to the original instance so that events are correctly emitted on child
db instances. Child db instances are cached so performing db('db1') twice will return the same instance.
You can control these behaviors with the options noListener and returnNonCachedInstance.

Name	Type	Default	Description
dbName	string		The name of the database we want to use.
options	object	null	optional Optional settings. Name Type Default Description noListener boolean false optional Do not make the db an event listener to the original connection. returnNonCachedInstance boolean false optional Control if you want to return a cached instance or have a new one created

isConnected(options){boolean}

lib/mongo_client.js, line 395

Check if MongoClient is connected

Name	Type	Default	Description
options	object	null	optional Optional settings. Name Type Default Description noListener boolean false optional Do not make the db an event listener to the original connection. returnNonCachedInstance boolean false optional Control if you want to return a cached instance or have a new one created

logout(options, callback){Promise}

lib/mongo_client.js, line 284

Logout user from server, fire off on all connections and remove all auth info

Name	Type	Default	Description
options	object	null	optional Optional settings. Name Type Default Description dbName string null optional Logout against different database than current.
callback	Db~resultCallback		optional The command result callback

Returns:

Promise if no callback passed

startSession(options){ClientSession}

lib/mongo_client.js, line 491

Starts a new session on the server

Name	Type	Description
options	object	optional optional settings for a driver session

Returns:

newly established session

Type Definitions

connectCallback(error, client)

lib/mongo_client.js, line 235

The callback format for results

Name	Type	Description
error	MongoError	An error instance representing the error during the execution.
client	MongoClient	The connected client.