node package manager
Orgs are free. Discover, share, and reuse code in your team. Create a free org »

short-id

short-id

Self-contained short-life ID generating module

Not guarenteed to be unique outside of a single instance of the module.

Install

$ npm install short-id

Usage

var ids = require('short-id');
 
ids.generate();  // "aeaf15" 
ids.generate();  // "1d0449" 
 
ids.store('foo');  // "8dbd46" 
ids.fetch('8dbd46');  // 'foo' 
 
ids.invalidate('8dbd46');
ids.fetch('8dbd46');  // undefined 

ids.generate ( void )

Generates a new ID string and returns it.

ids.invalidate ( String key )

Invalidates the given id key, removing any data stored with it and recycling it.

ids.store ( mixed value )

Generates a new key and stores a value under that key.

ids.fetch ( String key )

Looks up a value stored under the given key.

ids.fetchAndInvalidate ( String key )

The equivilent of calling fetch and then invalidate. Returns the stored value.

ids.configure ( Object conf )

Changes configuration values.

// Call to configure shown with the default values 
ids.configure({
    length: 6,          // The length of the id strings to generate 
    algorithm: 'sha1',  // The hashing algoritm to use in generating keys 
    salt: Math.random   // A salt value or function 
});