mongodb objectid utilities

npm install objectid
2 downloads in the last day
42 downloads in the last week
280 downloads in the last month


mongodb objectid utilities


1.x is probably the version you want to use in a browser. 3.x focuses on compatibility with the npm mongodb driver.


$ npm install objectid


var objectid = require('objectid')

var id = objectid()

// => true

// => false

objectid.isValid returns true for mongodb native driver ObjectID objects, or any other representations with a .toString method which returns the hex string encoding of a valid objectid.

Calling objectid with an existing objectid - whether a string, an object created by this module, an objectid created by another driver (such as the result of a query) - will cast the value to an instanceof this module. It will throw if the argument is not a valid ObjectId.

Static Methods

ObjectId.equals(oidA, oidB) => Boolean

Curried to support creating equality predicates.

ObjectId.tryParse(oid, out, as) => Boolean

ObjectId.isValid(oid) => Boolean

Instance Methods

ObjectId#equals(oidB) => Boolean

ObjectId#toString() => String

ObjectId#toJSON() => String

running the tests

From package root:

$ npm install
$ npm test


jden jason@denizac.org @leJDen


MIT. (c) 2013 Agile Diagnosis hello@agilediagnosis.com See LICENSE.md

npm loves you