node-eval-interpolation-sandbox
Interpolate strings with sandboxed JS code
Example
parseTemplate = // 'John' // 'John Locke' // '1; 2; 3' context = i:0 names: "John" "Paul" // '1 - John'// '2 - Paul'
Install
npm install eval-interpolation-sandbox
API
To get the synchronous parser function with default options, just import the package root:
parseTemplate = result = // 'Paul Jefferson'
To get the asynchronous parser, or set custom defalut options
ParserSync = parseTemplateParserSyncParserAsync = parseTemplateParserAsync parserAsync = delimiter: "\#{" "}" parserAsync // '42'
ParserAsync([opts])
opts
is an object with the default values of the same options passed to parseTemplate
parseTemplate( template, context, [opts,] callback )
template
is the string containing the tokens that will be evaluated.
context
is the object containing the values that will be available for the tokens.
callback(err,res)
opts
is an object which can receive the following options:
-
sandbox
(default: false)Clones the context before parsing each token, thereby isolating the context for each token.
-
ignore
(default: false)Ignores errors while parsing the template. The callback will return a list of errors, and the formatted string with the placeholders where the errors occurred replaced by blank space.
-
delimiter
(default:"`"
)Defines the symbol that delimits both sides of the placeholders within the string. Accepts a string, which will define both delimiters, or an array with two strings, which will define the left and right delimiters, respectively.
ParserSync([opts])
The same as ParserAsync
, with parseTemplate
being synchronous and not accepting
the ignore
option.
parseTemplate( template, context, [opts] )
opts
: {sandbox=0, delimiter="`"}