usePreferredLanguage
navigator.language.
Import
TypeScript
import { usePreferredLanguage } from '@/hooks';API
Signature
usePreferredLanguage(default?) → string
When to use
Use usePreferredLanguage instead of re-implementing the same pattern in multiple components.
SSR / Next.js
Returns defaults on the server; hydrates on the client.
Live playground
Edit the example and see it run against the real @/hooks package in this app.
Live playgroundEdit · run with real
@/hooks · usePreferredLanguageEditor
function Lang() { const lang = usePreferredLanguage('en'); return <p>Locale: {lang}</p>; }
Preview
Implementation source
Full library source for usePreferredLanguage — copy into your project when you are not installing a package yet.
hooks/browser/usePreferredLanguage.ts
import { useCallback, useState } from 'react';
import { hasNavigator, isBrowser } from '../utility/isBrowser';
import { useEventListener } from '../events/useEventListener';
import { useIsomorphicLayoutEffect } from '../utility/useIsomorphicLayoutEffect';
function readLang(fallback: string): string {
if (!isBrowser() || !hasNavigator()) return fallback;
return navigator.language || fallback;
}
/** SSR-safe preferred language from `navigator.language`. */
export function usePreferredLanguage(defaultLanguage = 'en'): string {
const [lang, setLang] = useState(() => readLang(defaultLanguage));
const update = useCallback(() => setLang(readLang(defaultLanguage)), [defaultLanguage]);
useIsomorphicLayoutEffect(() => {
update();
}, [update]);
useEventListener('languagechange', update);
return lang;
}
Copy-paste example
usePreferredLanguage.example.tsx
'use client';
import { usePreferredLanguage } from '@/hooks';
export function Lang() {
const lang = usePreferredLanguage('en');
return <p>Locale: {lang}</p>;
}Production checklist
- Called only from Client Components or other custom hooks
- Type parameters filled in (e.g.
useFetch<User[]>) - Tip: Values are safe during SSR (defaults). Gate layout-dependent UI with useMounted when needed.
- Source of truth: open
hooks/browser/usePreferredLanguage.tsfor implementation details