20.0.0

add support to proper augment PluginOptions type 1583
introduce ignoreJSONStructure flag, to automatically lookup for a flat key if a nested key is not found an vice-versa 1584 (MAJOR: because of ignoreJSONStructure is true by default)

19.9.2

try to fix another edge case issue 1570 introduces by fixing 1552

19.9.1

Fallback on singular defaultValue 1563

19.9.0

Improve updateMissing default plural behavior 1558
typescript: type definitions improvements for backend 1560

19.8.9

warn if i18next gets initialized multiple times

19.8.8

fix for cases when calling changeLanguage before finished to initialize 1552

19.8.7

use "Object.prototype.hasOwnProperty" instead of "object.hasOwnProperty", fixes 1542

19.8.6

regression fix because of last prototype pollution fix in v19.8.5

19.8.5

fix potential prototype pollution when backend plugin resolves a malicious language value
use fallbackLng as default lng

19.8.4

update format function signature for TS 1520)

19.8.3

fix prototype pollution with constructor

19.8.2

allow nesting recursively with context (could theoretically generate infinite loop, prevented in 1480)

19.8.1

fix "no languageDetector is used" log statement
do not log "initialized" on cloned instances

19.8.0

allow fallbackLng as function 1508

19.7.0

resource manipulation functions are now chainable

19.6.3

plural rules for ht and iw

19.6.2

fix interpolation with option skipOnVariables when there are multiple placeholders 1490

19.6.1

extend interpolation option skipOnVariables 1488
typescript: Change bindStore to bindI18nStore in ReactOptions type and update default values 1489

19.6.0

fix prototype pollution
introduce new interpolation option skipOnVariables 1483

19.5.6

fix local usage of nsSeparator option

19.5.5

fix: recursion when passing nesting to interpolated 1480

19.5.4

typescript fix: getDataByLanguage typings & test 1472
typescript fix: type declarion of exposed EventEmitter#off methods 1460

19.5.3

fix Macedonian plural formula 1476

19.5.2

fix nesting interpolation with prepended namespace, fixes #1474 1475

19.5.1

getBestMatchFromCodes: use fallbackLng if nothing found, fixes #1470 1471

19.5.0

language detectors can return an array of languages and let i18next figure out best match
rename option whitelist to supportedLngs
rename option nonExpicitWhitelist to nonExplicitSupportedLngs
rename function languageUtils.isWhitelisted to languageUtils.isSupportedCode

This changes are made with temporal backwards compatiblity and will warn your for deprecated usage of old terms to give users and plugin providers some time to adapt their code base.

The temporal backwards compatiblity will be removed in a follow up major release.

Learn more about why this change was made here.

19.4.5

Add store events to typings 1451

19.4.4

typescript: Allow passing retry boolean to ReadCallback 1439

19.4.3

fix regression introduced in "support formatting in nesting" 1419

19.4.2

fix for deno 1428

19.4.1

add getLanguagePartFromCode as in language fallback resolution 1424

19.4.0

support formatting in nesting 1419

19.3.4

fix cloning of service.utils binding to clone 1415

19.3.3

backendConnector extend initial retry from 250 to 350

19.3.2

fix the nested string options parsing introduced in v19.2.0 which broke having multiple options

19.3.1

typescript: add options.interpolation.nestingOptionsSeparator

19.3.0

Double fix for 1395 issue 1399
adds options.interpolation.nestingOptionsSeparator: ',' to specify that separator

19.2.0

Add ability to use commas in nested keys 1398

19.1.0

explict warning when no languageDetector is used and no lng is defined 1381
Add option to always format interpolated values 1385
pass all options to format function 992#issuecomment-577797162

19.0.3

fixes retry interval in backend connector 1378

19.0.2

typescript: Type ResourceStore 1366

19.0.1

ignore non valid keys in saveMissing 1359

19.0.0

typescript: Typescript use export default for esm-first approach 1352

18.0.1

check loadedNamespace only once per lng-ns inside using t for better performance

18.0.0

When calling i18next.changeLanguage() both i18next.language and i18next.languages will be set to the new language after calling loadResources -> means when accessing t function meanwhile you will get still the translations for the previous language instead of the fallback.
When is this breaking? this does not break any current test - but if you depend on accessing i18next.language or i18next.dir during language change and expect the new language this will break your app.
Reasoning: In react-i18next we get in a not ready state for loaded translations while we would prefer just waiting for the new language ready and trigger a rerender then - also a triggered rerender outside of the bound events would end in Suspense...
How can I get the language i18next will be set to? i18next.isLanguageChangingTo is set to the language called

17.3.1

typescript: Add missing cleanCode option to TypeScript def 1344

17.3.0

pass used language & namespace to postprocessor 1341

17.2.0

Support using ImmutableJS Records as the data model in interpolation 1339

17.1.0

DX improvements:

warning if accessing t before i18next was initialized or namespace loaded
warning and cancelling save if saveMissing key before i18next was initialized or namespace loaded

Both are a clear sign you render your app / call t to early not waiting for the callbacks or Promise.resolve on i18next.init, i18next.loadNamespace or i18next.changeLanguage.

17.0.18

Improve performance of EventEmitter.off 1333

17.0.17

fixes: missing nested key fails if no nested value found and defaultValue contains interpolation -> results in endless loop 1332

17.0.16

typescript: fix incorrect callback type for backend module read callback 1322
typescript: add getDataByLanguage into index.d.ts 1326

17.0.15

Fixed default value as string in IE 1325

17.0.14

typescript: Allow TFunction to receive 1-3 parameters 1317

17.0.13

fixes: Interpolation defaultVariables not recognized on t() 1314

17.0.12

remove unused Interpolator#init reset param (only used internally) 1313
Cope with null interpolation (unescaped case) 1310

17.0.11

fix issue with unset value in interpolation throwing exception
typescript: Allow augmentation of TFunction to be able to add overloads 1308

17.0.10

Update Interpolator.js to use regexSafe for unescaped interpolation 1307

17.0.9

typescript: use() should accept a class or object 1301

17.0.8

typescript: Correct use(module) types 1296

17.0.7

typescript: Typescript imports 1291
Disabled default returnedObjectHandler 1288

17.0.6

support montenegrien "crn" plurals

17.0.4

typescript: ResourceKey type should allow top level string value 1267

17.0.3

don't do named exports for umd

17.0.2

typescript: Allow null as TResult 1263
bring back ./i18next.js and ./i18next.min.js -> used by wildcard unpkg users...<= bad idea doing so
main export in package.json points to cjs dist

17.0.1

adapt ./index.js to 17.0.0 export

17.0.0

removes checking in build files (umd) into source code - for CDN usage use: https://unpkg.com/i18next@16.0.0/dist/umd/i18next.js
removes named exports in main file - avoids issues in mixed exports makes usage better in commonjs scenarios (node.js) - no strange const i18next = require('i18next').default;
impact you can't no longer import { changeLanguage } from 'i18next'; changeLanguage('de'); you will have to import i18next from 'i18next'; i18next.changeLanguage('de');
note if can create a own file providing the named bound functions and use that instead, sample: https://github.com/i18next/i18next/blob/v15.0.0/src/index.js#L5

16.0.0

removes deprecated jsnext:main from package.json
Bundle all entry points with rollup 1256
note: dist/es -> dist/esm, dist/commonjs -> dist/cjs (individual files -> one bundled file)

15.1.3

typescript: Fix type error when init with locize plugin options 1248

15.1.2

typescript: types(ReactOptions): Add missing props to React Options interface 1247

15.1.1

typescript: Update BackendModule interface to allow null or undefined for the callback 1244

15.1.0

trigger a languageChanging event

15.0.9

IE: <=IE10 fix (unable to call parent constructor) 1227

15.0.8

typescript: adding init function to 3rdParty module typings and enforcing type property 1223

15.0.7

typescript: Add useSuspense to ReactOptions, fix error throwing on test 1219

15.0.6

typescript: add Interpolator interface 1213

15.0.5

typescript: Add hashTransKey to ReactOptions 1208
Expose error on reloadResources 1212

15.0.4

add default export on node.js entry 1204
typescript: Add defaultValue tests and allow second arg string as defaultValue 1206

15.0.3

typescript: accept templatestringsarray as TKey 1199
allow arrays on addResources

15.0.2

try fixing UMD build

15.0.1

fix export name on global (typo)

15.0.0

update build process (while all test passes feeling more save making this a major release)

14.1.1

allow empty string for array join 1191

14.1.0

support plurals in returning objecttree array 1196

14.0.1

typescript: Parameterized use of TFunction fails while WithT use works 1188

14.0.0

typescript: BREAKING Refactor generics usage 1180

13.1.5

es modules: Fix bug when import by ES Module 1179
typescript: Add module property 1176

13.1.4

fixes plural rule for JSON compatibility v2 introduced in 11.3.3 https://github.com/i18next/i18next/commit/d4d329fd7042f932eedf8bba1d92234707efd04c#diff-e171f9b8b4e0f5df027bd8bd7b962f1bR1140 1174

13.1.3

TypeScript: Pull up WithT interface allowing for overrides 1172

13.1.2

Add typescript testing 1165
Add transEmptyNodeValue to ReactOptions 1166
Run prettier on typescript files for easier diffing in PRs 1167

13.1.1

fix init() attributes typings 1158

13.1.0

Support interpolation for defaultValue as parameter 1151

13.0.1

update typedefinitions 1152

13.0.0

pass options to missingInterpolationHandler 1146
refactor non valid keys handling 1143

BREAKING:

adds typescript definitions directly into this repo - no longer need to grab them from definitlytyped 1142
promise API added for all functions providing a callback 1130 -> means those will now return a Promise and not this -> so you can't chain eg. i18next.init().on() anylonger as init returns a Promise

12.1.0

adds partialBundledLanguages flag in init options 1136

12.0.0

add hebrew update 1121

11.10.2

revert hebrew

11.10.1

Adds Hebrew plural support 1121

11.10.0

Allow missingInterpolationHandler to be provided as t() option 1118

11.9.1

fixes allow overriding of fallbackLng when in options passed to t functions call

11.9.0

merge load and reloadResources functionality to allow an optional callback in reloadResources

11.8.0

deeper support for i18nFormats - add getResource function from format

11.7.0

allows defining defaultValues for plurals -> same logic as using pluralsuffixes in translation files details using eg. defaultValue_plural / defaultValue_2 based on request 1096

11.6.0

expose new store function getDataByLanguage 1087

11.5.0

EventEmitter.prototype.on returns this for chaining calls 1079

11.4.0

Allow to pass raw value to the custom interpolation escape function 1076

11.3.6

fix support zero for saveMissing plurals 1072

11.3.5

trigger loaded event only once per loaded namespace - consolidate all the loaded and done queued load calls react-i18next 456

11.3.4

fixes simplifyPluralSuffix: false cases for languages having only singular, plural 1069

11.3.3

pass down resolved to i18nFormat.parse as last argument

11.3.2

Properly handle arguments containing arrays while listening to a wildcard event 1052

11.3.1

Fixes allowing setting keySeparator to false in calling t function 1051

11.3.0

Option to skip interpolation when calling t. 1050

11.2.3

Remove unnecessary warning when value is empty string 1046

11.2.2

adds used key to call parse of i18nFormat

11.2.1

fixes for i18nFormat plugin

11.2.0

allows new plugin of type 'i18nFormat' to override i18next format with eg. ICU format

11.0.0 - 11.1.1 (fixing version mismatch cdn.js - npm)

[BREAKING] removes plugin of type cache. Can be replace by i18next-chained-backend example cache for localStorage i18next-localstorage-backend
[BREAKING] removes the support for multiload (multiRead) in backends - will just use read per language-namespace. You can enable multiRead support in backends again by using i18next-multiload-backend-adapter

10.6.0

adds missingInterpolationHandler 1039

10.5.1

fixes call to getPluralFormsOfKey if called with unsupported language 1032
Avoid mutating whitelist array. 1037

10.5.0

Adds options.silent to addResources and addResourceBundle 1024

10.4.1

forward options in backend.create saveMissing

10.4.0

fixes combination of returnObject and context by returning original value for deep translation when lookup for inner returns a key (failed to translate proper) 1014
[EXPERIMENTAL] additional you can pass tDescription to the t options or as a third param to calling t -> t(key, defaultValue, tDescription);. Those will get forwarded to the backend and can be submitted on saveMissing to provide contextual information for translators.

10.3.0

new option saveMissingPlurals (default true) will enable submitting plural forms on saveMissing if t call is for plural (count passed in options).

10.2.2

fixes Context and nested lost initial options 1009

10.2.1

optimize update output in log

10.2.0

[EXPERIMENTAL] init option updateMissing: enable to update default values if different from translated value (only useful on initial development or when keeping code as source of truth not changing values outside of code)

10.1.0

return boolean, number from translator
initial set language on translator if non set yet (after that only if loaded) #998

10.0.7

support all overloadTranslationOptionHandler in getFixedT react-i18next/issues/332

10.0.6

native browser es modules via adding .js where needed PR980

10.0.5

should fix sync of options in clone and its translator

10.0.2

fixes issue in object return when passing in multiple keys

10.0.1

fixes support for using suffix _0 on languages only having "singular" form

10.0.0

[BREAKING] brings pt, pt-PT, pt-BR plurals in line with, new pt reflects pt-BR and pt-PT gets a special case for plural handling http://www.unicode.org/cldr/charts/26/supplemental/language_plural_rules.html

9.1.0

support for using suffix _0 on languages only having "singular" form enables easier convert in tool chains

9.0.1

propagate changeLanguage to translator after loadResources

9.0.0

[BREAKING] removes the compatibility options to i18next v1 you can add that back like we do in our backward compatibility tests: https://github.com/i18next/i18next/blob/master/test/backward/v1.11.1.compat.js#L45-L52
removes the compatibility options to i18next v1
allows passing in second param as string on getFixedT returned t function so we could use that as defaultValue
add setting maxReplaces in interpolation options to prevent endless loop in interpolation

8.4.3

getFixedT lng parameter of array type -> pass as lngs to t function PR949

8.4.2

fixes merging options in clone instance...do not override passed values by values on main instance

8.4.1

emits correct lng to changeLanguage event (fixes async detection behaviour) PR933

8.4.0

expose i18next.options.interpolation.format on i18next.format
i18next.dir if not passing lng use first of i18next.languages before using i18next.language

8.3.0

allows nesting objects/arrays into objects #925

8.2.1

fixes issue in async lng detection

8.2.0

supports now async language detection - when language detector has member async = true

8.1.0

option to disable nesting by calling i18next.t('key', { nest: false }) PR920
fixes passing lng from options to formatter function if available

8.0.0

nonExplicitWhitelist flag now not only gets considered on a fallback lng but also on user language. Eg. userlng 'de-AT' and whitelist ['de'] will now let de-AT pass as whitelisted if nonExplicitWhitelist is set true.

7.2.3

rebuild seems we had a mistake in pushing latest build

7.2.2

fixes issue in accepting string as a result of "nested" lookup PR909

7.2.1

fixes iterating over object's own properties #904

7.2.0

new init option simplifyPluralSuffix - setting it to false will treat all plurals using suffix numbers even for locals only having singular and plural
even if no lng set or detected at least load the fallback languages
delay init call on createInstance if not set initImmediate to false #879

7.1.3

fixes issue in returnObject tree called with options including ns: react-i18next #240

7.1.2

remove regex escape from format separators #896

7.1.1

change to named plugins for 3rd party - just calling init

7.1.0

add option to include plugins not directly related - they get called their init function with current instance of i18next on init

7.0.1

fix issue in fallback lng detection if no code was detected
check for having a lng in append when searching locals to load on loadResources - avoid error on express middleware

7.0.0

[BREAKING] Removed special cases for norwegian which resolved nb-NO to nb-NO, no will now resolve to nb-NO, nb #870 using norwegian you could migrate to old behaviour like:

fallbackLng: { 'nb': ['no', 'en'], 'nn': ['no', 'en'], 'default': ['en'] }
adding exports for named import (destruction es6) #873
change entry point for umd build to /src/i18next to avoid mixed export
replace cloning in interpolation nesting to use object assign instead of json.stringify/parse so circular structures can be used #875
update all build dependencies

6.1.2

fixes fix in 6.1.1

6.1.1

patching same separators to lookup if the ns exists - else guess the first item is just part of the key and not meant as a namespace

6.1.0

you now can use same nsSeparator and keySeparator (eg. use a dot for both)

6.0.3

do not loop over objectTree if keySeparator is set to false

6.0.2

fixes init flow of clone

6.0.1

fixes issue in event emitter, assert all emitters get called even if one called get removed and changes the array index

6.0.0

Return namespace in cimode with appendNamespaceToCIMode option (default now will only return key without namespace - independent of call to t function) #863

5.0.0

Nested keys should not be escaped by default #854
Make sure i18next.init() runs for i18next.cloneInstance() #860

4.2.0

adds i18next.isInitialized when isInitialized
triggers backend loaded event before initialized

4.1.3 / 4.1.4

smaller changes suggested to still inofficial support ie8 #852

4.1.2

fixes same interpolation object with multiple getFixedT() in different locales yields wrong translation #851
updated all build deps

4.1.1

remove subs array from logger - no longer keep changing debug flag on subs if changing on main

4.1.0

Custom escape function, single-quotes in nested #843

4.0.0

[BREAKING; only webpack2-beta users] will add module entry point used by webpack2, this might break your current build with webpack2-beta if configured incorrectly, see: #836

3.5.2

remove the module entry point again will be added in 4.0.0

3.5.1

fix build output add a test file to test the generated build

3.5.0

Setting options on individual translations override, rather than merge global configs #832
Create an new translator when cloning i18next instance #834
allows fallbackLng to be an string, an array or an object defining fallbacks for lng, lng-region plus default, eg

fallbackLng: { 'de-CH': ['fr', 'it', 'en'], 'de': ['fr', 'en'], 'zh-Hans': ['zh-Hant', 'en'], 'zh-Hant': ['zh-Hans', 'en'], 'default': ['en'] }

3.4.4

Fix Interpolator.escapeValue defaulting to undefined in some cases #826

3.4.3

Fix Interpolator formatter exception error propagation due to not reset RegExp indices #820

3.4.2

assert dir function does not crash if no language available

3.4.1

fix issue with format containing formatSeparator for interpolation formatting

3.4.0

adds formatting 'format this: {{var, formatRule}}' having a function on options.interpolation.format: function(value, format, lng) { return value } like suggested here #774

3.3.1

fixed an issue with several unescaped key in the interpolation string #746

3.3.0

allows option nonExplicitWhitelist on init #741

3.2.0

adds api function i18next.reloadResources(), i18next.reloadResources(lngs, ns) to trigger a reload of translations

3.1.0

emits missingKey always (like console.log) even if saveMissing is of -> use missingKeyHandler if you only want the trigger only on saveMissing: true

3.0.0

[BREAKING] per default i18next uses now the same index as used in gettext for plurals. eg. for arabic suffixes are 0,1,2,3,4,5 instead of 0,1,2,3,11,100. You can enforce old behaviour by setting compatibilityJSON = 'v2' on i18next init.
[BREAKING] AMD export will be unnamed now
don't call saveMissing if no lng

2.5.1

fixes rtl support #656

2.5.0

allow null or empty string as defaultValue
init option initImmediate (default: true) to init without immediate

2.4.1

if passing resources don't immediate loading fixes #636

2.4.0

support now language code variants with scripts and other exotic forms: zh-Hans-MO, sgn-BE-fr, de-AT-1996,...
trigger of changeLanguage, load of data with a setTimeout to allow other operations meanwhile

2.3.5

Only add language to preload array when new #613

2.3.4

get babel 6 output IE compatible: https://jsfiddle.net/jamuhl/2qc7oLf8/

2.3.2

add index to make export compatible again

2.3.1

build /dist/es with included babelhelpers

2.3.0

change build chain to use rollup...allows 'js:next' and reduces build from 45kb to 33kb minified (/lib --> /dist/commonjs folder, new /dist/es for rollup,...)
fixes detection when using both context and pluralization and context not found. #851

2.2.0

return instance after init for further chaning
make init optional on backend, cache
package.json entry points now to /lib not to mangled version...this might be the better solution for most use cases (build chains built on npm, webpack, browserify, node,...)

2.1.0

allow keySeparator, nsSeparator = false to turn that off

2.0.26

extended emitted arguments on 'added' event

2.0.24

fixes unneeded reload of resources that failed to load

2.0.23

fixes returnObjects in case of multiple namespaces

2.0.22

add options for context, pluralSeparator

2.0.21

clear done load request in backendConnector

2.0.20

pass full options to detectors as third arg

2.0.19

do not callback err in backendConnector if no backend is specified

2.0.18

check for fallbackLng exist

2.0.17

adds cimode to options.whitelist if set
emits failedLoading on load error

2.0.16

adds addResource to i18next API
fix init of i18next without options, callback

2.0.15

avoid loading of resources for lng=cimode

2.0.14

enhance callback on load from backend...wait for pendings

2.0.10

fixing build chain
do not post process on nested translation resolve

2.0.5

fixing allow nesting on interpolated nesting vars

2.0.4

don't log lng changed if no lng was detected
extend result on arrayJoins

2.0.1

assert defaults are arrays where needed
assert calling lngUtils.toResolveHierarchy does not add undefined as code if called without code param

2.0.0

complete rewrite of i18next codebase

1.11.2

replace forEach loop to support IE8 PR 461

1.11.1

fixes issue in nesting using multiple namespaces and lookups in fallback namespaces
Fix use of sprintf as shortcutFunction when first argument falsey PR 453

1.11.0

Add nsseparator and keyseparator as options to translation function PR 446
Resolves issue #448 - TypeScript errors PR 449
Fixing _deepExtend to handle keys deep existing in source and target PR 444
resource to resources in addResources function PR 440
Runs multiple post processes for missing translations PR 438
Add support to override Ajax HTTP headers PR 431
Fixed mnk plural definition PR 427
Add dir function to return directionality of current language, closes… PR 413

1.10.3

fixes issue where lng get fixed on data-i18n-options
[SECURITY] merges Reimplement XSS-vulnerable sequential replacement code PR 443

1.10.2

streamline callback(err, t) for case where resStore is passed in

1.10.1

fixes Adds jquery like functionality without the jquery plugin. PR 403 by adding it to output

1.10.0

[BREAKING] new callbacks will be node.js conform function(err, t) | Forward the error from sync fetch methods to the init callback function PR 402
fix fallback lng option during translations PR 399
Adds jquery like functionality without the jquery plugin. PR 403

1.9.1

fix fallback lng option during translations PR 399
Adds jquery like functionality without the jquery plugin. PR 403

1.9.0

i18n.noConflict() PR 371
fix fallback to default namepsace when namespace passed as an option PR 375
cache option for ajax requests PR 376
option to show key on value is empty string PR 379
Add isInitialized method PR 380
Null check for detectLngFromLocalStorage PR 384
support for adding timeout in configuration for ajax request PR 387

1.8.2

fixes build of commonjs with jquery file

1.8.0

[BREAKING] adds custom build for commonjs with jquery...default will be without require for jquery
fixes issue issue 360
expose applyReplacement on api
save resources to localStorage when useLocaleStore is true
add support on key is a number
added getResourceBundle to API
allow multiple post-processors
fallback to singular if no plural is found fixes issue issue 356
access localstorage always with try catch fixes issue issue 353

1.7.7

fixes issue with stack overflow on t(lng, count)
fixes empty value fallback when processing secondary ns

1.7.6

fixes lng detection (i18next-client on npm)

1.7.5

adds option to define defaultOptions, which gets merged into t(options) issue 307
optimization of size added by plural rules
handle error on json parse when using internal xhr
fixes plural/singular on count if going on fallbacks eg. fr --> en
fixes global leak of sync in amd versions
apply options.lowerCaseLng to fallbackLng too
added hasResourceBundle(lng, ns) to check if bundle exists
added experimental i18n.sync.reload --> resets resStore and reloads resources
catch issues with localStorage quota
changes detectlanguage to support whitelist entries

1.7.4

add resource bundle gets deep extend flag i18n.addResourceBundle(lng, ns, { 'deep': { 'key2': 'value2' }}, true);
new functions to add one key value or multiple i18n.addResource(lng, ns, key, value);, i18n.addResources(lng, ns, {'key1': 'value1', 'deep.key2': 'value2'});
lngWhitelist merged
override postMissing function
allow floats for count
added indefinite functionality for plurals
optional set replacing vars to replace member to avoid collision with other options
experimental optional detectLngFromLocalStorage
fix for norwegian language

1.7.3

solves issue with ie8 not providing .trim function on string -> added to shim
set data using $(selector).i18n() on data-i18n='[data-someDataAttr]key'
more bullet proof state handling on failed file load
corrected latvian plurals based on issue 231
allow array of fallback languages
allow int in values passed to shortcut sprintf
setLng to 'cimode' will trigger a CI mode returning 'key' instead of translation

1.7.2

introducing option fallbackOnEmpty -> empty string will fallback
added function removeResourceBundle(lng, ns) -> removes a resource set
fixed issue with no option passed to setLng
added ability to prepend, append content with data-i18n attributes
introducing objectTreeKeyHandler
fixes issue with i18n.t(null), i18n.t(undefined) throwing exception
returnObjectTrees does not mangle arrays, functions, and regexps
optimized structure for bower support

1.7.1

fixed some typo
allow translate to take an array of keys - take first found
allow numbers in object trees

1.7.0

test if initialisation finished before allowing calling t function
setting option fixLng=true will return t function on init or setLng with the lng fixed for every subsequent call to t
grab key from content if attr data-i18n has no value
setting shortcutFunction to 'defaultValue' allows calling i18n.t(key, defaultValue)
empty string in defaultValue is now valid no longer displaying key
allow option cookieDomain
fixes issue #115 out of stack exception in IE8 by recursing _translate in objectTrees

1.6.3

option to parse key if missing
fixes issue where plural don't get translated if language is passed in t options
fixes issue where key or defaultValue aren't postProcessed with itself as value
fixes issue with fallbackLng = false in combination with sendMissingTo = fallback
fixes namespace fallback loop to only loop if array has really a ns in it

1.6.2

fixes some var typo
fixes sendMissing to correct namespace
fixes sendMissing in combination with fallbackNS

1.6.1

PR #106 optionally un/escape interpolated content
PR #101 automatic gettext like sprintf syntax detection + postprocess injection
customload will get called on dynamicLoad too
fixes namespace array settings if loaded resourcebundle or additional namespaces
lookup of not existend resouces can be fallbacked to other namespaces - see option fallbackNS (array or string if one ns to fallback to)
defaultValues get postProcessed
BREAKING: per default null values in resources get translated to fallback. This can be changed by setting option fallbackOnNull to false
PR #81 added support for passing options to nested resources
PR #88 added an exists method to check for the existence of a key in the resource store
fixed issue with null value throws in applyReplacement function
fixed issue #80 empty string lookup ends in fallback instead of returning result in language
fixed issue with null value in resources not returning expected value
optimized tests to use on server (nodejs) too
allow zepto as drop in replacement for $
using testacular as runner
upgraded to grunt 0.4.0
fixed optional interpolation prefix/suffix not used in plural translation cases
optimized check if there are multiple keys for the data-i18n attribute to parse

1.6.0

option to specify target to set attributes with jquery function by using 'data-i18n-target attribute'
function to set new options for nesting functionality
function to add resources after init
option to lookup in default namespace if value is not found in given namespace
option to change interpolation prefix and suffix via translation options
fixed issue with using ns/keyseparator on plurals, context,...
fixed issue with posting missing when not using jquery
post missing in correct lng if lng is given in translation options
proper usage of deferred object in init function
fixed issue replacing values in objectTree

1.5.10

BREAKING: fixed plural rules for languages with extended plural forms (more than 2 forms)
merged pull #61 - custom loader (enables jsonp or other loading custom loading strategies)
escaping interpolation prefix/suffix for proper regex replace

1.5.9

functions to load additional namespaces after init and to set default namespace to something else
set if you don't want to read defaultValues from content while using jquery fc
set dataAttribute to different value
set cookieName to different value
some smallbugfixes
typesafe use of console if in debug mode

1.5.8

disable cookie usage by setting init option useCookie to false
accept empty string as translation value
fixed bug in own ajax implementation not using proper sendType
fixed bug for returning objTree in combination with namespace
fixed bug in plurals of romanic lngs

1.5.7

pass namespace in t() options
interpolation nesting
changable querystring param to look language up from

1.5.6

typesafe check for window, document existance
runnable under rhino
seperated amd builds with/without jquery

1.5.5

BREAKING added all plurals: suffixes will new be same as in gettext usage (number indexes key_plural_0|2|3|4|5|7|8|10|11|20|100), additional if needed signature of addRule has changed
added sprintf as postprocessor -> postProcess = 'sprintf' and sprintf = obj or array
set default postProcessor on init
redone build process with grunt
drop in replacement for jquery each, extend, ajax
setting fallbackLng to false will stop loading and looking it up
option to load only current or unspecific language files

1.5.0

pass options to sync._fetchOne, use options for fetching
support for i18next-webtranslate

1.4.1

post processor
BREAKING: localStorage defaults to false
added localStorageExpirationTime for better caching control
few bug fixes

1.4.0

preload multiple languages
translate key to other language than current
fixed issue with namespace usage in combination with context and plurals
more options to send missing values
better amd support

1.3.4

set type of ajax request to GET (options sendType: default POST)
set cookie expiration (options cookieExpirationTime: in minutes)
read / cache translation options (context, count, ...) in data-attribute (options useDataAttrOptions: default false)

1.3.3

optional return an objectTree from translation
use jquery promises or callback in initialisation
rewrote all tests with mocha.js

1.3.2

options to init i18next sync (options -> getAsync = false)
replace all occurence of replacement string

1.3.1

pass options to selector.i18n() thanks to @hugojosefson
close [issue #8(i18next#8)]: Fail silently when trying to access a path with children
cleanup
debug flag (options.debug -> write infos/errors to console)

1.2.5

fix for IE8

1.2.4

added indexOf for non ECMA-262 standard compliant browsers (IE < 9)
calling i28n() on element with data-i18n attribute will localize it now (i18n now not only works on container elements child)

1.2.3

extended detectLng: switch via qs setLng= or cookie i18next
assert county in locale will be uppercased en-us -> en-US
provide option to have locale always lowercased option lowerCaseLng
set lng cookie when set in init function

1.2

support for translation context
fixed zero count in plurals
init without options, callback

1.1

support for multiple plural forms
common.js enabled (for node.js serverside)
changes to be less dependent on jquery (override it's functions, add to root if no jquery)
enable it on serverside with node.js i18next-node

1.0

support for other attribute translation via data-i18n attribute
bug fixes
tests with qunit and sinon

0.9

multi-namespace support
loading static files or dynamic route
jquery function for data-i18n attibute
post missing translations to the server
graceful fallback en-US -> en -> fallbackLng
localstorage support
support for pluralized strings
insertion of variables into translations
translation nesting

Files

CHANGELOG.md

Latest commit

History