Skip to content

Repository files navigation

fast-format

Circle CI

This is a string formatter like util.format() method in Node.js, supports just only %s placeholder but accordingly faster than that. It will be one of the best solution if need a speed rather than complex formatting.

Usage

Same as util.format() method.

format(formatString[, ...])

If use one formatting repeatedly, recommended to compile the formatString in advance.

format.compile(formatString)

Example

lets=format('%s, %s!','Hello','world');console.log(s);// => 'Hello, world!'
letf=format.compile('%s, %s!');lets1=f('Hello','world');console.log(s1);// => 'Hello, world!'lets2=f('Howdy','World');console.log(s2);// => 'Howdy, World!'

Benchmark

// Bench 1lets=Date.now();for(leti=0,len=100000000;i<len;i++){format('i = %s, len = %s',i,len);}console.log(Date.now()-s);
// Bench 2lets=Date.now();letf=format.compile('i = %s, len = %s');for(leti=0,len=100000000;i<len;i++){f(i,len);}console.log(Date.now()-s);

environment1: Core i7 2.2GHz + Node.js v6.9.5

moduletimebench
fast-format12,388 msec2
fast-format22,039 msec1
util.format28,659 msec1

environment2: Core i7 2.2GHz + Google Chrome 56.0.2924.87

moduletimebench
fast-format12,898 msec2
fast-format22,705 msec1
util.format99,103 msec1

The util.format() method was converted with Browserify to run on the browser.

Installation

via npm

npm install fast-format --save

via Bower

bower install fast-format

directly (in case of the browser)

<scriptsrc="/path/to/fast-format.min.js"></script>

Browser Support

Google Chrome, Firefox, Safari, Opera, Microsoft Edge and IE 6+

License

MIT

About

A fast, simple string formatter like util.format() method in Node.js

Resources

Stars

6 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages