Gecko [ thecigaretteboxes.com ]

Name	Size	Permission
assets	[ DIR ]	drwxr-xr-x
addons.html	105.72 KB	-rw-r--r--
addons.json.gz	10.95 KB	-rw-r--r--
addons.md	39.76 KB	-rw-r--r--
all.html	7.2 MB	-rw-r--r--
all.json.gz	881.44 KB	-rw-r--r--
assert.html	191.3 KB	-rw-r--r--
assert.json.gz	13 KB	-rw-r--r--
assert.md	66.51 KB	-rw-r--r--
async_context.html	84.04 KB	-rw-r--r--
async_context.json.gz	7.09 KB	-rw-r--r--
async_context.md	24.68 KB	-rw-r--r--
async_hooks.html	87.13 KB	-rw-r--r--
async_hooks.json.gz	9.82 KB	-rw-r--r--
async_hooks.md	30.48 KB	-rw-r--r--
buffer.html	479.09 KB	-rw-r--r--
buffer.json.gz	28.89 KB	-rw-r--r--
buffer.md	148.96 KB	-rw-r--r--
child_process.html	168.62 KB	-rw-r--r--
child_process.json.gz	20.9 KB	-rw-r--r--
child_process.md	70.54 KB	-rw-r--r--
cli.html	154.13 KB	-rw-r--r--
cli.json.gz	23.79 KB	-rw-r--r--
cli.md	63.8 KB	-rw-r--r--
cluster.html	90.59 KB	-rw-r--r--
cluster.json.gz	9.48 KB	-rw-r--r--
cluster.md	28.84 KB	-rw-r--r--
console.html	59.43 KB	-rw-r--r--
console.json.gz	6.07 KB	-rw-r--r--
console.md	16.5 KB	-rw-r--r--
corepack.html	22.56 KB	-rw-r--r--
corepack.json.gz	2.55 KB	-rw-r--r--
corepack.md	5.08 KB	-rw-r--r--
crypto.html	521.88 KB	-rw-r--r--
crypto.json.gz	45.72 KB	-rw-r--r--
crypto.md	193.91 KB	-rw-r--r--
debugger.html	28.15 KB	-rw-r--r--
debugger.json.gz	3.12 KB	-rw-r--r--
debugger.md	7.02 KB	-rw-r--r--
deprecations.html	197.6 KB	-rw-r--r--
deprecations.json.gz	23.7 KB	-rw-r--r--
deprecations.md	97.51 KB	-rw-r--r--
dgram.html	89.39 KB	-rw-r--r--
dgram.json.gz	10.07 KB	-rw-r--r--
dgram.md	30.76 KB	-rw-r--r--
diagnostics_channel.html	44.76 KB	-rw-r--r--
diagnostics_channel.json.gz	3.2 KB	-rw-r--r--
diagnostics_channel.md	11.09 KB	-rw-r--r--
dns.html	130.7 KB	-rw-r--r--
dns.json.gz	15.74 KB	-rw-r--r--
dns.md	52.17 KB	-rw-r--r--
documentation.html	25.04 KB	-rw-r--r--
documentation.json.gz	2.22 KB	-rw-r--r--
documentation.md	4.67 KB	-rw-r--r--
domain.html	48.47 KB	-rw-r--r--
domain.json.gz	6.2 KB	-rw-r--r--
domain.md	15.21 KB	-rw-r--r--
embedding.html	25.79 KB	-rw-r--r--
embedding.json.gz	3.01 KB	-rw-r--r--
embedding.md	6.65 KB	-rw-r--r--
errors.html	282.1 KB	-rw-r--r--
errors.json.gz	42.26 KB	-rw-r--r--
errors.md	96.75 KB	-rw-r--r--
esm.html	126.92 KB	-rw-r--r--
esm.json.gz	20.56 KB	-rw-r--r--
esm.md	58.28 KB	-rw-r--r--
events.html	225.71 KB	-rw-r--r--
events.json.gz	16.69 KB	-rw-r--r--
events.md	64.93 KB	-rw-r--r--
fs.html	628.53 KB	-rw-r--r--
fs.json.gz	66.73 KB	-rw-r--r--
fs.md	247.34 KB	-rw-r--r--
globals.html	74.86 KB	-rw-r--r--
globals.json.gz	9 KB	-rw-r--r--
globals.md	20.04 KB	-rw-r--r--
http.html	275.03 KB	-rw-r--r--
http.json.gz	35.28 KB	-rw-r--r--
http.md	106.51 KB	-rw-r--r--
http2.html	318.05 KB	-rw-r--r--
http2.json.gz	39.24 KB	-rw-r--r--
http2.md	129.92 KB	-rw-r--r--
https.html	56.48 KB	-rw-r--r--
https.json.gz	5.69 KB	-rw-r--r--
https.md	16.33 KB	-rw-r--r--
index.html	12.63 KB	-rw-r--r--
index.json	54 B	-rw-r--r--
index.md	1.97 KB	-rw-r--r--
inspector.html	34.25 KB	-rw-r--r--
inspector.json.gz	3.62 KB	-rw-r--r--
inspector.md	7.63 KB	-rw-r--r--
intl.html	31.9 KB	-rw-r--r--
intl.json.gz	3.87 KB	-rw-r--r--
intl.md	10.71 KB	-rw-r--r--
module.html	30.94 KB	-rw-r--r--
module.json.gz	2.7 KB	-rw-r--r--
module.md	5.12 KB	-rw-r--r--
modules.html	80.58 KB	-rw-r--r--
modules.json.gz	12.65 KB	-rw-r--r--
modules.md	32.97 KB	-rw-r--r--
n-api.html	395.21 KB	-rw-r--r--
n-api.json.gz	50.69 KB	-rw-r--r--
n-api.md	214.45 KB	-rw-r--r--
net.html	140.93 KB	-rw-r--r--
net.json.gz	17.64 KB	-rw-r--r--
net.md	50.96 KB	-rw-r--r--
os.html	71.85 KB	-rw-r--r--
os.json.gz	8.88 KB	-rw-r--r--
os.md	35.5 KB	-rw-r--r--
packages.html	99.12 KB	-rw-r--r--
packages.json.gz	15.18 KB	-rw-r--r--
packages.md	45.48 KB	-rw-r--r--
path.html	52.44 KB	-rw-r--r--
path.json.gz	4.9 KB	-rw-r--r--
path.md	14.91 KB	-rw-r--r--
perf_hooks.html	139.88 KB	-rw-r--r--
perf_hooks.json.gz	12.51 KB	-rw-r--r--
perf_hooks.md	42.15 KB	-rw-r--r--
permissions.html	44.6 KB	-rw-r--r--
permissions.json.gz	5.44 KB	-rw-r--r--
permissions.md	14.59 KB	-rw-r--r--
policy.html	14.21 KB	-rw-r--r--
policy.json	475 B	-rw-r--r--
policy.md	221 B	-rw-r--r--
process.html	290.1 KB	-rw-r--r--
process.json.gz	31.21 KB	-rw-r--r--
process.md	106.75 KB	-rw-r--r--
punycode.html	26.24 KB	-rw-r--r--
punycode.json.gz	2 KB	-rw-r--r--
punycode.md	4.17 KB	-rw-r--r--
querystring.html	28.24 KB	-rw-r--r--
querystring.json.gz	2.65 KB	-rw-r--r--
querystring.md	5.57 KB	-rw-r--r--
readline.html	109.24 KB	-rw-r--r--
readline.json.gz	11.9 KB	-rw-r--r--
readline.md	40.45 KB	-rw-r--r--
repl.html	68.72 KB	-rw-r--r--
repl.json.gz	10 KB	-rw-r--r--
repl.md	23.69 KB	-rw-r--r--
report.html	81.54 KB	-rw-r--r--
report.json.gz	6.39 KB	-rw-r--r--
report.md	18.83 KB	-rw-r--r--
single-executable-applications...	23.53 KB	-rw-r--r--
single-executable-applications...	2.36 KB	-rw-r--r--
single-executable-applications...	5.12 KB	-rw-r--r--
stream.html	397.04 KB	-rw-r--r--
stream.json.gz	51.16 KB	-rw-r--r--
stream.md	145.8 KB	-rw-r--r--
string_decoder.html	23.21 KB	-rw-r--r--
string_decoder.json.gz	1.54 KB	-rw-r--r--
string_decoder.md	2.96 KB	-rw-r--r--
synopsis.html	19.54 KB	-rw-r--r--
synopsis.json	2.96 KB	-rw-r--r--
synopsis.md	2.12 KB	-rw-r--r--
test.html	168.11 KB	-rw-r--r--
test.json.gz	16.62 KB	-rw-r--r--
test.md	57.47 KB	-rw-r--r--
timers.html	55.89 KB	-rw-r--r--
timers.json.gz	5.21 KB	-rw-r--r--
timers.md	15.53 KB	-rw-r--r--
tls.html	179.78 KB	-rw-r--r--
tls.json.gz	32.31 KB	-rw-r--r--
tls.md	87.96 KB	-rw-r--r--
tracing.html	34.37 KB	-rw-r--r--
tracing.json.gz	3.47 KB	-rw-r--r--
tracing.md	8.52 KB	-rw-r--r--
tty.html	36.94 KB	-rw-r--r--
tty.json.gz	3.72 KB	-rw-r--r--
tty.md	8.91 KB	-rw-r--r--
url.html	150.42 KB	-rw-r--r--
url.json.gz	15.7 KB	-rw-r--r--
url.md	53.65 KB	-rw-r--r--
util.html	285.68 KB	-rw-r--r--
util.json.gz	25.73 KB	-rw-r--r--
util.md	96.25 KB	-rw-r--r--
v8.html	111.35 KB	-rw-r--r--
v8.json.gz	11.86 KB	-rw-r--r--
v8.md	34.31 KB	-rw-r--r--
vm.html	142.53 KB	-rw-r--r--
vm.json.gz	16.81 KB	-rw-r--r--
vm.md	59.81 KB	-rw-r--r--
wasi.html	27.91 KB	-rw-r--r--
wasi.json.gz	2.86 KB	-rw-r--r--
wasi.md	6.54 KB	-rw-r--r--
webcrypto.html	152.21 KB	-rw-r--r--
webcrypto.json.gz	9.76 KB	-rw-r--r--
webcrypto.md	45.48 KB	-rw-r--r--
webstreams.html	150.7 KB	-rw-r--r--
webstreams.json.gz	9.88 KB	-rw-r--r--
webstreams.md	36.82 KB	-rw-r--r--
worker_threads.html	113.35 KB	-rw-r--r--
worker_threads.json.gz	14.43 KB	-rw-r--r--
worker_threads.md	43.13 KB	-rw-r--r--
zlib.html	108.85 KB	-rw-r--r--
zlib.json.gz	10.34 KB	-rw-r--r--
zlib.md	35.1 KB	-rw-r--r--

Code Editor : intl.md

# Internationalization support

Node.js has many features that make it easier to write internationalized
programs. Some of them are:

* Locale-sensitive or Unicode-aware functions in the [ECMAScript Language
  Specification][ECMA-262]:
  * [`String.prototype.normalize()`][]
  * [`String.prototype.toLowerCase()`][]
  * [`String.prototype.toUpperCase()`][]
* All functionality described in the [ECMAScript Internationalization API
  Specification][ECMA-402] (aka ECMA-402):
  * [`Intl`][] object
  * Locale-sensitive methods like [`String.prototype.localeCompare()`][] and
    [`Date.prototype.toLocaleString()`][]
* The [WHATWG URL parser][]'s [internationalized domain names][] (IDNs) support
* [`require('node:buffer').transcode()`][]
* More accurate [REPL][] line editing
* [`require('node:util').TextDecoder`][]
* [`RegExp` Unicode Property Escapes][]

Node.js and the underlying V8 engine use
[International Components for Unicode (ICU)][ICU] to implement these features
in native C/C++ code. The full ICU data set is provided by Node.js by default.
However, due to the size of the ICU data file, several
options are provided for customizing the ICU data set either when
building or running Node.js.

## Options for building Node.js

To control how ICU is used in Node.js, four `configure` options are available
during compilation. Additional details on how to compile Node.js are documented
in [BUILDING.md][].

* `--with-intl=none`/`--without-intl`
* `--with-intl=system-icu`
* `--with-intl=small-icu`
* `--with-intl=full-icu` (default)

An overview of available Node.js and JavaScript features for each `configure`
option:

| Feature                                  | `none`                            | `system-icu`                 | `small-icu`            | `full-icu` |
| ---------------------------------------- | --------------------------------- | ---------------------------- | ---------------------- | ---------- |
| [`String.prototype.normalize()`][]       | none (function is no-op)          | full                         | full                   | full       |
| `String.prototype.to*Case()`             | full                              | full                         | full                   | full       |
| [`Intl`][]                               | none (object does not exist)      | partial/full (depends on OS) | partial (English-only) | full       |
| [`String.prototype.localeCompare()`][]   | partial (not locale-aware)        | full                         | full                   | full       |
| `String.prototype.toLocale*Case()`       | partial (not locale-aware)        | full                         | full                   | full       |
| [`Number.prototype.toLocaleString()`][]  | partial (not locale-aware)        | partial/full (depends on OS) | partial (English-only) | full       |
| `Date.prototype.toLocale*String()`       | partial (not locale-aware)        | partial/full (depends on OS) | partial (English-only) | full       |
| [Legacy URL Parser][]                    | partial (no IDN support)          | full                         | full                   | full       |
| [WHATWG URL Parser][]                    | partial (no IDN support)          | full                         | full                   | full       |
| [`require('node:buffer').transcode()`][] | none (function does not exist)    | full                         | full                   | full       |
| [REPL][]                                 | partial (inaccurate line editing) | full                         | full                   | full       |
| [`require('node:util').TextDecoder`][]   | partial (basic encodings support) | partial/full (depends on OS) | partial (Unicode-only) | full       |
| [`RegExp` Unicode Property Escapes][]    | none (invalid `RegExp` error)     | full                         | full                   | full       |

The "(not locale-aware)" designation denotes that the function carries out its
operation just like the non-`Locale` version of the function, if one
exists. For example, under `none` mode, `Date.prototype.toLocaleString()`'s
operation is identical to that of `Date.prototype.toString()`.

### Disable all internationalization features (`none`)

If this option is chosen, ICU is disabled and most internationalization
features mentioned above will be **unavailable** in the resulting `node` binary.

### Build with a pre-installed ICU (`system-icu`)

Node.js can link against an ICU build already installed on the system. In fact,
most Linux distributions already come with ICU installed, and this option would
make it possible to reuse the same set of data used by other components in the
OS.

Functionalities that only require the ICU library itself, such as
[`String.prototype.normalize()`][] and the [WHATWG URL parser][], are fully
supported under `system-icu`. Features that require ICU locale data in
addition, such as [`Intl.DateTimeFormat`][] _may_ be fully or partially
supported, depending on the completeness of the ICU data installed on the
system.

### Embed a limited set of ICU data (`small-icu`)

This option makes the resulting binary link against the ICU library statically,
and includes a subset of ICU data (typically only the English locale) within
the `node` executable.

Functionalities that only require the ICU library itself, such as
[`String.prototype.normalize()`][] and the [WHATWG URL parser][], are fully
supported under `small-icu`. Features that require ICU locale data in addition,
such as [`Intl.DateTimeFormat`][], generally only work with the English locale:

```js
const january = new Date(9e8);
const english = new Intl.DateTimeFormat('en', { month: 'long' });
const spanish = new Intl.DateTimeFormat('es', { month: 'long' });

console.log(english.format(january));
// Prints "January"
console.log(spanish.format(january));
// Prints either "M01" or "January" on small-icu, depending on the user’s default locale
// Should print "enero"
```

This mode provides a balance between features and binary size.

#### Providing ICU data at runtime

If the `small-icu` option is used, one can still provide additional locale data
at runtime so that the JS methods would work for all ICU locales. Assuming the
data file is stored at `/some/directory`, it can be made available to ICU
through either:

* The [`NODE_ICU_DATA`][] environment variable:

```bash
  env NODE_ICU_DATA=/some/directory node
  ```

* The [`--icu-data-dir`][] CLI parameter:

```bash
  node --icu-data-dir=/some/directory
  ```

(If both are specified, the `--icu-data-dir` CLI parameter takes precedence.)

ICU is able to automatically find and load a variety of data formats, but the
data must be appropriate for the ICU version, and the file correctly named.
The most common name for the data file is `icudt6X[bl].dat`, where `6X` denotes
the intended ICU version, and `b` or `l` indicates the system's endianness.
Check ["ICU Data"][] article in the ICU User Guide for other supported formats
and more details on ICU data in general.

The [full-icu][] npm module can greatly simplify ICU data installation by
detecting the ICU version of the running `node` executable and downloading the
appropriate data file. After installing the module through `npm i full-icu`,
the data file will be available at `./node_modules/full-icu`. This path can be
then passed either to `NODE_ICU_DATA` or `--icu-data-dir` as shown above to
enable full `Intl` support.

### Embed the entire ICU (`full-icu`)

This option makes the resulting binary link against ICU statically and include
a full set of ICU data. A binary created this way has no further external
dependencies and supports all locales, but might be rather large. This is
the default behavior if no `--with-intl` flag is passed. The official binaries
are also built in this mode.

## Detecting internationalization support

To verify that ICU is enabled at all (`system-icu`, `small-icu`, or
`full-icu`), simply checking the existence of `Intl` should suffice:

```js
const hasICU = typeof Intl === 'object';
```

Alternatively, checking for `process.versions.icu`, a property defined only
when ICU is enabled, works too:

```js
const hasICU = typeof process.versions.icu === 'string';
```

To check for support for a non-English locale (i.e. `full-icu` or
`system-icu`), [`Intl.DateTimeFormat`][] can be a good distinguishing factor:

```js
const hasFullICU = (() => {
  try {
    const january = new Date(9e8);
    const spanish = new Intl.DateTimeFormat('es', { month: 'long' });
    return spanish.format(january) === 'enero';
  } catch (err) {
    return false;
  }
})();
```

For more verbose tests for `Intl` support, the following resources may be found
to be helpful:

* [btest402][]: Generally used to check whether Node.js with `Intl` support is
  built correctly.
* [Test262][]: ECMAScript's official conformance test suite includes a section
  dedicated to ECMA-402.

["ICU Data"]: http://userguide.icu-project.org/icudata
[BUILDING.md]: https://github.com/nodejs/node/blob/HEAD/BUILDING.md
[ECMA-262]: https://tc39.github.io/ecma262/
[ECMA-402]: https://tc39.github.io/ecma402/
[ICU]: http://site.icu-project.org/
[Legacy URL parser]: url.md#legacy-url-api
[REPL]: repl.md#repl
[Test262]: https://github.com/tc39/test262/tree/HEAD/test/intl402
[WHATWG URL parser]: url.md#the-whatwg-url-api
[`--icu-data-dir`]: cli.md#--icu-data-dirfile
[`Date.prototype.toLocaleString()`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toLocaleString
[`Intl.DateTimeFormat`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/DateTimeFormat
[`Intl`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl
[`NODE_ICU_DATA`]: cli.md#node_icu_datafile
[`Number.prototype.toLocaleString()`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number/toLocaleString
[`RegExp` Unicode Property Escapes]: https://github.com/tc39/proposal-regexp-unicode-property-escapes
[`String.prototype.localeCompare()`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/localeCompare
[`String.prototype.normalize()`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/normalize
[`String.prototype.toLowerCase()`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/toLowerCase
[`String.prototype.toUpperCase()`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/toUpperCase
[`require('node:buffer').transcode()`]: buffer.md#buffertranscodesource-fromenc-toenc
[`require('node:util').TextDecoder`]: util.md#class-utiltextdecoder
[btest402]: https://github.com/srl295/btest402
[full-icu]: https://www.npmjs.com/package/full-icu
[internationalized domain names]: https://en.wikipedia.org/wiki/Internationalized_domain_name

${this.title}

Code Editor : intl.md