Intl.Locale.prototype.script
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2020.
The script
accessor property of Intl.Locale
instances returns the script used for writing the particular language used in this locale.
Description
Script, sometimes called writing system, is one of the core attributes of a locale. It indicates the set of symbols, or glyphs, that are used to write a particular language. For instance, the script associated with English is Latin, whereas the script typically associated with Korean is Hangul. In many cases, denoting a script is not strictly necessary, since the language (which is necessary) is only written in a single script. There are exceptions to this rule, however, and it is important to indicate the script when multiple scripts are applicable. The script
property's value is set at construction time, either through the script
subtag (second part, if present) of the locale identifier or through the script
option of the Intl.Locale()
constructor. The latter takes priority if they are both present; and if neither is present, the property has value undefined
.
The set accessor of script
is undefined
. You cannot change this property directly.
Examples
Like other locale subtags, the script can be added to the Intl.Locale
object via the locale string, or a configuration object argument to the constructor.
Adding a script via the locale string
The script, if present, is the second part of a valid Unicode language identifier string, and can be added to the initial locale identifier string that is passed into the Intl.Locale()
constructor. Note that the script is not a required part of a locale identifier.
const locale = new Intl.Locale("en-Latn-US");
console.log(locale.script); // Prints "Latn"
Adding a script via the configuration object argument
The Intl.Locale()
constructor has an optional configuration object argument. Set the script
property of the configuration object to your desired script, and then pass it into the constructor.
const locale = new Intl.Locale("fr-FR", { script: "Latn" });
console.log(locale.script); // Prints "Latn"
Specifications
Specification |
---|
ECMAScript Internationalization API Specification # sec-Intl.Locale.prototype.script |
Browser compatibility
BCD tables only load in the browser
See also
Intl.Locale
- Unicode script subtag in the Unicode locale data markup language spec