var Tokens = require('map-tokens');
var tokens = new Tokens('foo "bar" baz quux');
 
// tokenize anything in double quotes
tokens.pattern(/\"([^\"]+?)\"/);
 
// replace tokens with temporary IDs
tokens.extract();
//=> 'foo "__TOKEN_IDFOBV3I__" baz quux'
 
// Run a replacement on the string while the IDs are in place.
// Even though our regex specifies `bar`, `bar` won't be replaced
// since it was replaced with an ID.
tokens.content = tokens.content.replace(/foo|bar/g, 'AAA');
//=> 'AAA "__TOKEN_IDFOBV3I__" baz quux'
 
// last, retore the tokens
tokens.restore();
console.log(tokens.result);
//=> 'AAA "bar" baz quux'

var tokens = new Tokens();
 
tokens.restore('abc __TOKEN_ID9H8AY1__ __TOKEN_IDLDO84N__ jkl', {
  tokens: {
    __TOKEN_ID9H8AY1__: 'def',
    __TOKEN_IDLDO84N__: 'ghi'
  }
});
 
console.log(tokens.result);
//=> 'abc def ghi jkl'

var Tokens = require('map-tokens');
var tokens = new Tokens(string);

tokens.pattern(/def/);

tokens.pattern(/def/);

tokens.extract();
// or
tokens.extract([/def/]);

tokens.restore();
// or
tokens.restore(obj);