Window: languagechange event

Baseline
Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2020.

The languagechange event is fired at the global scope object when the user's preferred language changes.

Syntax

Use the event name in addEventListener():

js
addEventListener("languagechange", (event) => { })

Alternatively, assign to the event handler property of the interface:

js
onlanguagechange = (event) => { }

Event type

A generic Event.

Event handler aliases

In addition to the Window interface, the event handler property onlanguagechange is also available on the following targets:

Examples

You can use the languagechange event in an addEventListener method:

js
window.addEventListener("languagechange", () => {
  console.log("languagechange event detected!");
});

Or use the onlanguagechange event handler property (but note that this replaces other event listeners added using onlanguagechange, if any):

js
window.onlanguagechange = (event) => {
  console.log("languagechange event detected!");
};

Specifications

Specification
HTML
# event-languagechange
HTML
# handler-window-onlanguagechange

Browser compatibility

See also