transliterate

Convert Unicode characters to Latin characters using transliteration

Can be useful for slugification purposes and other times you cannot use Unicode.

Install

$ npm install @sindresorhus/transliterate

Usage

1import transliterate from '@sindresorhus/transliterate';
2
3transliterate('Fußgängerübergänge');
4//=> 'Fussgaengeruebergaenge'
5
6transliterate('Я люблю единорогов');
7//=> 'Ya lyublyu edinorogov'
8
9transliterate('أنا أحب حيدات');
10//=> 'ana ahb hydat'
11
12transliterate('tôi yêu những chú kỳ lân');
13//=> 'toi yeu nhung chu ky lan'

API

transliterate(string, options?)

string

Type: string

String to transliterate.

options

Type: object

customReplacements

Type: Array<string[]>
Default: []

Add your own custom replacements.

The replacements are run on the original string before any other transformations.

This only overrides a default replacement if you set an item with the same key.

1import transliterate from '@sindresorhus/transliterate';
2
3transliterate('Я люблю единорогов', {
4	customReplacements: [
5		['единорогов', '🦄']
6	]
7})
8//=> 'Ya lyublyu 🦄'

Supported languages

Most major languages are supported.

This includes special handling for:

• Arabic
• Armenian
• Czech
• Danish
• Dhivehi
• Georgian
• German (umlauts)
• Greek
• Hungarian
• Latin
• Latvian
• Lithuanian
• Macedonian
• Pashto
• Persian
• Polish
• Romanian
• Russian
• Serbian
• Slovak
• Swedish
• Turkish
• Ukrainian
• Urdu
• Vietnamese

However, Chinese is currently not supported.

Related

• slugify - Slugify a string