Stringz

A really small, performant, 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.

Features

Unicode-aware string manipulation tools
High performance

Install

$ npm install stringz --save

And import it in your awesome node app:

// ES2015+
import * as stringz from 'stringz'; // OR:
import { limit, substring, length, substr } from 'stringz';

// CommonJS
const stringz = require('stringz'); // OR:
const { limit, substr } = require('stringz');

Limit String to Width

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

Param	Type	Default	Description
str	`String`	none	The string to be limited
limit	`Number`	`16`	Desired string length
padStr	`String`	`"#"`	Character to pad the output with
padPosition	`String`	`"right"`	Pad position: `"right"` or `"left"`

Examples

// Truncate:
limit('Life’s like a box of chocolates.', 20); // "Life's like a box of"

// Pad:
limit('Everybody loves emojis!', 26, '????'); // "Everybody loves emojis!????????????"
limit('What are you looking at?', 30, '+', 'left'); // "++++++What are you looking at?"

// Unicode Aware:
limit('????????????', 2); // "????????"
limit('????????????????', 4, '????????'); // "????????????????????????????????"

String Length

function length(str)

Param	Type	Default	Description
str	`String`	none	String to return the length for

Examples

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

Substring

function substring(str, start[, end])

Param	Type	Default	Description
str	`String`	none	String to be devided
start	`Number`	none	Start position
end	`Number`	End of string	End position

Examples

substring('Emojis ???????? are ???? poison. ????s are bad.', 7, 14); // "???????? are ????"

Substr

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

Param	Type	Default	Description
str	`String`	none	String to be devided
start	`Number`	Start of string	Start position
length	`Number`	String length minus `start` parameter	Length of result

Examples

substr('A.C. Milan ????????⚽️', 5, 7); // "Milan ????????"

IndexOf

function indexOf(str[, searchStr[, position]])

Param	Type	Default	Description
str	`String`	none	String to get index
searchStr	`String`	none	String to be searched
position	`Number`	0	Start of searching

Examples

indexOf('Emojis ???????? are ???? poison. ????s are bad.', 'are'); // 9
indexOf('Emojis ???????? are ???? poison. ????s are bad.', 'are', 10); // 26

ToArray

function toArray(str)

Param	Type	Default	Description
str	`String`	none	String to convert to array

Examples

toArray('????????????????'); // ['????????', '????', '????']

Test

$ npm test

Benchmark

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

Stringz .length (accurate) x 861,039 ops/sec ±1.57% (84 runs sampled)
Lodash .toArray (accurate) 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

Changelog

Moved to CHANGELOG.md

License

This software is released under the MIT License.

Current Tags

2.1.0 ... latest (6 years ago)

Stringz

Features

Install

Usage

Limit String to Width

Examples

String Length

Examples

Substring

Examples

Substr

Examples

IndexOf

Examples

ToArray

Examples

Test

Benchmark

Changelog

License

Current Tags

12 Versions