mongo-objectid

1.2.2 • Public • Published

Mongo-ObjectID

NPM Version Build Status

A MongoDB specification based implementation of ObjectID

Goal is to provide a correct MongoDB ObjectID implementation, in order to ensure impossibility to create similar entries on fast generation (as saw on other open source package)

Table of Contents

Installation

npm install mongo-objectid

Usage

mkdir myproject
cd myproject
npm init
npm install mongo-objectid
touch index.js

And there just use that snipets to start playing ! :

const ObjectId = require('mongo-objectid');
const id = new ObjectId();

Documentation

API

constructor([hexid])

toString()

Returns the ID

.isValid()

Validate the ID against specification.

.setMachineId([machineId])

This will set a new machine id and regenerate new id (careful, timevalue also change with this process).

  • machineId : optional - Allow to pass a specific machine id value;

.generateNew([time])

Allow to generate a new ID

  • time : default : Date.now() - Allow to pass a specific time value

.getDate()

Return the Date object corresponding to the time of the ObjectID creation

.getTimestamp()

Return the timestamp in ms corresponding to the time of ObjectID creation

FAQ :

Why node engine v.12 limitation

For development purpose, I decided that being able to console view the object without all the nested parent thing was handy a clean.
That's the only reason. But Node V.12 is old enough already, no point sticking to the past.

Readme

Keywords

Package Sidebar

Install

npm i mongo-objectid

Weekly Downloads

373

Version

1.2.2

License

MIT

Unpacked Size

10.5 kB

Total Files

14

Last publish

Collaborators

  • alex-werner