1---
2category: Sensors
3---
4 
5# useNavigatorLanguage
6 
7Reactive [navigator.language](https://developer.mozilla.org/en-US/docs/Web/API/Navigator/language).
8 
9## Usage
10 
11```ts
12import { useNavigatorLanguage } from '@vueuse/core'
13 
14const { language } = useNavigatorLanguage()
15 
16watch(language, () => {
17  // Listen to the value changing
18})
19```
20 
21## Type Declarations
22 
23```ts
24export interface NavigatorLanguageState extends Supportable {
25  /**
26   *
27   * ISO 639-1 standard Language Code
28   *
29   * @info The detected user agent language preference as a language tag
30   * (which is sometimes referred to as a "locale identifier").
31   * This consists of a 2-3 letter base language tag that indicates a
32   * language, optionally followed by additional subtags separated by
33   * '-'. The most common extra information is the country or region
34   * variant (like 'en-US' or 'fr-CA').
35   *
36   *
37   * @see https://www.iso.org/iso-639-language-codes.html
38   * @see https://www.loc.gov/standards/iso639-2/php/code_list.php
39   *
40   */
41  language: ShallowRef<string | undefined>
42}
43export interface UseNavigatorLanguageOptions extends ConfigurableWindow {}
44export type UseNavigatorLanguageReturn = Readonly<NavigatorLanguageState>
45/**
46 *
47 * Reactive useNavigatorLanguage
48 *
49 * Detects the currently selected user language and returns a reactive language
50 * @see https://vueuse.org/useNavigatorLanguage
51 *
52 * @__NO_SIDE_EFFECTS__
53 */
54export declare function useNavigatorLanguage(
55  options?: UseNavigatorLanguageOptions,
56): UseNavigatorLanguageReturn
57```
58