NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm, #3968 most downloaded on npm
language detector used in browser environment for i18next
Latest stable
8.3.1
Last release 5 days ago
17 Nov 2026
Release timing varies
gaps range from 9 days to 8 months
Nearly every release is documented
notes for 55 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
11 years old
74 releases · first in 2015
Drag across the ruler to compare, or tap a release to open it.
fix: the cookie detector decodes the value it reads, so a language cached with an @ (like sr@latin, stored as sr%40latin) is detected again on the nex
@ (like sr@latin, stored as sr%40latin) is detected again on the next load instead of being dropped by the language code check. Thanks @SudeepGowda55 330querystring and hash detectors decode the value too, so ?lng=sr%40latin (what URLSearchParams and encodeURIComponent write) is detected as sr@latin. A value that is not valid percent-encoding is still skipped.security: a detected language must now have the shape i18next 26.7 accepts for a language code from outside (its isSafeLanguageCode): letters, digits,
isSafeLanguageCode): letters, digits, -, _, @ and . (no ..), at most 128 characters. It replaces the list of XSS patterns, which missed values like <b>x</b> or " onmouseover="x() from the query string, a cookie or storage, which then became the language; apps put it into <html lang="...">. Compatibility note: a value with other characters (spaces, slashes, quotes) is now skipped and the next detector is used; codes like en_US, zh_Hant_TW or sr@latin still pass, and i18next 27 refuses such codes from outside as well.Your coding agent can read these notes before it upgrades. Set up the MCP server →
fix: lookupFromSubdomainIndex counts hostname labels again, so with 1, dev.en.example.com is detected as en. Since 6.1.5 the index picked a regex grou
lookupFromSubdomainIndex counts hostname labels again, so with 1, dev.en.example.com is detected as en. Since 6.1.5 the index picked a regex group instead, and any index other than 0 returned a part of the domain (en.exampl, example.com). Index 0 (the default) works as before. Thanks @lprnmns 329fix: the subdomain detector now detects language tags with script and region subtags, so pt-BR.site.com, zh-Hans-CN.site.com, es-419.site.com and sr-L
pt-BR.site.com, zh-Hans-CN.site.com, es-419.site.com and sr-Latn.site.com are detected as pt-BR, zh-Hans-CN, es-419 and sr-Latn. The pattern only accepted 2 to 5 word characters, without hyphens. Other subdomains like staging or preview deployment labels (myapp-git-branch-team.vercel.app) are still not taken for a language, and everything detected before is still detected. Thanks @lprnmns 328fix: the path and hash detectors keep digits in a language segment, so /es-419/ and #/es-419 are detected as es-419 instead of es- (which i18next reso
/es-419/ and #/es-419 are detected as es-419 instead of es- (which i18next resolved to es). Segments that start with a digit (/2024/) still yield no language, and lookupFromPathIndex / lookupFromHashIndex point at the same segments as before. Thanks @nk-batman21 327Add missing typescript definition for hash options 33154
feat: add support for hash detector 304
feat: add support for Partitioned cookies 303
check for common xss attack patterns on detected language
fix localstorage check to try to address 297 300
change localstorage check to try to address 297
fix for when passed services are null, should address 296
some environments, throws when accessing document.cookie
chore: set browsers target to defaults 286
Nothing published for this version
fix: align addDetector impementation to type definition 282
fix: separate cjs and mjs typings
introduce convertDetectedLanguage option
- simplify usage without i18next
try to force esm moduel type for esm build 269
- typescript fix for i18next v22
fix export order for typescript 267
Types entries missing in package exports (Needed for Typescript >= 4.7 and moduleResolution="Node16"/"Nodenext") 266
define module exports in package.json
lookup subdomain with localhost option 264
fix querystring lookup if happening after # 256
export DecetorOptions and CustomDetector types
- fix lookup return types 245
- cookieOptions types 239
Type PluginOptions properly 235
optimize check for local storage and session storage 222
BREAKING rename lookupSessionStorage and add it to defaults 221
optimize cookie serialization and set sameSite to strict by default, to prepare for browser changes
BREAKING needs i18next >= 19.5.0
typescript Updated typescript typings for DetectorOptions to align with current options 216
- sessionStorage support 215
Add config option checkForSimilarInWhitelist 211
fix: pass cookieOptions with the cacheUserLang 205
feat: add cookieOptions for setting cookies 203
update index file to reflect build changes done in 4.0.0
typescript: Use updated ts export default from i18next 194
removes deprecated jsnext:main from package.json
add default checkWhitelist: true
Added option to prevent checking whitelist for detected languages checkWhitelist: true 190
checkWhitelist: true 190Remove clutter from npm package 181
typescript: Fix types for use() module 180
use() module 180- typescript: fix types 165
- typescript: add types 164
- fix 157
- fix 159
Lang by path: skip if language not found 159
fixes option validation in path lookup 158
add detector for path and subdomain PR153 and PR152
support for fallback language in form of object 151
add .js for browser import implementation PR147
[BREAKING] options.excludeCacheFor (array of language codes; default ['cimode']): if a language maps a value in that list the language will not be wri
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per quarter.