A really small, performant, zero-dependency, unicode-aware library for working with Strings in Node.js.

Javascript has a serious problem with unicode. Even ES6 can’t solve the problem entirely since some characters like the new colored emojis are three bytes instead of two bytes. Sometimes even more! "👍🏽".length returns 4 which is totally wrong (hint: it should be 1!). ES6's Array.from tried to solve this, but that even fails: Array.from("👍🏽") returns ["👍", "🏽"] which is incorrect. This library tries to tackle all these problems with a mega RegExp. Read More Here.

🎈 Based on a RegExp copied from the Lodash library.

• Limit string to width (truncate/pad)
• Unicode-aware string length
• Unicode-aware substring
• Unicode-aware substr
• Performant

$ npm install stringz --save

And import it in your awesome node app:

// ES2015+import*asstringzfrom'stringz';// OR:import{limit,substring,length,substr}from'stringz';// CommonJSvarstringz=require('stringz');// use like: stringz.limit ...

function limit(str[, limit[, padStr[, padPosition]]]) 

// Truncate:limit("Life’s like a box of chocolates.",20);// "Life's like a box of"// Pad:limit("Make emojis great again",26,"💩");// "Make emojis great again💩💩💩"limit("What are you looking at?",30,"+","left");// "++++++What are you looking at?"// Unicode Aware:limit("🤔🤔🤔",2);// "🤔🤔"limit("👍🏽👍🏽",4,"👍🏽");// "👍🏽👍🏽👍🏽👍🏽" 

function length(str) 

length("Iñtërnâtiônàlizætiøn☃💩");// 22

function substring(str, start[, end]) 

substring("Emojis 👍🏽 are 🍆 poison. 🌮s are bad.",7,14);// "👍🏽 are 🍆"

function substr(str[, start[, length]]) 

substr("A.C. Milan 🇮🇹⚽️",5,7);// "Milan 🇮🇹"

$ npm test

This library scores high in a length benchmark (it's intended usage) and should be fast for most use case.

Stringz .length (accruate) x 861,039 ops/sec ±1.57% (84 runs sampled) Lodash .toArray (accruate) x 795,108 ops/sec ±2.13% (82 runs sampled) Emoji Aware .split (inaccurate) x 2,269 ops/sec ±1.38% (85 runs sampled) Spliddit .length (inaccurate) x 487,718 ops/sec ±2.21% (83 runs sampled) UTF8 Length (inaccurate) x 232,918 ops/sec ±1.02% (87 runs sampled) Fastest is Stringz .length 

To run benchmarks yourself:

$ cd ./benchmark $ npm install $ node run.js

This software is released under the MIT License.

Uses a RegExp from the Lodash which is released under the MIT License.