Provides a simple API to normalize texts, white-spaces, paragraphs & diacritics.
npm install normalize-text
Provides a simple API to normalize texts, white-spaces, names, paragraphs & diacritics (accents).
- 📦 Distributions in ESM, CommonJS, UMD and UMD _minified_ formats.
- Supports NodeJS ESM and CommonJS;
- ⚡ Lightweight:
- It's bundled with Rollup and Bublé.
- Smaller than 1KB (min + gzip).
- Supports _tree shaking_.
- 🔋 Bateries included:
- Its not based on newer browser's APIs or es2015+ features.
- Only needs String.prototype.normalize polyfill for older browsers, and don't crashes without it.
- 🏷 Safe:
- Type declarations for IDEs and editor's autocomplete/intellisense.
- Made with TypeScript as strict as possible.
- Unit tests with Jest.
- Travis CI that keeps tests running.
normalize-text is published under NPM registry, so you can install using any Node.js package manager.
``sh
npm install normalize-text --save
$3
The bundles of this module are also available on JSDelivr and UNPKG CDNs.
In both you can import just the bundle you want or use default one, UMD.
html
`Usage
All the functions are named exported from module.
js
import { normalizeText } from 'normalize-text';normalizeText([
'Olá\r\n',
' como está a senhorita?'
]);
//=> "ola como esta a senhorita?"
`API
$3
Capitalize first character of received text.
js
capitalizeFirstLetter('vitorLuizC');
//=> "VitorLuizC"
`$3
If
is supported it normalizes diacritics by replacing them with "clean" character from received text.> It doesn't normalize special characters.
`js
normalizeDiacritics('Olá, você aí');
//=> 'Ola, voce ai'normalizeDiacritics('àáãâäéèêëíìîïóòõôöúùûüñçÀÁÃÂÄÉÈÊËÍÌÎÏÓÒÕÔÖÚÙÛÜÑÇ');
//=> "aaaaaeeeeiiiiooooouuuuncAAAAAEEEEIIIIOOOOOUUUUNC"
normalizeDiacritics('@_$><=-#!,.
\'"');'\"";
`$3
Normalize received name by normalizing it's white-spaces and capitalizing first letter of every word but exceptions (received in lower-case).
js
normalizeName(' fernanDA MONTENEGRO');
//=> "Fernanda Montenegro"normalizeName(' wilson da costa', ['da']);
//=> "Wilson da Costa"
`$3
Normalize a paragraph by normalizing its white-spaces, capitalizing first letter and adding a period at end.
js
normalizeParagraph(' once upon a time');
//=> "Once upon a time."normalizeParagraph('hello world, my friend\r\n');
// => 'Hello world, my friend.'
`$3
Resolve received texts (when receives an
) by normalizing its white-spaces and its diacritics and transforming to lower-case.`js
normalizeText(' so there\'s a Way to NORMALIZE ');
//=> "so there\'s a way to normalize"normalizeText(['Olá\r\n', 'como está a senhorita?']);
//=> "ola como esta a senhorita?"
`$3
Normalize all white-space characters and remove trailing ones received text.
js
normalizeWhiteSpaces(' What exactly is it? ');
//=> "What exactly is it?"normalizeWhiteSpaces('Hi, how is \r\n everything \t?');
//=> 'Hi, how is everything ?'
normalizeWhiteSpaces
It is ${temperature}\n degree\r outside.
//=> 'It is 25 degree outside.'
Released under MIT license. You can see it here.