n1k0 / normalize-diacritics

Normalize diacritics in strings

normalize-diacritics

Remove accents/ diacritics in string

---

Simple NPM package to remove any accents/ diacritics found in a string.

Table of contents

• Pre-requisite
• Install
• Usage
  • TypeScript or ES Modules
  • Browser
• Demo
• deno
• API Reference
  • normalize([input])
  • normalizeSync([input])
• Contributing
  • Code of Conduct
• License

Pre-requisite

• Node.js >= 14.17.3
• NPM >= 6.14.13 (NPM comes with Node.js so there is no need to install separately.)
• ES Modules

Install

# Install via NPM
$ npm i normalize-diacritics

Usage

TypeScript or ES Modules

import { normalize } from 'normalize-diacritics';

/** Assuming top-level await is enabled... */
await normalize('söme stüff with áccènts'); // 'some stuff with accents'

Browser

<script type="module">
  import { normalize } from 'https://cdn.skypack.dev/normalize-diacritics@latest';
  
  // --snip
</script>

Demo

deno

👉 Check out the deno module at deno_mod/normalize_diacritics.

API Reference

normalize([input])

• input <?string> Optional input string that contains accents/ diacritics.
• returns: <Promise<string>> Promise which resolves with normalized input string.

This method normalizes any accents/ diacritics found in a given input string and output a normalized string as a result.

normalizeSync([input])

This methods works the same as normalize([input]) except that this is the synchronous version.

Contributing

Code of Conduct

Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.

License

MIT License © Rong Sen Ng