# i18next-xhr-backend
> backend layer for i18next using browsers xhr
Latest version **3.2.2** (published 2019-11-01) · MIT license · 0 weekly downloads
> **Deprecated.** This package is deprecated.
## Install
```sh
npm install i18next-xhr-backend
pnpm add i18next-xhr-backend
yarn add i18next-xhr-backend
bun add i18next-xhr-backend
```
## Health
**Score 10/100 (F)** — status: deprecated.
Negative: deprecated.
## Facts
| | |
|---|---|
| Version | 3.2.2 |
| Published | 2019-11-01 |
| First published | 2015-10-28 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 1 |
| Unpacked size | 48.6 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 250 |
| Author | Jan Mühlemann |
| Maintainers | jamuhl |
| Keywords | i18next, i18next-backend |
## Links
- npm: https://www.npmjs.com/package/i18next-xhr-backend
- Repository: https://github.com/i18next/i18next-xhr-backend
- Issues: https://github.com/i18next/i18next-xhr-backend/issues
- npm.io page: https://npm.io/package/i18next-xhr-backend
## Dependencies (1)
- [@babel/runtime](https://npm.io/package/@babel/runtime.md) ^7.5.5
## Alternatives
- [messageformat](https://npm.io/package/messageformat.md) — 329.7K weekly downloads
- [@mintlify/scraping](https://npm.io/package/@mintlify/scraping.md) — 294.8K weekly downloads
- [@mintlify/previewing](https://npm.io/package/@mintlify/previewing.md) — 209.5K weekly downloads
- [@mintlify/prebuild](https://npm.io/package/@mintlify/prebuild.md) — 209.5K weekly downloads
- [@mintlify/link-rot](https://npm.io/package/@mintlify/link-rot.md) — 206.3K weekly downloads
## Recent versions
- 3.2.2 (latest) — 2019-11-01
- 3.2.1 — 2019-10-29
- 3.2.0 — 2019-09-24
- 3.1.2 — 2019-08-13
- 3.1.1 — 2019-08-05
- 3.1.0 — 2019-08-05
- 3.0.1 — 2019-08-03
- 3.0.0 — 2019-06-03
- 2.0.1 — 2019-02-18
- 2.0.0 — 2019-02-09
- 1.5.1 — 2018-01-03
- 1.5.0 — 2017-11-06
- 1.4.3 — 2017-09-10
- 1.4.2 — 2017-06-05
- 1.4.1 — 2017-03-22
- … 22 more at https://npm.io/package/i18next-xhr-backend/versions
## README
# Introduction
[](https://travis-ci.org/i18next/i18next-xhr-backend)
[](https://coveralls.io/github/i18next/i18next-xhr-backend)
[](https://www.npmjs.com/package/i18next-xhr-backend)
[]()
[](https://david-dm.org/i18next/i18next-xhr-backend)
This is a simple i18next backend to be used in the browser. It will load resources from a backend server using the xhr API.
# Getting started
Source can be loaded via [npm](https://www.npmjs.com/package/i18next-xhr-backend), bower or [downloaded](https://github.com/i18next/i18next-xhr-backend/blob/master/i18nextXHRBackend.min.js) from this repo.
```
# npm package
$ npm install i18next-xhr-backend
# bower
$ bower install i18next-xhr-backend
```
Wiring up:
```js
import i18next from 'i18next';
import XHR from 'i18next-xhr-backend';
i18next.use(XHR).init(i18nextOptions);
```
- As with all modules you can either pass the constructor function (class) to the i18next.use or a concrete instance.
- If you don't use a module loader it will be added to `window.i18nextXHRBackend`
## Backend Options
```js
{
// path where resources get loaded from, or a function
// returning a path:
// function(lngs, namespaces) { return customPath; }
// the returned path will interpolate lng, ns if provided like giving a static path
loadPath: '/locales/{{lng}}/{{ns}}.json',
// path to post missing resources
addPath: 'locales/add/{{lng}}/{{ns}}',
// your backend server supports multiloading
// /locales/resources.json?lng=de+en&ns=ns1+ns2
// Adapter is needed to enable MultiLoading https://github.com/i18next/i18next-multiload-backend-adapter
// Returned JSON structure in this case is
// {
// lang : {
// namespaceA: {},
// namespaceB: {},
// ...etc
// }
// }
allowMultiLoading: false, // set loadPath: '/locales/resources.json?lng={{lng}}&ns={{ns}}' to adapt to multiLoading
// parse data after it has been fetched
// in example use https://www.npmjs.com/package/json5
// here it removes the letter a from the json (bad idea)
parse: function(data) { return data.replace(/a/g, ''); },
//parse data before it has been sent by addPath
parsePayload: function(namespace, key, fallbackValue) { return { key } },
// allow cross domain requests
crossDomain: false,
// allow credentials on cross domain requests
withCredentials: false,
// overrideMimeType sets request.overrideMimeType("application/json")
overrideMimeType: false,
// custom request headers sets request.setRequestHeader(key, value)
customHeaders: {
authorization: 'foo',
// ...
},
// define a custom xhr function
// can be used to support XDomainRequest in IE 8 and 9
//
// 'url' will be passed the value of 'loadPath'
// 'options' will be this entire options object
// 'callback' is a function that takes two parameters, 'data' and 'xhr'.
// 'data' should be the key:value translation pairs for the
// requested language and namespace, or null in case of an error.
// 'xhr' should be a status object, e.g. { status: 200 }
// 'data' will be a key:value object used when saving missing translations
ajax: function (url, options, callback, data) {},
// adds parameters to resource URL. 'example.com' -> 'example.com?v=1.3.5'
queryStringParams: { v: '1.3.5' }
}
```
Options can be passed in:
**preferred** - by setting options.backend in i18next.init:
```js
import i18next from 'i18next';
import XHR from 'i18next-xhr-backend';
i18next.use(XHR).init({
backend: options,
});
```
on construction:
```js
import XHR from 'i18next-xhr-backend';
const xhr = new XHR(null, options);
```
via calling init:
```js
import XHR from 'i18next-xhr-backend';
const xhr = new XHR();
xhr.init(null, options);
```
## Misc
#### TypeScript definitions
- Install from `@types` (for TypeScript v2 and later):
npm install --save-dev @types/i18next-xhr-backend
- Install from `typings`:
typings install --save --global dt~i18next-xhr-backend
---
Gold Sponsors
---
_Source: https://npm.io/package/i18next-xhr-backend · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._