incremental-js-identifier v0.2.0

incremental-js-identifier

Utility to create incremental JS identifiers

Installation

# npm
npm install incremental-js-identifier --save-dev

# yarn
yarn add incremental-js-identifier --dev

Usage

const idGenerator = require('incremental-js-identifier');
const nextID = idGenerator();

nextID(); // -> A
nextID(); // -> B
nextID(); // -> C
...
nextID(); // -> _
nextID(); // -> AA
nextID(); // -> BA
...
nextID(); // -> $_
nextID(); // -> __
nextID(); // -> A0

API

idGenerator(options) ⇒ function

Returns a function that will return a new, incrementing identifier each time it is called without arguments, or an identifier created from a number defined as the first parameter.

Will throw if passed a number that was already used.

The incremental mode will skip any number that was already created.

Example

const idGenerator = require('incremental-js-identifier');

const nextPrefixedID = idGenerator({validFirstCharacters: '_'});
nextPrefixedID(); // -> _A
nextPrefixedID(); // -> _B
nextPrefixedID(); // -> _C