?HAMA

Edit File Size: 4.74 KB

//proc/thread-self/root/home/byroehnu/.trash/node_modules11/i18next-browser-languagedetector/README.md

Text Base64

# Introduction

[![npm version](https://img.shields.io/npm/v/i18next-browser-languagedetector.svg?style=flat-square)](https://www.npmjs.com/package/i18next-browser-languagedetector)

This is a i18next language detection plugin use to detect user language in the browser with support for:

- cookie (set cookie i18next=LANGUAGE)
- sessionStorage (set key i18nextLng=LANGUAGE)
- localStorage (set key i18nextLng=LANGUAGE)
- navigator (set browser language)
- querystring (append `?lng=LANGUAGE` to URL)
- htmlTag (add html language tag <html lang="LANGUAGE" ...)
- path (http://my.site.com/LANGUAGE/...)
- subdomain (http://LANGUAGE.site.com/...)

# Getting started

Source can be loaded via [npm](https://www.npmjs.com/package/i18next-browser-languagedetector), bower or [downloaded](https://github.com/i18next/i18next-browser-languagedetector/blob/master/i18nextBrowserLanguageDetector.min.js) from this repo.

```
# npm package
$ npm install i18next-browser-languagedetector

# bower
$ bower install i18next-browser-languagedetector
```

- If you don't use a module loader it will be added to `window.i18nextBrowserLanguageDetector`

Wiring up:

```js
import i18next from 'i18next';
import LanguageDetector from 'i18next-browser-languagedetector';

i18next.use(LanguageDetector).init(i18nextOptions);
```

As with all modules you can either pass the constructor function (class) to the i18next.use or a concrete instance.

## Detector Options
*The default options can be found [here](https://github.com/i18next/i18next-browser-languageDetector/blob/9efebe6ca0271c3797bc09b84babf1ba2d9b4dbb/src/index.js#L11).*

```js
{
  // order and from where user language should be detected
  order: ['querystring', 'cookie', 'localStorage', 'sessionStorage', 'navigator', 'htmlTag', 'path', 'subdomain'],

// keys or params to lookup language from
  lookupQuerystring: 'lng',
  lookupCookie: 'i18next',
  lookupLocalStorage: 'i18nextLng',
  lookupSessionStorage: 'i18nextLng',
  lookupFromPathIndex: 0,
  lookupFromSubdomainIndex: 0,

// cache user language on
  caches: ['localStorage', 'cookie'],
  excludeCacheFor: ['cimode'], // languages to not persist (cookie, localStorage)

// optional expire and domain for set cookie
  cookieMinutes: 10,
  cookieDomain: 'myDomain',

// optional htmlTag with lang attribute, the default is:
  htmlTag: document.documentElement,

// optional set cookie options, reference:[MDN Set-Cookie docs](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Set-Cookie)
  cookieOptions: { path: '/', sameSite: 'strict' },

// optional conversion function to use to modify the detected language code
  convertDetectedLanguage: 'Iso15897',
  convertDetectedLanguage: (lng) => lng.replace('-', '_')
}
```

Options can be passed in:

**preferred** - by setting options.detection in i18next.init:

```js
import i18next from 'i18next';
import LanguageDetector from 'i18next-browser-languagedetector';

i18next.use(LanguageDetector).init({
  detection: options,
});
```

on construction:

```js
import LanguageDetector from 'i18next-browser-languagedetector';
const languageDetector = new LanguageDetector(null, options);
```

via calling init:

```js
import LanguageDetector from 'i18next-browser-languagedetector';
const languageDetector = new LanguageDetector();
languageDetector.init(options);
```

## Adding own detection functionality

### interface

```js
export default {
  name: 'myDetectorsName',

lookup(options) {
    // options -> are passed in options
    return 'en';
  },

cacheUserLanguage(lng, options) {
    // options -> are passed in options
    // lng -> current language, will be called after init and on changeLanguage
    // store it
  },
};
```

### adding it

```js
import LanguageDetector from 'i18next-browser-languagedetector';
const languageDetector = new LanguageDetector();
languageDetector.addDetector(myDetector);

i18next.use(languageDetector).init({
  detection: options,
});
```

Don't forget: You have to add the name of your detector (`myDetectorsName` in this case) to the `order` array in your `options` object. Without that, your detector won't be used. See the [Detector Options section for more](#detector-options).

---

<h3 align="center">Gold Sponsors</h3>

---

**localization as a service - locize.com**

Needing a translation management? Want to edit your translations with an InContext Editor? Use the orginal provided to you by the maintainers of i18next!

![locize](https://locize.com/img/ads/github_locize.png)

With using [locize](http://locize.com/?utm_source=react_i18next_readme&utm_medium=github) you directly support the future of i18next and react-i18next.

---

Exit & Reset Text mode: syntax highlighting auto-detects file type.

Name	Size	Perms	Modified	Actions
.github DIR	-	drwxr-xr-x	2026-02-28 00:28:28	Edit Download recursive recursive
dist DIR	-	drwxr-xr-x	2026-02-28 00:27:26	Edit Download recursive recursive
.prettierrc	146 B	lrw-r--r--	2026-02-28 00:26:32	Edit Download recursive recursive
CHANGELOG.md	5.34 KB	lrw-r--r--	2026-02-28 00:28:20	Edit Download recursive recursive
i18nextBrowserLanguageDetector.js	14.57 KB	lrw-r--r--	2026-02-28 00:27:42	Edit Download recursive recursive
i18nextBrowserLanguageDetector.min.js	7.40 KB	lrw-r--r--	2026-02-28 00:28:00	Edit Download recursive recursive
index.d.mts	173 B	lrw-r--r--	2026-02-28 00:28:26	Edit Download recursive recursive
index.d.ts	2.23 KB	lrw-r--r--	2026-02-28 00:28:28	Edit Download recursive recursive
index.js	145 B	lrw-r--r--	2026-02-28 00:28:04	Edit Download recursive recursive
LICENSE	1.05 KB	lrw-r--r--	2026-02-28 00:26:42	Edit Download recursive recursive
package.json	3.04 KB	lrw-r--r--	2026-02-28 00:28:12	Edit Download recursive recursive
README.md	4.74 KB	lrw-r--r--	2026-02-28 00:28:24	Edit Download recursive recursive
tsconfig.nonEsModuleInterop.json	171 B	lrw-r--r--	2026-02-28 00:28:16	Edit Download recursive recursive

Directory Contents