recursal/MDN huggingface dataset:
Boolean.prototype.valueOf()
===========================

Сводка
------

Метод **`valueOf()`** возвращает примитивное значение объекта `Boolean`.

Синтаксис
---------
```

bool.valueOf()
```

### Параметры

Нет.

Описание
--------

Метод `valueOf` объекта `Boolean` возвращает примитивное значение объекта или литерала логического типа.

Этот метод обычно вызывается внутри движка JavaScript, а не явно в коде.

Примеры
-------

### Пример: использование `valueOf`


```js
x = new Boolean();
myVar = x.valueOf(); // присваивает false переменной myVar
```

Спецификации
------------

| Specification |
| --- |
| ECMAScript Language Specification # sec-boolean.prototype.valueof |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Смотрите также
--------------

* `Object.prototype.valueOf()`
Boolean.prototype.toString()
============================

Сводка
------

Метод **`toString()`** возвращает строковое представление указанного объекта `Boolean`.

Синтаксис
---------
```

bool.toString()
```

### Параметры

Нет.

Описание
--------

Объект `Boolean` переопределяет метод `toString` объекта `Object`; он не наследует метод `Object.prototype.toString()`. Для объектов `Boolean` метод `toString` возвращает строковое представление объекта.

JavaScript вызывает метод `toString` автоматически, когда объект `Boolean` должен быть представлен в виде текста или когда объект `Boolean` находится в контексте строковой конкатенации.

Для объектов и значений `Boolean` встроенный метод `toString` возвращает строки «`true`» или «`false`» в зависимости от значения логического объекта.

Примеры
-------

### Пример: использование `toString`

В следующем коде вызов `flag.toString()` вернёт строку `"true"`:


```js
var flag = new Boolean(true);
var myVar = flag.toString();
```

Спецификации
------------

| Specification |
| --- |
| ECMAScript Language Specification # sec-boolean.prototype.tostring |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Смотрите также
--------------

* `Object.prototype.toString()`
Intl.ListFormat
===============

Объект **`Intl.ListFormat`** представляет собой конструктор объектов, включающих языка-зависимое форматирование списков.

Интерактивный пример
--------------------

Синтаксис
---------
```

new Intl.ListFormat([locales[, options]])
```

### Параметры

`locales`

Необязательный параметр. Строка с языковой меткой BCP 47 или массив таких строк. Описание общей формы и интерпретации аргумента `locales` смотрите на странице Intl.

`options`

Необязательный параметр. Объект с некоторыми или всеми из следующих свойств:

* `localeMatcher`
 Используемый алгоритм сопоставления локалей. Возможные значения: `"lookup"` и `"best fit"`; по умолчанию используется `"best fit"`. Подробнее см. на странице `Intl`.
* `type`
 Формат вывода. Возможные значения: `"conjunction"` для вывода значений через "и" (используется по умолчанию, прим. `A, B и C`) или `"disjunction"` для вывода значений через "или" (прим. `A, B или C`). `"unit"` для вывода значений с единицами измерений (прим. `5 фунтов, 12 унций`).
* `style`
 Стиль форматирования вывода. Возможные значения: `"long"` (используется по умолчанию, прим. `A, B и C`); `"short"` или `"narrow"` (прим. `A, B, C`). При использовании `narrow`, параметр `type` может принимать только значение `unit`.

Описание
--------

### Свойства

`Intl.ListFormat.prototype` (en-US)

Позволяет добавлять свойства ко всем объектам `Intl.ListFormat`

### Методы

`Intl.ListFormat.supportedLocalesOf()` (en-US)

Возвращает массив, содержащий те из переданных ему локалей, которые поддерживаются без необходимости использовать локаль по умолчанию.

Примеры
-------

### Использование `format`

Пример ниже показывает как создать объект `ListFormat` с поддержкой форматирования на русском языке и получить отформатированную строку с помощью метода `format`.


```js
const list = ["Motorcycle", "Bus", "Car"];

console.log(
  new Intl.ListFormat("ru-RU", { style: "long", type: "conjunction" }).format(
    list,
  ),
);
// > Motorcycle, Bus и Car

console.log(
  new Intl.ListFormat("ru-RU", { style: "short", type: "disjunction" }).format(
    list,
  ),
);
// > Motorcycle, Bus или Car

console.log(
  new Intl.ListFormat("ru-RU", { style: "narrow", type: "unit" }).format(list),
);
// > Motorcycle Bus Car
```

### Использование `formatToParts`

Пример ниже показывает как получить отформатированные части объекта `ListFormat` с помощью метода `formatToParts`.


```js
const list = ["Motorcycle", "Bus", "Car"];
console.log(
  new Intl.ListFormat("en-GB", {
    style: "long",
    type: "conjunction",
  }).formatToParts(list),
);

// > [ { "type": "element", "value": "Motorcycle" }, { "type": "literal", "value": ", " }, { "type": "element", "value": "Bus" }, { "type": "literal", "value": ", and " }, { "type": "element", "value": "Car" } ];
```

Спецификации
------------

| Specification |
| --- |
| ECMAScript Internationalization API Specification # listformat-objects |
Intl.getCanonicalLocales()
==========================

Метод **`Intl.getCanonicalLocales()`** возвращает массив, содержащий канонические коды языков. Повторяющиеся значения будут отброшены и элементы будут проверены на соответствие структуры языковых тегов.

Интерактивный пример
--------------------

Синтаксис
---------
```

Intl.getCanonicalLocales(locales)
```

### Параметры

`locales`

Список `String` значений, из которых нужно получить канонические коды языков.

### Возвращаемое значение

Массив, содержащий канонические коды языков

Примеры
-------


```js
Intl.getCanonicalLocales("RU-RU"); // ["ru-RU"]
Intl.getCanonicalLocales(["RU-RU", "Fr"]); // ["ru-RU", "fr"]

Intl.getCanonicalLocales("RU\_RU");
// RangeError:'EN\_US' is not a structurally valid language tag
```

Спецификации
------------

| Specification |
| --- |
| ECMAScript Internationalization API Specification # sec-intl.getcanonicallocales |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Смотрите также
--------------

* `Intl.NumberFormat.supportedLocalesOf()`
* `Intl.DateTimeFormat.supportedLocalesOf()`
* `Intl.Collator.supportedLocalesOf()`
Intl.DateTimeFormat.prototype.resolvedOptions()
===============================================

Сводка
------

Метод **`Intl.DateTimeFormat.prototype.resolvedOptions()`** возвращает новый объект со свойствами, отражающими локаль и параметры форматирования даты и времени, вычисленные во время инициализации соответствующего объекта `DateTimeFormat`.

Синтаксис
---------
```

dateTimeFormat.resolvedOptions()
```

Описание
--------

Возвращает новый объект со свойствами, отражающими локаль и параметры форматирования чисел, вычисленные во время инициализации соответствующего объекта `DateTimeFormat`. Объект содержит следующие свойства:

`locale`

Языковая метка BCP 47 реально используемой локали. Если во входной языковой метке BCP 47 запрошены какие-либо расширения Unicode, приведшие к этой локали, запрошенные и поддерживаемые для этой локали пары ключ-значение также будут включены в свойство `locale`.

`calendar`

`numberingSystem`

Значения, запрошенные ключами расширения Unicode `"ca"` и `"nu"`, либо значения по умолчанию.

`timeZone`

Значение, предоставленное для этого свойства в аргументе `options`; `undefined` (представляет временную зону по умолчанию среды выполнения), если ничего не было предоставлено. Предупреждение: приложения не должны полагаться на возврат `undefined`, поскольку будущие версии вместо него могут возвращать строковое значение, идентифицирующее временную зону по умолчанию среды выполнения.

`hour12`

Значение, предоставленное для этого свойства в аргументе `options`, либо значение по умолчанию.

`weekday`

`era`

`year`

`month`

`day`

`hour`

`minute`

`second`

`timeZoneName`

Значения, получившиеся в результате объединения соответствующих свойств в аргументе `options` и доступных комбинаций и представлений форматирования даты/времени в выбранной локали. Некоторые из этих свойств могут не присутствовать, что означает, что соответствующие компоненты не попадают в форматированный вывод.

Спецификации
------------

| Specification |
| --- |
| ECMAScript Internationalization API Specification # sec-intl.datetimeformat.prototype.resolvedoptions |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Смотрите также
--------------

* `Intl.DateTimeFormat`
Intl.DateTimeFormat.supportedLocalesOf()
========================================

Сводка
------

Метод **`Intl.DateTimeFormat.supportedLocalesOf()`** возвращает массив, содержащий те из предоставленных локалей, что поддерживаются при форматировании даты и времени без отката к локали по умолчанию среды выполнения.

Синтаксис
---------
```

Intl.DateTimeFormat.supportedLocalesOf(locales[, options])
```

### Параметры

`locales`

Строка с языковой меткой BCP 47, либо массив таких строк. Описание общей формы и интерпретации аргумента `locales` смотрите на странице, посвящённой объекту Intl.

`options`

Необязательный параметр. Объект, который может содержать следующее свойство:

`localeMatcher`

Используемый алгоритм сопоставления локалей. Возможными значениями являются `"lookup"` и `"best fit"`; значением по умолчанию является `"best fit"`. Информацию по этой опции смотрите на странице, посвящённой объекту Intl.


Описание
--------

Возвращает массив с подмножеством языковых меток, предоставленных в аргументе `locales`. Возвращаются те языковые метки, для которых среда выполнения поддерживает форматирование даты и времени без отката к локали по умолчанию; при поиске используется предоставленный алгоритм сопоставления локалей.

Примеры
-------

### Пример: использование `supportedLocalesOf`

Предполагая, что среда выполнения поддерживает индонезийское и немецкое, но на балийское форматирование даты и времени, метод `supportedLocalesOf` вернёт неизменными индонезийскую и немецкую языковые метки, даже несмотря на то, что сортировка `pinyin` не относится к форматированию даты и времени, не используется с индонезийским языком и вряд ли будет поддерживаться в немецком языке для Индонезии. Обратите внимание на используемую здесь спецификацию алгоритма `"lookup"` — сопоставление `"best fit"` может решить, что индонезийский язык является адекватным сопоставлением с балийским, поскольку большинство людей, говорящих на балийском, также понимают индонезийский, и поэтому может возвратиться ещё и языковая метка балийского языка.


```js
var locales = ["ban", "id-u-co-pinyin", "de-ID"];
var options = { localeMatcher: "lookup" };
console.log(
  Intl.DateTimeFormat.supportedLocalesOf(locales, options).join(", "),
);
// → "id-u-co-pinyin, de-ID"
```

Спецификации
------------

| Specification |
| --- |
| ECMAScript Internationalization API Specification # sec-intl.datetimeformat.supportedlocalesof |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Смотрите также
--------------

* `Intl.DateTimeFormat`
Intl.DateTimeFormat.prototype.format
====================================

Сводка
------

Свойство **`Intl.DateTimeFormat.prototype.format`** возвращает функцию-геттер, форматирующую дату согласно локали и параметрам форматирования соответствующего объекта `DateTimeFormat`.

Синтаксис
---------
```

dateTimeFormat.format(date)
```

### Параметры

`date`

Дата для форматирования.

Описание
--------

Функция, возвращённая геттером `format`, форматирует дату согласно локали и параметрам форматирования соответствующего объекта `DateTimeFormat`.

Примеры
-------

### Пример: использование функции `format`

Использование функции, возвращённой геттером `format`, для форматирования одной даты, здесь пример для сербского языка:


```js
var options = {
  weekday: "long",
  year: "numeric",
  month: "long",
  day: "numeric",
};
var dateTimeFormat = new Intl.DateTimeFormat("sr-RS", options);
console.log(dateTimeFormat.format(new Date()));
// → "недеља, 7. април 2013."
```

### Пример: использование функции `format` вместе с `map`

Использование функции, возвращённой геттером `format`, для форматирования всех дат в массиве. Обратите внимание, что функция привязана к объекту `DateTimeFormat`, из которого она была получена, так что её можно передавать в `Array.prototype.map()` напрямую.


```js
var a = [new Date(2012, 08), new Date(2012, 11), new Date(2012, 03)];
var options = { year: "numeric", month: "long" };
var dateTimeFormat = new Intl.DateTimeFormat("pt-BR", options);
var formatted = a.map(dateTimeFormat.format);
console.log(formatted.join("; "));
// → "setembro de 2012; dezembro de 2012; abril de 2012"
```

Спецификации
------------

| Specification |
| --- |
| ECMAScript Internationalization API Specification # sec-intl.datetimeformat.prototype.format |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Смотрите также
--------------

* `Intl.DateTimeFormat`
* `Date.prototype.toLocaleString()`
* `Date.prototype.toLocaleDateString()`
* `Date.prototype.toLocaleTimeString()`
Intl.Collator.supportedLocalesOf()
==================================

Сводка
------

Метод **`Intl.Collator.supportedLocalesOf()`** возвращает массив, содержащий те из предоставленных локалей, что поддерживаются при сравнении строк без отката к локали по умолчанию среды выполнения.

Синтаксис
---------
```

Intl.Collator.supportedLocalesOf(locales[, options])
```

### Параметры

`locales`

Строка с языковой меткой BCP 47, либо массив таких строк. Описание общей формы и интерпретации аргумента `locales` смотрите на странице, посвящённой объекту Intl.

`options`

Необязательный параметр. Объект, который может содержать следующее свойство:

`localeMatcher`

Используемый алгоритм сопоставления локалей. Возможными значениями являются `"lookup"` и `"best fit"`; значением по умолчанию является `"best fit"`. Информацию по этой опции смотрите на странице, посвящённой объекту Intl.


Описание
--------

Возвращает массив с подмножеством языковых меток, предоставленных в аргументе `locales`. Возвращаются те языковые метки, для которых среда выполнения поддерживает сравнение строк без отката к локали по умолчанию; при поиске используется предоставленный алгоритм сопоставления локалей.

Примеры
-------

### Пример: использование `supportedLocalesOf`

Предполагая, что среда выполнения поддерживает индонезийское и немецкое, но на балийское сравнение строк, метод `supportedLocalesOf` вернёт неизменными индонезийскую и немецкую языковые метки, даже несмотря на то, что сортировка `pinyin` не используется с индонезийским языком и вряд ли будет поддерживаться в немецком языке для Индонезии. Обратите внимание на используемую здесь спецификацию алгоритма `"lookup"` — сопоставление `"best fit"` может решить, что индонезийский язык является адекватным сопоставлением с балийским, поскольку большинство людей, говорящих на балийском, также понимают индонезийский, и поэтому может возвратиться ещё и языковая метка балийского языка.


```js
var locales = ["ban", "id-u-co-pinyin", "de-ID"];
var options = { localeMatcher: "lookup" };
console.log(Intl.Collator.supportedLocalesOf(locales, options).join(", "));
// → "id-u-co-pinyin, de-ID"
```

Спецификации
------------

| Specification |
| --- |
| ECMAScript Internationalization API Specification # sec-intl.collator.supportedlocalesof |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Смотрите также
--------------

* `Intl.Collator`
Intl.Collator.prototype.resolvedOptions()
=========================================

Сводка
------

Метод **`Intl.Collator.prototype.resolvedOptions()`** возвращает новый объект со свойствами, отражающими локаль и параметры сравнения строк, вычисленные во время инициализации соответствующего объекта `Collator`.

Синтаксис
---------
```

collator.resolvedOptions()
```

Описание
--------

Возвращает новый объект со свойствами, отражающими локаль и параметры сравнения строк, вычисленные во время инициализации соответствующего объекта `Collator`. Объект содержит следующие свойства:

`locale`

Языковая метка BCP 47 реально используемой локали. Если во входной языковой метке BCP 47 запрошены какие-либо расширения Unicode, приведшие к этой локали, запрошенные и поддерживаемые для этой локали пары ключ-значение также будут включены в свойство `locale`.

`usage`

`sensitivity`

`ignorePunctuation`

Значения, предоставленные для этих свойств в аргументе `options`, либо значения по умолчанию.

`collation`

Значение, запрошенное ключом расширения Unicode `"co"`, если он поддерживается для локали `locale`, либо значение `"default"`.

`numeric`

`caseFirst`

Значения, предоставленные для этих свойств в аргументе `options` или запрошенные ключами расширения Unicode `"kn"` и `"kf"`, либо значения по умолчанию. Если реализация не поддерживает эти свойства, они будут опущены.

Спецификации
------------

| Specification |
| --- |
| ECMAScript Internationalization API Specification # sec-intl.collator.prototype.resolvedoptions |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Смотрите также
--------------

* `Intl.Collator`
Intl.Collator.prototype.compare
===============================

Сводка
------

Свойство **`Intl.Collator.prototype.compare`** возвращает функцию-геттер, сравнивающую две строки согласно порядку сортировки соответствующего объекта `Collator`.

Синтаксис
---------
```

collator.compare(string1, string2)
```

### Параметры

`string1`

`string2`

Сравниваемые друг с другом строки.

Описание
--------

Функция, возвращённая геттером `compare`, возвращает число, указывающее, как строки `string1` и `string2` сравниваются друг с другом в соответствии с порядком сортировки объекта `Collator`: отрицательное значение, если строка `string1` предшествует строке `string2`; положительное значение, если строка `string1` следует за строкой `string2`; 0, если строки считаются равными.

Примеры
-------

### Пример: использование функции `compare` для сортировки массива

Использование функции, возвращённой геттером `compare`, для сортировки массивов. Обратите внимание, что функция привязана к объекту `Collator`, из которого она была получена, так что её можно передавать в `Array.prototype.sort()` напрямую.


```js
var a = ["Offenbach", "Österreich", "Odenwald"];
var collator = new Intl.Collator("de-u-co-phonebk");
a.sort(collator.compare);
console.log(a.join(", "));
// → "Odenwald, Österreich, Offenbach"
```

### Пример: использование функции `compare` для поиска в массиве

Использование функции, возвращённой геттером `compare`, для поиска совпадающих строк в массиве:


```js
var a = ["Congrès", "congres", "Assemblée", "poisson"];
var collator = new Intl.Collator("fr", {
  usage: "search",
  sensitivity: "base",
});
var s = "congres";
var matches = a.filter(function (v) {
  return collator.compare(v, s) === 0;
});
console.log(matches.join(", "));
// → "Congrès, congres"
```

Спецификации
------------

| Specification |
| --- |
| ECMAScript Internationalization API Specification # sec-intl.collator.prototype.compare |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Смотрите также
--------------

* `Intl.Collator`
* `String.prototype.localeCompare()`
Intl.NumberFormat.supportedLocalesOf()
======================================

Сводка
------

Метод **`Intl.NumberFormat.supportedLocalesOf()`** возвращает массив, содержащий те из предоставленных локалей, что поддерживаются при форматировании чисел без отката к локали по умолчанию среды выполнения.

Синтаксис
---------
```

Intl.NumberFormat.supportedLocalesOf(locales[, options])
```

### Параметры

`locales`

Строка с языковой меткой BCP 47, либо массив таких строк. Описание общей формы и интерпретации аргумента `locales` смотрите на странице, посвящённой объекту Intl.

`options`

Необязательный параметр. Объект, который может содержать следующее свойство:

`localeMatcher`

Используемый алгоритм сопоставления локалей. Возможными значениями являются `"lookup"` и `"best fit"`; значением по умолчанию является `"best fit"`. Информацию по этой опции смотрите на странице, посвящённой объекту Intl.


Описание
--------

Возвращает массив с подмножеством языковых меток, предоставленных в аргументе `locales`. Возвращаются те языковые метки, для которых среда выполнения поддерживает форматирование чисел без отката к локали по умолчанию; при поиске используется предоставленный алгоритм сопоставления локалей.

Примеры
-------

### Пример: использование `supportedLocalesOf`

Предполагая, что среда выполнения поддерживает индонезийское и немецкое, но на балийское форматирование чисел, метод `supportedLocalesOf` вернёт неизменными индонезийскую и немецкую языковые метки, даже несмотря на то, что сортировка `pinyin` не относится к форматированию чисел, не используется с индонезийским языком и вряд ли будет поддерживаться в немецком языке для Индонезии. Обратите внимание на используемую здесь спецификацию алгоритма `"lookup"` — сопоставление `"best fit"` может решить, что индонезийский язык является адекватным сопоставлением с балийским, поскольку большинство людей, говорящих на балийском, также понимают индонезийский, и поэтому может возвратиться ещё и языковая метка балийского языка.


```js
var locales = ["ban", "id-u-co-pinyin", "de-ID"];
var options = { localeMatcher: "lookup" };
console.log(Intl.NumberFormat.supportedLocalesOf(locales, options).join(", "));
// → "id-u-co-pinyin, de-ID"
```

Спецификации
------------

| Specification |
| --- |
| ECMAScript Internationalization API Specification # sec-intl.numberformat.supportedlocalesof |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Смотрите также
--------------

* `Intl.NumberFormat`
Intl.NumberFormat.prototype.format
==================================

Сводка
------

Свойство **`Intl.NumberFormat.prototype.format`** возвращает функцию-геттер, форматирующую число согласно локали и параметрам форматирования соответствующего объекта `NumberFormat`.

Синтаксис
---------
```

numberFormat.format(number)
```

### Параметры

`number`

Число для форматирования.

Описание
--------

Функция, возвращённая геттером `format`, форматирует число согласно локали и параметрам форматирования соответствующего объекта `NumberFormat`.

Примеры
-------

### Пример: использование функции `format`

Использование функции, возвращённой геттером `format`, для форматирования одного значения валюты, здесь пример для русского языка:


```js
var options = { style: "currency", currency: "RUB" };
var numberFormat = new Intl.NumberFormat("ru-RU", options);
console.log(numberFormat.format(654321.987));
// → "654 321,99 руб."
```

### Пример: использование функции `format` вместе с `map`

Использование функции, возвращённой геттером `format`, для форматирования всех чисел в массиве. Обратите внимание, что функция привязана к объекту `NumberFormat`, из которого она была получена, так что её можно передавать в `Array.prototype.map` напрямую.


```js
var a = [123456.789, 987654.321, 456789.123];
var numberFormat = new Intl.NumberFormat("es-ES");
var formatted = a.map(numberFormat.format);
console.log(formatted.join("; "));
// → "123.456,789; 987.654,321; 456.789,123"
```

Спецификации
------------

| Specification |
| --- |
| ECMAScript Internationalization API Specification # sec-intl.numberformat.prototype.format |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Смотрите также
--------------

* `Intl.NumberFormat`
* `Number.prototype.toLocaleString()`