i18next

• refactor: static createInstance for wider browser support 1973

• types: export ParseKeys

This is a major breaking release:

• redesigned TypeScript types 1911 (use TypeScript v5)

• removed setDebug function in the logger: 1954

• changed returnNull default to false 1885

• drop support for old browsers and Node.js < v12 1948

• ordinal plural keys are now prefixed with _ordinal to help translators (non-breaking, bacause of fallback) 1945

➡️ check out the migration guide

• ResourceStore addResource: offer possibility to pass keySeparator via options 1968

• extend hasLoadedNamespace function options to pass optional lng to optimize server side usage of react-i18next

• fix: function t() passed options alteration 1947

• fix: pass lng to format function used in nesting 1938

• fix: deepFind as fallback for interpolation 1930

• fix: getBestMatchFromCodes when dev is a supported lng 1927

• types: fix postProcessor key argument type, fixes 1919

• format options are optional, fixes 1913

• fix: getFixedT with keyPrefix and fallback keys usage 1604

• fix: nested interpolation with data model "replace"

• fix: interpolation with data model "replace"

• types: missing dir function export for typescript

• types: allow als general options as second argument for t function

• types: fix some strang t function overloads fixes 1882

• types: t function overloads fix (open issue is still calling t with optional options argument)

• types: t function overloads for call with ns option in combination with objects

• types: more t function overloads for call with options argument but without ns value

• types: more overloads for t function

• offer possibility to define a language detector's detect function as promise

• types: extend the init method with a generic parameter for backend options 1878, 105, 34

• types: ability to pass ns as option instead of prefix i.e. i18next.t('bar', { ns: 'alternate' });

• dir function executible also without initialization

• named export for dir function

• revert: guess if languageDetector is async if no info provided

• guess if languageDetector is async if no info provided

• extend backend connector to accept also backends with promise / async-await signature

• fix options for continuous nesting 1876

• Expose some types 1871

• fix CallbackError type

• Change DefaultTFuncReturn to return null if returnNull typeOption is true 1865

• Add type for Formatter.addCached 1862

• Make getFixedT type-safe 1860
• types: Omit object from t function 1858

• [TypeScript] Add default value for TDefaultResult 1853

• Fix normalize type options 1850

• Make the translation function fully type-safe 1775

BREAKING: Since this is a major rewrite for TypeScript usage we decided to create a major version. For JavaScript users v22.0.0 is equivalent to 21.10.0

• Add formatter cache 1843

• optimize single quotes replacement for $t() nesting 1836

• defaultNS can now also be set to false

• Add Customizable Retry Logic 1810
• types: extend compatibilityJSON with v4

• types: fix getDataByLanguage type 1810

• fix: make sure retry logic ends for failed backend reads

• allow overriding keyPrefix option t function returned from getFixedT (does not work for normal t function)

• types: new optional unescape option for react-i18next

• fix: respect pluralSeparator for special _zero handling

• fix: types should always come first in exports 1796

• types: fix loaded event result

• fix: deepFind for null values 1790

• fix: loadNamespaces() doesn't keep resolving order when the second request completes before the first one 1785

• fix: allow formatters having '' for string options eg. this is an {{val, array(join: ' | ’)}}

• fix: regression introduced in v21.6.11, respect appendNamespaceToMissingKey for parseMissingKeyHandler 1507

• fix: interpolation with $ in values resets nextIndex to wrong position with skipOnVariables 1782

• types: keyPrefix in react options

• prevent chrome warnings because of window.navigator.userAgent usage 1778

• types: add saveMissingPlurals option 1774