\n \n
\n
\n \n
\n
\n
🎌 Get the users' most preferred locale/language from your app's available translations with zero dependencies
\n\n#\n\n## Features\n\n- Uses the Intl.Locale API (backwards compatible)\n- Works on node & browsers\n- Zero dependencies\n- TypeScript support\n\n## Usage\n\nThis library is fully typed with TSDoc examples. View the online documentation here: https://wopian.github.io/preferred-locale/\n\n```ts\nimport { preferredLocale } from 'preferred-locale'\n\n// Note: All examples assume the browser's reported locales are:\n// [ 'en-GB', 'en', 'ja-JP', 'en-US', 'ja' ]\n\nconst supportedLocales = ['en-US', 'ja-JP']\nconst fallbackLocale = 'ja-JP'\nconst locale = preferredLocale(supportedLocales, fallbackLocale)\nconsole.log(locale) // 'en-US', converts 'en-GB' and 'en' to 'en-US' as neither are translated, placing it before 'ja-JP' in preference order\n\npreferredLocale(['en-us', 'fr-fr'], ['en-us'], {\n regionLowerCase: true\n}) // 'en-us', converts 'en-GB' to 'en-us' as 'en-gb' is not translated\n\npreferredLocale(['de', 'fr'], ['fr'], {\n languageOnly: true\n}) // 'fr', converts 'en-GB' to 'en' (etc). No matching locales so returns 'fr' fallback\n\npreferredLocale(['en-US', 'en-GB'], ['en-US']) // 'en-GB', as it is translated and first in user's preference order\n```\n\n## Guaranteed Node / Browser Support\n\n| Package | Package