BrowserBeginnerSSR-safehooks/browser/usePreferredLanguage.ts

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 · usePreferredLanguage
Editor
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.ts for implementation details