locale-index-of

localeIndexOf

Find „cafe“ in „Fondation Café“

A prollyfill for String.prototype.localeIndexOf - a locale-aware Intl-powered version of indexOf.

Many texts out there contain accents and other diacritical characters, and when they are not strictly necessary, like in „café“, it is hard to match them against user input.

Here’s a relatable example. A website has a search field that provides suggestions, and the matched substring in each suggestion is highlighted. User has typed in „cafe“. You smartly find „café“ and display it as a suggestion. However you cannot really highlight it as a match, because the string is slightly different.

Intl.Comparator with sensitivity: base to the resque! Except that it only has a compare() method, not indexOf(). So you can’t use it to find substrings. Well, now you can. localeIndexOf can do some grinding for you. It is modeled after String.prototype.localeCompare and can be used in a similar fashion. It extends the functionality of Intl.Comparator.compare() to search, so you can even set ignorePunctuation: true.

Installation

npm install locale-index-of

Usage

var localeIndexOf = require('locale-index-of')(Intl);
localeIndexOf('a café', 'cafe', 'de', { sensitivity: base }); // = 2

or alternatively

require('locale-index-of').prollyfill();
'a café'.localeIndexOf('cafe', 'de', { sensitivity: base }); // = 2

API

default export require('locale-index-of')

The default export of a model is a function. Give it the Intl object and get the localeIndexOf function in return:

var localeIndexOf = require('locale-index-of')(Intl);

localeIndexOf(string, substring, locales, options)

It can take four parameters: where to search, what to look for, and the same locales and options as Intl.Collator or String.prototype.localeCompare.

Return value: the offset of substring in the string or -1.

localeIndexOf(string, substring, collator)

It can take three parameters: where to search, what to look for, and an instance of Intl.Collator.

Return value: the offset of substring in the string or -1.

prototypeLocaleIndexOf(Intl)

The module also exports method prototypeLocaleIndexOf. Give it the Intl object and get the localeIndexOf function in return, but suitable for putting on String.prototype:

String.prototype.localeIndexOf = require('locale-index-of').prototypeLocaleIndexOf(Intl);

prollyfill()

You can achieve the same effect by calling exported method prollyfill(). As a convenience, it will make String.prototype.localeIndexOf fall back to String.prototype.indexOf when Intl is not available.

String.prototype.localeIndexOf(substring, locales, options)

It can take three parameters: what to look for and the same locales and options as Intl.Collator or String.prototype.localeCompare.

Return value: the offset of substring in this or -1 when not found.

localeIndexOf(string, substring, collator)

It can take two parameters: what to look for and an instance of Intl.Collator.

Return value: the offset of substring in this or -1 when not found.

Note on ignorePunctuation: true

The default behavior of Intl.Collator is to consider the whitespace punctiation.

Since the length of the matched fragment can be different from the length of what you have looked for, this length is exposed on require('locale-index-of').noPunctuationIndexOf.lastLength.

See also

• Intl.Collator
• String.prototype.localeCompare