Начальная

Windows Commander

Far
WinNavigator
Frigate
Norton Commander
WinNC
Dos Navigator
Servant Salamander
Turbo Browser

Winamp, Skins, Plugins
Необходимые Утилиты
Текстовые редакторы
Юмор

File managers and best utilites

JavaScript. Javascript api браузера


Версии JavaScript API — Технологии Яндекса

Система нумерации

Номер версии API состоит из трех чисел, например 2.1.44. При каждом обновлении API номер версии увеличивается по следующим правилам:

  • первое число — при значительных изменениях в архитектуре API;
  • второе число — при потере обратной совместимости с предыдущими версиями;
  • третье число — при выпуске новой версии с сохранением обратной совместимости.

Первые два числа образуют т. н. мажорную версию (например, 2.1), все три числа вместе — минорную версию (например, 2.1.47).

Поддерживаемые версии

В настоящий момент поддерживаются четыре мажорные версии JS API Яндекс.Карт:

  • 1.0 (последний минорный релиз 1.0.8) — архивная версия;
  • 1.1 (последний минорный релиз 1.1.21) — архивная версия;
  • 2.0 (последний минорный релиз 2.0.45) — архивная версия;
  • 2.1 — актуальная версия.

Архивные версии API продолжают поддерживаться, но не развиваются — т. е. в них исправляются критические ошибки, но не добавляется новая функциональность, в т. ч. поддержка новых веб-технологий.

Версия 2.1 в настоящий момент поддерживается и развивается. Список доступных минорных версий приведен в конце раздела.

Жизненный цикл версий

Примерно раз в месяц выпускается новая минорная версия текущей мажорной версии. Жизненный цикл минорной версии состоит из следующих этапов:

  1. Релиз-кандидат

    Первое время после релиза минорная версия является релиз-кандидатом, то есть она доступна для открытого использования, но еще находится на стадии утверждения. Релиз-кандидат содержит последние исправления и новую функциональность API, но использование релиз-кандидата в своих проектах не гарантирует стабильную работу. Как подключить релиз-кандидат

  2. Текущая версия (последняя стабильная версия)

    Если спустя некоторое время после выпуска в релиз-кандидате не было выявлено ошибок функциональности, то релиз-кандидат признается стабильным и устанавливается как текущая минорная версия соответствующей мажорной версии. Текущая версия может не содержать последние изменения в API (так как уже может быть выпущен следующий релиз-кандидат), но гарантирует стабильную функциональность. Как подключить текущую версию

  3. Фиксированная версия

    Как только следующий релиз-кандидат будет установлен как стабильный, предыдущая стабильная версия замораживается и устанавливается как фиксированная. Фиксированные версии доступны продолжительное время, но со временем они удаляются и заменяются ссылкой на текущую версию API. Как подключить фиксированную версию

Для каждой версии API в документации существуют отдельные справочники:

  • Справочник для релиз-кандидата публикуется сразу после релиза версии и доступен в разделе «Справочник JavaScript API». Когда релизная версия будет установлена как стабильная версия, соответствующий раздел со справочником удаляется из документации.
  • Справочник для текущей версии всегда доступен в разделе «Справочник JavaScript API».
  • Справочники для фиксированных версий доступны только в PDF-формате и приведены в конце данной страницы.
  • Справочник для браузера IE8 (доступен только в PDF-версии). Подробнее

Варианты подключения

Ниже приведены рекомендации по подключению и использованию версий API.

Подключение релиз-кандидата

Релиз-кандидат — это версия API, которая доступна для открытого использования, но находится на стадии утверждения. Прежде чем релиз-кандидат будет установлен как стабильная версия, первое время после выпуска он тестируется на наличие ошибок, которые могут привести к деградации функциональности API. Используя релиз-кандидат в своих проектах, вы поможете нам своевременно выявить возможные ошибки. Кроме того, вы сможете заранее протестировать работу приложения с новой версией API.

Релиз-кандидат следует использовать в среде разработки и тестирования приложения. Это позволит избежать появления ошибок в рабочем окружении. Подключить релиз-кандидат можно следующим образом:

<script src="https://api-maps.yandex.ru/2.1-dev/?lang=ru_RU" type="text/javascript"/> Примечание. Если при подключении новой версии API вы обнаружили какие-либо ошибки, пожалуйста, сообщите об этом нам. Это можно сделать в клубе API Карт или через форму обратной связи.

Если через некоторое время после публикации релиз-кандидата не было выявлено ошибок, приводящих к деградации функциональности, релиз-кандидат устанавливается как стабильная версия API и становится доступным по ссылке api-maps.yandex.ru/2.1.

Подключение текущей версии

При эксплуатации приложения рекомендуется указывать мажорную версию (т. е. не указывать третье число версии). В этом случае будет автоматически подключена текущая версия, то есть последняя стабильная версия соответствующей мажорной версии. Так, например, если указана версия 2.1, то будет подключена последняя стабильная на данный момент версия 2.1.x (например, 2.1.47):

<script src="https://api-maps.yandex.ru/2.1/?lang=ru_RU" type="text/javascript"/>

Подключение фиксированной версии

Хотя между минорными версиями гарантируется полная совместимость, в редких случаях может оказаться, что ваше приложение при подключении последней версии API не работает так, как было задумано. Поэтому для предотвращения таких ситуаций, в особо ответственных случаях, может потребоваться подключить строго определенную версию API. Для этого нужно указать ее номер целиком:

<script src="https://api-maps.yandex.ru/2.1.44/?lang=ru_RU" type="text/javascript"/>

Примечание. Если вы используете фиксированную версию, старайтесь регулярно переключать ее на более свежую версию (например, раз в несколько месяцев). Дело в том, что со временем мы можем отключить минорную версию, которую вы используете в своем проекте, и тогда у вас автоматически подключится текущая версия API. Но может оказаться, что при смене версий ваше приложение стало работать некорректно. Поэтому мы рекомендуем следить за обновлениями API и своевременно переключаться на более свежие версии.

Сводная таблица

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

Тип проектаРекомендуемая версия при эксплуатации приложенияРекомендуемая версия в разработке

Небольшие проекты

Конструктор карт.

Конструктор карт.

Средние и крупные проекты, с простой картой

Последняя версия api-maps.yandex.ru/2.1.

Релиз-кандидат версия api-maps.yandex.ru/2.1-dev для проверки функциональности.

Средние и крупные проекты, со сложной функциональностью карты

Фиксированная версия api-maps.yandex.ru/2.1.x (см. примечание ниже).

Релиз-кандидат версия api-maps.yandex.ru/2.1-dev для проверки функциональности.

Проекты, использующие платную версию API

Фиксированная версия enterprise.api-maps.yandex.ru/2.1.x (см. примечание ниже).Фиксированная версия enterprise.api-maps.yandex.ru/2.1.x (см. примечание ниже)

Примечание. Если вы используете фиксированную версию, старайтесь регулярно переключать ее на более свежую версию. Дело в том, что со временем мы можем отключить минорную версию, которую вы используете в приложении, и тогда у вас автоматически подключится текущая версия API. Но может оказаться, что при смене версий ваше приложение стало работать некорректно. Поэтому рекомендуется следить за обновлениями API и своевременно переключаться на более свежие версии.

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

API Яндекс.Карт корректно работает в следующих браузерах:

  • Яндекс.Браузер, включая мобильную версию;
  • Chromium и Google Chrome, включая мобильную версию;
  • Safari для Mac и iOS;
  • Mozilla Firefox;
  • Opera;
  • Microsoft Internet Explorer, включая мобильную версию при условии установки последних обновлений.

В этих браузерах доступна и работает полностью одинаково вся функциональность API Яндекс.Карт.

Частично поддерживаются следующие браузеры:

  • Microsoft Internet Explorer версий 8-10;
  • Opera версии 12;
  • AndroidBrowser версий 4.0+.

В этих браузерах доступна та функциональность API Яндекс.Карт, которую технически возможно реализовать на данной платформе. Например, в IE8 не поддерживается задание произвольных цветов меток в силу отсутствия полноценной поддержки SVG этим браузером. Кроме того, внешний вид графических объектов и элементов управления может отличаться в разных браузерах.

Внимание! 

Для пользователей, которые работают в браузерах IE8, IE9 и IE10, будет подключаться версия 2.1.oldie.1 (даже если в ссылке подключения указана другая версия API). Версия 2.1.oldie.1 функционально соответствует версии 2.1.59 и не содержит более поздних обновлений.

Если необходимо поддерживать браузеры IE8, IE9 и IE10, при написании кода ориентируйтесь на справочник версии 2.1.59 (скачать справочник). Использование функциональности более поздних версий может привести к некорректной работе API в IE8, IE9 и IE10.

Корректная работа API в браузерах, функционирующих в режиме совместимости со старыми версиями (Quirks mode) не гарантируется.

Список версий

Ниже приведен список изменений в JavaScript API Яндекс.Карт от версии к версии. В скобках указана дата выпуска соответствующей версии.

  • JSAPI 2.1.62 — текущая версия (21 марта 2018 г) Скачать справочник Список изменений

    Добавлено:

    • Новая версия модуля Регионы, которая использует данные о границах от Яндекса, возвращает GeoJSON и может использоваться с менеджерами объектов.
    • Опция панели маршрутов 'autofocus' для выключения автофокуса в поле ввода панели маршрутов.

    Изменено:

    • Карта автоматически центрируется на точке маршрута при её заполнении через панель маршрутов.

    Исправлено:

    • ObjectManager работал некорректно при добавлении объектов с разными типами id.
    • Ссылки на Яндекс.Карты иногда включали лишние параметры.
    • Точка маршрута не удалялась с карты при удалении запроса в панели маршрутов.
    • Неправильно отображался курсор рисования маршрута при работе API в режиме CSP.
    • Иногда уровень зума тайлов в плеере панорам выбирался неправильно.
    • Правки вёрстки.
  • JSAPI 2.1.60 (11 января 2018 г) Скачать справочник Список изменений

    Исправлено:

    • Отображение панорам на устройствах под управлением macOS.
    • Оптимизация загрузки API.
  • JSAPI 2.1.59 (14 декабря 2017 г) Скачать справочник Список изменений

    Добавлено:

    • Методы 'open()' и 'close()' балуна мультимаршрута и соответствующие им события.
    • В метод 'openPlayer()' менеджера Панорам можно передать направление взгляда.
    • Маркеры транспортных объектов на подложке стали интерактивными. По клику открывается карточка объекта.
    • При автоматическом исправлении поискового запроса теперь можно повторить поиск по оригинальному запросу.
    • Блок "Открыть в Яндекс.Картах" появился в балунах результатов поиска для провайдера 'yandex#map'.

    Изменено:

    • Отключены ограничения географии поиска и маршрутизации в коммерческой версии.
    • Провайдер поиска 'yandex#search' стал доступен для использования в коммерческой версии.
    • Нитка маршрута стала более заметной при включенном слое панорам.

    Исправлено:

    • В 'objectManager' происходило переполнение стека при 'gridSize' равном 256.
    • Падала ошибка при удалении панели маршрутизации.
    • Происходило лишнее автопозиционирование карты при использовании линейки на карте с менеджером отступов.
    • Опция 'suppressMapOpenBlock' не срабатывала, если плеер панорам открыт кликом на слой панорам подложки.
    • Правки вёрстки.
  • JSAPI 2.1.56 (10 октября 2017 г) Скачать справочник Список изменений

    Добавлено:

    • Новый контрол панели маршрутизации для добавления несворачиваемой панели на карту.
    • Возможность настройки видов транспорта доступных в панели маршрутизации.
    • Метод 'routePanel.geolocate()' для заполнения точек маршрута местоположением пользователя.
    • Пресеты меток с новыми иконками.

    Изменено:

    • Свойство iconCaption теперь можно задать для большинства пресетов меток.

    Исправлено:

    • В событиях marker* плеера панорам возвращалась неправильная сущность в поле marker.
    • Блок "Открыть в Яндекс.Картах" отображался на картах в нестандартных проекциях.
    • При программном заполнении точки в панели маршрута в нём оставался фокус ввода.
    • Не работала опция 'interactiveZIndex' менеджера объектов.
    • Правки верстки.
  • JSAPI 2.1.55 (10 августа 2017 г) Скачать справочник Список изменений

    Исправлено:

    • Не работали метки с макетом pieChart.
    • Ошибки при включении панели маршрутов при активном редакторе маршрута на карте.
  • JSAPI 2.1.54 (08 августа 2017 г) Скачать справочник Список изменений

    Добавлено:

    • Новый элемент управления для построения маршрута с панелью выбора начальной и конечной точек маршрута.
    • Опции для настройки ширины элемента управления SearchControl.
    • Методы 'zoomIn()' и 'zoomOut()' плеера панорам.
    • События 'markermouseenter', 'markermouseleave','markerexpand' и 'markercollapse' маркеров панорамы.
    • Опция 'loadTileSize' менеджеров объектов RemoteObjectManager и LoadingObjectManager для указания размера загружаемых тайлов.
    • Метод 'getPanoramaManager()' для программного доступа к менеджеру панорам.

    Изменено:

    • Геоссылка теперь поддерживает указание географических координат в качестве тела ссылки.

    Исправлено:

    • Плеер панорам работал некорректно в браузерах на базе Chromium при встраивании через iframe.
    • Иногда не загружалась панорама хорошего качества после изменения зума и центра.
    • Промаргивал курсор с точкой «А» при добавлении маршрута на карту.
    • Балун альтернативного маршрута не открывался сразу при клике на нитку маршрута.
    • Курсор рисования маршрута отображался на карте после включения слоя панорам.
    • Не закрывался попап с картой при повторном клике на Геоссылку.
    • Проблемы драга карты при размещении карты в iframe.
    • Иногда после драга карты приходило событие 'click'.
  • JSAPI 2.1.53 (11 июля 2017 г) Скачать справочник Список изменений

    Исправлено:

    • Работа API в webView на устройставх под управлением iOS.
  • JSAPI 2.1.52 (06 июня 2017 г) Скачать справочник Список изменений

    Исправлено:

    • Ошибки в режиме работы с CSP.
  • JSAPI 2.1.51 (23 мая 2017 г) Скачать справочник Список изменений

    Изменено:

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

    Исправлено:

    • При построении маршрутов на общественном транспорте иконка в балуне могла не совпадать с видом транспорта на сегменте маршрута.
    • При масштабировании правой кнопки мыши в режиме просмотра панорам на миникарте не отображалась область выделения.
    • Не работала линейка при включенном слое панорам.
    • Метод 'getObjectInPosition()' слоя активных областей не всегда округлял дробный зум при запросах за тайлами.
    • При поиске по организациям иногда автоматически открывалась карточка объекта, если в видимой области карты находился только один результат.
    • Карта в Геоссылке не учитывала локаль подключения API.
    • При ошибке в Геоссылке выводилось пустое описание.
    • В карточках POI домов не отображался адрес.
    • При масштабировании панорам на iOS иногда происходила ошибка рендеринга.
    • Маркеры POI на подложке могли быть неинтерактивны.
    • При некоторых неверных запросах API отвечал статусом 500 вместо 400.
    • Ошибка метода 'removeAll()' коллекции в случае, когда элементы заданы по индексам.
    • Оптимизация загрузки API.
  • JSAPI 2.1.50 (04 апреля 2017 г) Скачать справочник Список изменений

    Исправлено:

    • Не работали панорамы в последних обновлениях Safari для macOS и iOS.
  • JSAPI 2.1.49 (30 марта 2017 г.) Скачать справочникСписок изменений

    Добавлено:

    • Слой панорам в 'typeSelector' можно отключить после создания элемента управления.
    • Горячие клавиши для управления направлением взгляда в плеере панорам: PageUP - вверх, PageDown - вниз (Для MacOS работают с зажатой клавишей fn).

    Изменено:

    • Имена интерфейсов связей и переходов и связанных методов с сохранением работы старых наименований.
    • При поиске по координатам через 'searchControl' метка результата поиска ставится по координатам из запроса.
    • Для пешеходных сегментов маршрута на общественном транспорте теперь отображается время пути.
    • Отображение маркера панорам на темных подложках.

    Исправлено:

    • При вызове метода 'setBounds()' в некоторых браузерах запрашивались неиспользуемые тайлы карты.
    • Контент балуна геоссылки наследовал стили страницы.
    • Ссылка «Поискать в Яндексе» в 'searchControl' для локали ru_UA вела на неправильный домен.
    • Проблемы с кодировкой в MS IE при переходе в Яндекс.Карты с заголовка карточки топонима.
    • Ошибка в слое активных областей при задании 'keyTemplate' функцией.
    • Метод 'getObjectInPosition()' нового слоя активных областей возвращал 'null' до перехода курсора к следующему тайлу.
    • Объекты слоя активных областей могли дублироваться при последовательных вызовах метода 'getObjectsInPosition()'.
    • Использование API с включенным CSP приводило к ошибкам в браузерах MS IE 8, MS IE 9 и Opera 12.
    • Не всегда правильно применялось направление взгляда при создании плеера панорам.
    • Не учитывалось значение CSS свойства 'padding' при использовании метода 'fitToViewport()' плеера панорам.
    • Оптимизированы сетевые запросы при работе с плеером панорам внутри карты при медленном интернет соединении.
    • Иногда при перетаскивании via-точек маршрута они дублировались.
    • Удаление via-точек маршрута иногда приводило к смещению других точек маршрута.
    • Падала ошибка при подключении API с параметром 'mode=release', если успеть включить пробки сразу после клика в слой панорам.
    • Ошибка отображения сложных полигонов.
    • Правки верстки.
  • JSAPI 2.1.48 (16 февраля 2017 г.) Скачать справочникСписок изменений

    Добавлено:

    • Слой панорам теперь доступен для выбора в переключателе типа карты. Плеер откроется аналогично Яндекс.Картам. При необходимости слой панорам в элементе управления 'typeSelector' можно отключить опцией 'panoramasItemMode'.
    • Модуль 'Geolink' для добавления в тело страницы ссылки на адрес или организацию на Яндекс.Картах со статической картой в превью.
    • Опция 'minPoints' в редакторе геометрий, определяющая минимальное возможное количество вершин геометрии.
    • Опция 'autoFitToViewport' плеера Панорам.

    Изменено:

    • Обновлен стиль элементов управления.
    • На неподдерживаемых платформах в плеере Панорам отображается сообщение для пользователя.

    Исправлено:

    • Иногда маркеры POI были неинтерактивны в Mozilla FireFox и Safari.
    • Промежуточная точка в редакторе геообъекта позиционировалась неправильно при автоперемещении карты.
    • Саджест в 'searchControl' не учитывал видимый центр карты.
    • Не открывался балун маршрута при клике на склеенные метки.
    • Не работали опции редактора ломаной 'vertexLayout' и 'edgeLayout'.
    • Блок "Открыть в Яндекс.Картах" передавал неправильный порядок координат в одном из параметров поиска.
    • Не работало перетаскивание карты на некоторых моделях WinPhone с версией ОС 8 и 8.1.
    • Метки мультимаршрута на общественном транспорте не всегда склеивались после перемещения карты.
    • Не снимался фокус с поля ввода при переходе в плеер Панорам.
    • Не работал переход между снимками в плеере Панорам с помощью клавиш одновременно с изменением угла обзора.
    • При печати страницы с плеером Панорам не печатлся логотип.
    • В некоторых системах не открывались номера домов а плеере Панорам при масштабе страницы больше 100%.
    • Оптимизация и повышение стабильности плеера Панорам.
    • Правки верстки.
  • JSAPI 2.1.47 (7 декабря 2016 г.) Скачать справочникСписок изменений

    Исправлено:

    • Оптимизировано перетаскивание сложных геометрий при редактировании.
  • JSAPI 2.1.46 (1 декабря 2016 г.) Скачать справочникСписок изменений

    Добавлено:

    • Опция 'preventDragUpdate', позволяющая отключить автоматическое перестроение маршрута до окончания перетаскивания путевых точек.
    • Блок "Открыть в Яндекс.Картах" передает метки из коллекций.

    Изменено:

    • Обновлены карточки организаций и топонимов.
    • Блок "Открыть в Яндекс.Картах" учитывает видимую область карты при выборе передаваемых объектов.
    • При редактировании геометрий промежуточная вершина на ребре находится в видимой области карты.
    • Оптимизировали отображение геометрий с самопересечениями.
    • Опция 'yandexMapDisablePoiInteractivity' теперь позволяет включить точки POI в платной версии API.

    Исправлено:

    • Активная область точек POI на границе тайлов.
    • Опция 'routeActiveStrokeStyle' не работала для пешеходных мультимаршрутов.
    • Не срабатывала первая установка 'data.image' у элемента управления listBox.
    • Вызов 'startFraming' на редакторе полигона с пустой геометрией завершался ошибкой.
    • При драге карты одновременно с её программным перемещением мог возникнуть конфликт.
    • При добавлении сложного полигона на карту возникали ошибки.
    • Карта могла быть спозиционирована неправильно при открытии балуна во время зума.
    • Иногда возникали проблемы с драгом в бразуерах Edge, MSIE 10, MSIE 11.
    • Появлялась ошибка при удалении карты во время редактирования геометрии.
    • Правки редактирования и отображения геометрий.
    • Правки верстки.
  • JSAPI 2.1.45 (11 октября 2016 г.) Скачать справочникСписок изменений

    Добавлено:

    • Метод 'panorama.Base.getMarkerPositionFromDirection' для вычисления координат маркера по направлению на него.

    Исправлено:

    • Не срабатывал метод 'map.zoomRange.getCurrent()' и не отправлялось событие 'zoomrangechange' при использовании менеджера отступов;
    • В некоторых браузерах элемент управления масштабом Панорамы не выключался на граничных масштабах;
    • Проблемы печати Панорам в Mozilla FF;
    • Не срабатывало событие 'destroy' при нажатии клавиши 'Esc' в плеере Панорам;
    • Не открывались условия использования при попытке перехода из плеера Панорам на touch-устройствах;
    • Проблемы управления с клавиатуры в плеере Панорам.
  • JSAPI 2.1.44 (28 сентября 2016 г.) Скачать справочникСписок изменений

    Добавлено:

    • Маркеры объектов на подложке карты стали интерактивными, по клику открывается карточка объекта;
    • В стандартном балуне маршрута появился умный блок "Открыть в Яндекс.Картах";
    • Макет 'layout#pieChart' для отображения меток в виде круговых диаграмм на базе собственных данных;
    • Управление с клавиатуры в плеере Панорам, включается опцией 'hotkeysEnabled';
    • Опция 'scrollZoomBehavior' для отключения масштабирования колесом мыши в плеере панорам;
    • Опция 'useAutoPanInDrawing' для отключения автоматического движения карты в режиме рисования геообъекта;
    • Опция карты 'rulerBalloonAutoPan' для отключения автоматического центрирования карты на линейке;
    • Опция карты 'yandexMapDisablePoiInteractivity' для отключения интерактивности маркеров на подложке;

    Исправлено:

    • Карта иногда не загружалась при наличии на странице также карты Конструктора или двух карт с разными значениями 'onload';
    • Проблемы инерции при перетаскивании и масштабировании карты;
    • ObjectManager не отображал пользовательские метки в Safari Mobile до взаимодействия с картой;
    • Событие 'actionend' не срабатывало в плеере Панорам;
    • Проблемы печати визуальных элементов карты в MS IE, Edge, Firefox;
    • Изображение панорамы искажалось при слишком большой ширине плеера;
    • Метка с id=0 в ObjectManager пропадала после закрытия её балуна;
    • Иногда объекты в плеере Панорам теряли интерактивность;
    • Правки в редакторе геометрий;
    • Правки стабильности плеера Панорам;
  • JSAPI 2.1.42 (12 июля 2016 г.) Скачать справочникСписок изменений

    Добавлено:

    • Поддержка панорам в Платном API.
    • Метод карты 'copyrights.getPromoLink()' для получения ссылки из блока "Открыть в Яндекс.Картах".

    Исправлено:

    • Утечки памяти при удалении карты.
    • В некоторых ситуациях не срабатывала геолокация при использовании обратного геокодирования.
    • Иногда неправильно выставлялись координаты рисуемой вершины в редакторе геометрий при одновременном прокручивании карты.
    • Метки дорожных событий теряли интерактивность в некоторых ситуациях.
    • Проблема инерции при драге карты в Mozilla Firefox на некоторых конфигурациях MacOS.
    • Центр карты выставлялся неправильно при выполнении fitToViewport во время анимации зума.
    • Пресеты с пиктограммами выглядели нечеткими в Opera12.
    • Проблемы при печати карт.
  • JSAPI 2.1.41 (7 июня 2016 г.) Скачать справочникСписок изменений

    Изменено:

    • Продолжительность кинетического драга.

    Исправлено:

    • Зависимости сторонних модулей не разрешались через fallback.
    • Не подгружалось сообщение об ошибке в searchControl при отсутствии результатов поиска.
  • JSAPI 2.1.40 (26 мая, 2016 г.) Скачать справочникСписок изменений

    Добавлено:

    • Пешеходная маршрутизация.
    • Новые пресеты меток с иконками.
    • Контекстные подсказки при поиске по организациям.
    • Поддержка опции 'autoPan' для балуна в режиме панели.

    Изменено:

    • Логика пользовательского взаимодействия с 'searchControl'.

    Исправлено:

    • В некоторых случаях не срабатывало событие 'resultHide'.
    • При вызове метода 'destroy()' карты падала ошибка в 'suggest' у 'searchControl'.
    • Не появлялось сообщение "Идёт запрос к серверу" в 'searchControl'.
    • Не отображалось время работы организации в поиске, если API подключен с параметром coordorder=longlat.
    • Ошибки при использовании карты Конструктора в Angular приложении.
    • Ошибка при задании состояния линейки без карты.
    • Не отображался блок "открыть в Яндекс.Картах" в Mozilla Firefox при загрузке карты в скрытом контейнере.
    • Оптимизированы поисковые запросы.
    • Оптимизированы макеты и css.
    • Проблемы производительности тайлов в Mozilla Firefox.
  • JSAPI 2.1.39 (14 апреля 2016 г.) Скачать справочникСписок изменений

    Исправлено:

    • Событие 'boundschange' приходило дважды при драге с инерцией.
    • Некорректно отображалась метка при смене пресета во время работы с картой.
    • Утечка памяти в option.Manager.
  • JSAPI 2.1.38 (31 марта 2016 г.) Скачать справочникСписок изменений

    Добавлено:

    • API Панорам, предоставляющий возможность встроить на свой сайт панораму Яндекса или снятую собственноручно (запущен в beta режиме).
    • Смещение карты при приближении к ее границам в режиме рисования новых вершин в редакторе геометрий.

    Исправлено:

    • Проблема с активными областями меток кластеров в Firefox и Safari.
    • Некорректная работа карты при вызове метода `map.destroy()` во время редактирования фигуры.
    • SearchControl заменял введенные кавычки на &quot;
    • Некорректная работа редактора геометрий при использовании глобального CSS-правила 'text-align: center'.
    • Некорректная работа опции useMapMargin у route.
    • Завершалось рисование геометрии при удалении даблкликом точки линейки.
    • Переход через блок "Открыть в Яндекс.Картах" с результатом поиска по своим объектам.
    • Артефакты анимации тайлов в Firefox на дисплеях высокой четкости.
  • JSAPI 2.1.35 (18 февраля 2016 г.) Скачать справочникСписок изменений

    Добавлено:

    • Блок "Открыть в Яндекс.Картах" теперь передает расположение меток, маршруты, результаты поиска и другие параметры карты.
    • MarginManager для настройки отступов карты.
    • Корректор координат в редакторе точечной геометрии.
    • Возможность обращаться к полям дочерних объектов кластера из макета хинта.
    • Возможность передавать в метод 'requireCenterAndZoom' объекта 'map.ZoomRange' менеджер коэффициентов масштабирования конкретной карты.
    • Простые методы доступа к xAL результатов геокодирования.

    Изменено:

    • Логика переходов из блока "Открыть в Яндекс.Картах" на мобильных устройствах.
    • Блок "Открыть в Яндекс.Картах" теперь скрывается при печати.
    • Новый алгоритм активных областей: PR-tree.

    Исправлено:

    • KML парсер теперь правильно обрабатывает параметры ширины и высоты в опции 'iconImageSize'.
    • Отображение тайлов прогноза пробок на дисплеях Retina.
    • Улучшена производительность за счет оптимизации кэширования.
    • Загрузка внутренних скриптов API всегда происходит по HTTPS.
    • Удалена глобальная переменная 'res'.
    • При повороте фигуры одновременно со скроллом в редакторе поворота она больше не скрывается.
    • При редактировании промежуточной точки в редакторе оставалась предыдущая линия рисования.
    • При сильном уменьшении объекта в режиме редактирования он иногда отрисовывался вне рамки.
    • В режиме 'canvas' заливка 'stretch' неправильно работала для многоконтурных полигонов.
    • Некорректное отображение полигонов с внутренним контуром при расположении вблизи 180-го меридиана.
    • Исправлено поведение метода 'geocode' в случае серверной ошибки.
    • Динамическое изменение отображения меток в IE 11.
    • Верстка при указании глобального CSS-правила 'text-align: center'.
    • Верстка карточки организации в турецкой локали.
    • Проблемы с отображением карты во время масштабирования в MacOS X 10.11 в Safari.
    • Порядок добавления и отображения транзитных точек в мультимаршрутизаторе.
    • Позиционирование кластеров в менеджере объектов по оси Z.
    • Падала ошибка при двукратном вызове 'map.destroy()' при наличии линейки на карте.
    • Правки верстки в старых версиях браузеров.
  • JSAPI 2.1.34 (7 декабря 2015 г.) Скачать справочникСписок изменений

    Исправлено:

    • Некорректная работа с RequireJS подобными системами.
  • JSAPI 2.1.32 (25 ноября 2015 г.) Скачать справочникСписок изменений

    Добавлено:

    • Новый дизайн и оптимизация редактора геометрий.
    • Блок "Открыть в Яндекс.Картах" теперь поддерживает карты, созданные в Конструкторе.
    • Печать стандартных меток в Mozilla Firefox.
    • Объекты в ObjectManager поддерживают опцию zIndex.
    • Улучшена карточка организации в поиске по организациям.
    • Возможность перейти к поиску Яндекса, если SearchControl не вернул результатов (регулируется опцией suppressYandexSearch).
    • В меню редактора геообъектов появилась возможность передавать html разметку.
    • Появился метод clear() в SearchControl.
    • Оптимизирована работа фильтров в ObjectManager.
    • Оптимизирована анимация на мобильных устройствах.
    • Опцию suppressMapOpenBlock можно менять в runtime.

    Исправлено:

    • При подключении нескольких версий API с разными локалями дублировались метки.
    • Методы getOverlay() балунов и хинтов геообъектов теперь всегда возвращают promise (возможно, отклоненный, если оверлея нет).
    • Не приходило событие drawingstart при выборе пункта "Продолжить" в редакторе графики.
    • Могла возникать ошибка при переключении режима мультимаршрута с автомобильного на общественный транспорт.
    • Проблемы с двойным тапом по меткам в Android.
    • На маке при скролле тачпадом иногда происходил прыжок в обратном направлении.
    • Внутренние контуры полигонов больше не теряются при переходе между мирами.
    • После поворота полигона с внутренним контуром иногда создавалась лишняя точка.
    • Блокировалось перетаскивание карты при последовательном нажатии левой и правой кнопки мыши в MSIE10 и MSIE11 на WIN8-10.
    • Артефакты анимации в Mozilla Firefox.
    • SearchControl некорректно работал с опцией popupItemLayout.
    • Проблемы с отображением площадных объектов в MSIE.
    • В режиме редактирования было можно оторвать контекстное меню от вершины полигона.
    • Не передавались опции балуна в методе setObjectOptions() объекта objects в классе ObjectManager.
    • При поиске по организациям searchControl показывал первый результат на другом конце света, если указан &coordorder=longlat.
    • Для оверлея хинта и панели метод getShape() иногда возвращал null.
    • Использование опции clusterIconContentLayout: null.
    • Проблемы с отображением кругов, пересекающих 180 меридиан.
    • Блок "Открыть в Яндекс.Картах" теперь показывается только в географической координатной системе.
    • Приходил некорректный bounds для маршрутов, состоящих из нескольких одинаковых точек.
    • Мелкие ошибки верстки.
  • JSAPI 2.1.31 (5 ноября 2015 г.) Скачать справочникСписок изменений

    Исправлено:

    • Проблема с перетаскиванием точек маршрута в Microsoft Edge.
    • Проблема с жестом скролла в Chrome на MacOS.
  • JSAPI 2.1.29 (3 августа 2015 г.) Скачать справочникСписок изменений

    Добавлено:

    • Поддержка новых браузеров: Microsoft Edge и Firefox для Android.

    Исправлено:

    • Сдвиг координат опорных точек при построении мультимаршрутов с включенным обратным геокодированием.
    • Проблемы с событием «click» на некоторых Android-устройствах.
  • JSAPI 2.1.27 (18 июня 2015 г.) Скачать справочникСписок изменений

    Добавлено:

    • Ссылка «Открыть в Яндекс.Картах» в нижней части карты.
    • Ссылка «Обновите браузер» для устаревших версий браузера.
    • Класс 'Template'.

    Изменено:

    • Оптимизация RemoteObjectManager: отображение точек только в видимой области.

    Исправлено:

    • Геокодирование точек маршрутов в enterprise-версии.
    • Периодическая ошибка при построении маршрута из трех точек.
    • Оптимизирована скорость масштабирования карты на устройствах с iOS.
    • Проблемы с touch-событиями при добавлении на карту некоторых площадных геообъектов.
    • YMapsML: не устанавливался тип карты, если в MapState был bounds.
    • Неправильные размеры иконок 'masstransit' в мультимаршрутизаторе.
    • Неверное значение поля 'address' в мультимаршрутизаторе.
    • Не удалялся результат запроса в поисковом контроле после смены провайдера.
    • Кастомный провайдер для саджеста не отображал значения.
    • 'util.hd.selectValue()' не возвращал значения для дробных DPR.
    • Кластеры в RemoteObjectManager пропадали при смене зума.
    • Смещение меток при изменении масштаба страницы.
    • Некорректно работал 'editor.startDrawing()' в обработчике события geometrychange у полигона.
    • При перетаскивании маршрута не учитывался параметр searchCoordOrde`.
    • Вылетала карта в IE8, если ее инициализировать в скрытом контейнере.
    • Проблемы с отображением графики при масштабировании в IE 8-9 и Opera 12.
  • JSAPI 2.1.26 (27 мая 2015 г.) Скачать справочникСписок изменений

    Добавлено:

    • Автоперемещение карты при приближении к границе во время рисования и редактирования объектов.
    • Печать карты в Firefox.
    • Модуль 'util.hd' для работы с экранами с высоким разрешением.
    • Модуль 'util.bounds' для работы с границами и их пересечениями.
    • Модуль 'event.Mapper' для управления распространением событий.
    • Модуль 'ymaps.meta', содержащий параметры API и данные окружения.
    • Модуль 'util.requireCenterAndZoom' для расчёта оптимального центра и масштаба для отображения карты с заданными границами.
    • Поддержка поля 'AddressDetails' в поиске по организациям.

    Изменено:

    • Расширен интерфейс метода 'ready', позволяющий теперь загрузить дополнительные модули.
    • Оптимизирована плавность и отзывчивость действий карты.
    • Оптимизирована начальная загрузка необходимых модулей.
    • Оптимизировано масштабирование карты на мобильных устройствах.
    • Оптимизирована работа поведения карты 'dblClickZoom'.
    • Плавная прокрутка элементов с 'overflow: auto' в iOS.
    • Геокодирование точек маршрута теперь происходит на клиенте.

    Исправлено:

    • Удалены глобальные CSS-правила 'box-sizing', которые могли влиять на пользовательские элементы.
    • Исправлена работа метода 'getClosest' в геометриях.
    • Верстка тянущейся иконки с кратким содержимым.
    • В геообъектах объект-promise метода 'open' хинта/балуна не возвращал значение, если вызывать открытие и закрытие до загрузки модулей.
    • Отображение хинта при наведении мыши не под курсором, а в центре у некоторых объектов.
    • Исчезала прокрутка в панели при изменении высоты балуна.
    • Ошибка при появлении дырок/разряжений в коллекции геообъектов.
    • Неверный курсор метки с опцией 'interactive: false'.
    • Не работало задание 'dataURI' / 'Image' / 'Canvas' в опцию 'fillImageHref' геообъектов.
    • Неправильная заливка во время зума для полигонов с самопересечениями.
    • Закрытие балуна кластера по событию 'change' состояния или изменению поля 'activeObject' приводило к ошибке.
    • При включении редактирования геометрий события 'editorstatechange' и 'statechange' кидались по два раза.
    • Вершина редактора графики спрыгивает в первоначальное место, если во время ее переноса сдвинуть карту.
    • Проблемы при повороте полигона с внутренним контуром.
    • Скролл во время перемещения вершины редактора приводил к ошибке.
    • Проблемы с отображением копирайтов на маленьких картах.
    • Порядок сортировки элементов раскрывающегося списка.
    • Ошибка в IE 10-11, вызывавшая изменение размеров раскрывающегося списка.
    • Ошибки в верстке раскрывающегося списка.
    • Изменение опции 'maxWidth' визуально не изменяло кнопку.
    • Мигала панель поиска и пробок при переключении табов.
    • Отсутствие копирайтов на планшетах.
    • Ошибка скрытия панели с результатами поиска при задании опции 'visible: false'.
    • Проблемы с выпадающим списком "Поиска по карте" при переходе в полноэкранный режим.
    • Ошибки в верстке и отображении элемента управления "Поиск по карте".
    • При ошибке поиска вместо надписи "Сервер не смог обработать запрос" отображалась надпись "Идет запрос к серверу...".
    • Не работало автомасштабирование к выбранному результату поиска по карте.
    • Проблемы с удалением средней точки маршрута.
    • Ошибка при попытке изменить координаты перед добавлением точки на карту в маршрутизаторе.
    • Некоторые неточечные объекты не отображались на карте в менеджере объектов и 'LoadingObjectManager'.
    • В менеджере объектов не возвращался объект-promise из метода 'open' хинта.
    • 'map.geoObjects.getBounds' возвращал 'null' при добавленном менеджере объектов на карту.
    • Ошибки в менеджере объектов при изменении дробного масштаба карты.
    • Некорректный результат метода 'getBounds' после удаления объектов из менеджера.
    • Cтрока "id" заменялась на 'object.id' в методе 'setFilter' менеджера объектов.
    • Исправлен порядок событий мыши в макетах и оверлеях.
    • Плавная смена масштаба в тайлах.
    • Проблемы при перемещении карты Internet Explorer 10.
    • Ошибки рендеринга меток на больших масштабах в Chrome.
    • Проблемы с жестами в Windows Phone.
    • Проблемы с версткой и пробрасыванием событий различными компонентами в старых версиях IE.
  • JSAPI 2.1.23 (17 марта 2015 г.) Скачать справочникСписок изменений

    Добавлено:

    • В ObjectManager добавлена поддержка неточечных геообъектов.
    • В RemoteObjectManager и LoadingObjectManager появилась возможность определить имя callback-функции для JSONP-запроса.
    • В RemoteObjectManager появились методы setFilter(), getFilter() и getObjectState().
    • Опция noPlacemark в элементе управления "Геолокация".
    • Отображение ближайшей станции метро для топонимов в результатах поиска по организациям.

    Исправлено:

    • Невозможность перемещать геообъекты в режиме рисования.
    • Проблемы с интерактивностью и исчезновением геообъектов при перемещении между пейнами.
    • Некорректная работа хинта кластеров.
    • Ошибка при двойном клике по кластеру.
    • Некорректная работа опции icons в кластеризаторе.
    • Исчезновение иконки кластера при наведении курсора в некоторых случаях.
    • Значение 'boundsPath' для опции coordRendering у прямоугольника.
    • Ошибка с перемещением открытого балуна в ObjectManager.
    • Ускорено удаление геообъектов в ObjectManager.
    • Ошибки с работой балунов в ObjectManager.
    • Исправлена фильтрация кластеризованных объектов в ObjectManager.
    • Работа метода ObjectManager.getBounds() при кластеризации.
    • При использовании порядка координат 'longlat' балун ObjectManager открывался не в том месте.
    • Задание опции mapStateAutoApply для режима мультимаршрутизации при использовании ymaps.route.
    • Метод showResult() элемента управления "Поиск по карте" не выполнялся при включенных опциях noPlacemark и noCentering.
    • Отображение больших балунов организаций в режиме панели.
    • Ошибка с повторным запросом данных после неверного результата в поиске по организациям.
    • Ошибка в поиске по организациям, в результате которой иногда координаты могли возвратиться в неправильной последовательности.
    • Проблемы с одновременными действиями на карте, например, Balloon.autoPan() и Map.panTo().
    • Некорректная работа слоя активных областей после его обновления.
    • Ошибки при изменении опции hasBalloon у активных областей.
    • Ряд ошибок и неточностей в верстке элементов карты.
  • JSAPI 2.1.22 (26 февраля 2015 г.) Скачать справочникСписок изменений

    Исправлено:

    • Не показывались SVG-метки в Firefox при задании тэга <base>.
    • Не открывался балун загруженных через geoxml меток при указанном balloonTemplate.
    • Неправильно работал метод getResult в SearchControl при заданных опциях noPlacemark и noCentering.
  • JSAPI 2.1.20 (5 февраля 2015 г.) Скачать справочникСписок изменений

    Исправлено:

    • Мигание подгружающихся тайлов при перетаскивании карты.
    • Исчезновение объектов при перетаскивании через 180-ый меридиан.
    • Проблемы с прозрачностью в площадных геообъектах.
    • Отображение нулевой обводки геообъектов.
    • При смене опции 'offset' у оверлеев не менялся результат вызова метода getShape().
    • Проблемы с 'autoPan' в балунах.
    • После автоматического позиционирования балуна открывался балун объекта, оказавшегося под курсором.
    • Ошибка отображения хинта геообъекта после закрытия балуна-панели.
    • Неправильная работа событий 'mouseleave' в активных областях при перетаскивании карты.
    • Поиск по организациям: исчезновение карточки организации сразу после открытия.
    • Артефакты при удалении с карты элемента управления "Поиск по карте".
    • Проблемы с отображением результатов элемента управления "Поиск по карте" на Народной карте.
    • Ошибка при редактировании транзитных точек в маршрутизаторе.
    • Проблемы с версткой точек и сегментов маршрутов в IE9 и Android Browser.
    • Ошибка в редакторе с возобновлением рисования после удаления существующих точек.
    • В редакторе не отображались направляющие линии в режиме рисования полигона/полилинии.
    • Удалялись конечные точки линейки при попытке поставить точку двойным кликом.
    • Исправлен ключ макета 'islands#multiRouterBigSmallPoint' на 'islands#multiRouterSmallWayPoint'.
    • Отсутствие события 'mousemove' в IE на touch-устройствах.
  • JSAPI 2.1.17 (30 октября 2014 г.) Скачать справочникСписок изменений Добавлено:
    • Возможность добавлять пользовательские фильтры в шаблонах макетов.
    • Класс Template для работы с шаблонами HTML.

    Изменено:

    • RemoteObjectManager отображает объекты только в видимой области карты.

    Исправлено:

    • RemoteObjectManager не перерисовывал одинаковые объекты при смене коэффициента масштабирования.
    • Ошибка, из-за которой поле viaPointsChange события multiRouter.MultiRouteModel.requestsuccess могло принимать неверное значение.
    • Позиционирование меток при изменении масштаба страницы в Chromium-браузерах.
    • После выбора слоя в выпадающем списке слоев список не сворачивался.
    • В некоторых случаях возникали ошибки при вводе текста в элемент управления «Поиск по карте» при использовании мыши и клавиатуры одновременно.
    • Ошибки в работе редактора геообъектов.
    • Некорректная работа editor.startDrawing в обработчике события geometrychange у полигона.
    • Ошибки в отображении элемента управления «Пробки» при показе карты из скрытого контейнера.
    • В некоторых случаях в панели «Пробки» показывалось некорректное время.
    • В некоторых случаях возникали ошибки, если открыть балун на метке и затем изменить масштаб так, чтобы метка попала в кластер.
    • При драге маршрута не учитывался параметр searchCoordOrder.
    • В некоторых версиях IE не срабатывала анимация при смене тайлов.
    • Ошибки при изменении границ элементов во вложенных коллекциях.
    • Ошибки при удалении и повторном добавлении ObjectManager на карту.
    • Устранены утечки памяти.
    • Ошибки при попадании хотспотных объектов с одинаковым id в несколько соседних тайлов.
  • JSAPI 2.1.16 (17 сентября 2014 г.) Скачать справочникСписок изменений Добавлено:
    • Опция activeRouteAutoSelection мультимаршрутизатора.
    • Событие update мультимаршрутизатора.
    • Поисковые подсказки в платной версии API.

    Исправлено:

    • Некорректная работа балуна кластера при задании html в clusterCaption.
    • Ошибки при работе с балуном точки редактора геообъекта в IE8.
    • Ошибки при фильтрации объектов в ObjectManager.
    • Метод ObjectManager.getObjectState возвращал некорректные значения для объектов вне области видимости.
    • В IE9, IE10 в некоторых случаях некорректно обрабатывалась смена zIndex маршрута.
    • Метод autoPan возвращал некорректное значение для балуна в режиме панели.
    • В некоторых случаях возникала ошибка при изменении значения опции yandexMapAutoSwitch.
    • Узловые точки редактора геообъектов съезжали относительно объекта в iOS7.
    • В некоторых случаях не срабатывала опция fillOpacity геообъекта.
    • В некоторых случаях не срабатывало изменение опции fill геообъекта.
    • Отсутствовал текст сообщения об ошибки в поисковом контроле в англоязычной версии.
    • Проблемы со скроллом дефолтного балуна кластера при задании произвольного макета itemContentLayout.
    • LoadingObjectManager и RemoteObjectManager отправляли некорректные запросы при переходе карты через нулевой меридиан.
    • В некоторых случаях не срабатывали опции единичных объектов в ObjectManager.
    • Ошибки при изменении опции hasHint кластеризатора.
    • В некоторых случаях хинт кластера не закрывался при уходе курсора с метки.
    • Ошибки в работе менеджера хинта ObjectManager.
    • В некоторых случаях некорректно отображалась метка кластера при переходе балуна в режим панели.
    • В некоторых случаях не закрывался балун метки при попадании метки в кластер в ObjectManager.
    • При повторном вызове метода GeoQueryResult.addToMap объекты удалялись и добавлялись на карту заново.
  • JSAPI 2.1.15 (28 августа 2014 г.) Скачать справочникСписок изменений Добавлено:
    • LoadingObjectManager — модуль, который позволяет добавлять на карту очень большое (действительно очень больше) число меток. При необходимости кластеризует их. Загружает с сервера данные только для тех меток, которые попадают в видимую область карты.
    • RemoteObjectManager — модуль, предназначенный для показа большого числа меток с использованием загрузки данных с сервера по тайлам или по области видимости карты. Использует серверную кластеризацию данных.

    Исправлено:

    • Дублирование текста при вводе с включенными поисковыми подсказками в Android-браузерах.
  • JSAPI 2.1.14 (7 августа 2014 г.) Скачать справочникСписок изменений Добавлено:
    • Новые возможности шаблонизатора - elseif и квадратные скобки.
    • Возможность отменять предыдущие запросы при задании новых опорных точек и параметров в мультимаршрутизаторе.
    • Панель поисковых подсказок.
    • Параметр onerror при подключении API.
    • Возможность отключить выход из полноэкранного режима по нажатию клавиши Esc.
    • Добавлен метод GeoQueryResult.getParent.
    • Метод then объекта GeoQueryResult теперь поддерживает контекст исполнения функций обратного вызова.
    • Ускорена отрисовка графики с фоновым изображением.
    • Возможность указывать фигуру метки кластера в json-формате.

    Исправлено:

    • Ошибки графики в IE.
    • Ошибки мультимаршрутзатора.
    • Ошибка подключения двух разных версий API на одной странице.
    • В некоторых случаях возникала ошибка при клике по слою пробок в IE8.
    • В некоторых случаях возникала ошибка при удалении элемента управления «Пробки» с карты.
    • Ошибки отображения полигона с внутренним контуром.
    • Ошибки отображения графики с выставленной опцией opacity равной 0 в IE9-11.
    • Ошибочное отображение scrollbar в результатах поиска.
    • В некоторых случаях карта становилась неактивной в мобильной версии Chrome под Android.
    • Проблемы с драгом на WindowsPhone.
    • Ошибка с прокидыванием событий из-под макета ItemContent в балуне кластера.
    • Ошибки верстки элементов управления в IE8.
    • Ошибка повторного добавления элемента в ObjectManager.
    • Ошибка отображения балуна при инициализации из скрытого контейнера.
    • Ошибка вызова метода autoPan в менеджерах балуна.
    • Ошибка драга объектов под слоем событий.
    • Балун в режиме панели не сдвигал элемент управления «Линейка».
    • Ошибки перехода в полноэкранный режим при нахождении карты в контейнере с динамической шириной.
    • Ошибка скрытия подсказки в некоторых случаях.
  • JSAPI 2.1.11 (26 июня 2014 г.) Скачать справочникСписок изменений Добавлено:
    • Общественный транспорт в мультимаршрутизаторе.
    • Модуль ObjectManager для отображения большого количества меток на карте.
    Изменено:
    • Обновлен модуль Регионы.
    • map.geoObjects.getBounds теперь учитывает объекты в составе кластеризатора.

    Исправлено:

    • Ошибки при инициализации карты в iframe.
    • Перепутанный порядок событий click, select и press для FullscreenControl.
    • Элемент управления zoomControl не учитывал отступ снизу при расчете своих размеров.
    • Контейнер с подложкой смещался относительно контейнера событий в Android 4.x.
    • В некоторых случаях браузер неожиданно завершал работу на устройствах iOS с Retina-экранами.
    • Неправильное отображение карты в элементе с position: fixed в webkit.
    • Не срабатывала опция strictBounds в control.SearchControl.
    • Ошибки анимации control.ListBox в iOS 6.
    • Срабатывание enter на элементе управления «Поиск на карте» осуществляла submit родительской формы.
    • Некорректное отображение время в панели пробок при смене часового пояса.
    • Ошибка при использовании API с библиотекой sugar.js в IE8.
  • JSAPI 2.1.9 (24 апреля 2014 г.) Скачать справочникСписок изменений Добавлено:
    • Опция shape в templateLayoutFactory.
    • Документирована модульная система API 2.1.
    • Возможность указывать пустой неймспейс (параметр загрузки ns) с получением функциональности API в качестве аргумента вызова функции onload.
    • Документированы стандартные реализации интерфейса IPane.
    Изменено:
    • Метка кластера при наведении курсором мыши увеличивает z-index.
    • Promise, возвращаемый функцией ymaps.ready, подтверждается неймспейсом ymaps.

    Исправлено:

    • Работа методов removeMapType и removeAllMapTypes в элементе управления «Слои».
    • Ошибка выставления состояния скролла в балуне кластера по умолчанию.
    • Артефакты в верстке балуна-аккордеона кластера в AndroidBrowser.
    • Ошибка при разборе запроса geoQuery.search.
    • «Дрожание» меток в iOS 6.
    • Проблемы с активацией элементов управления «Слои» и «Пробки» на планшетах под управлением OS Android.
    • Мерцание элемента управления «Пробки» в тач-интерфейсе.
    • Ошибки верстки элемента управления «Пробки».
    • Ошибки верстки в IE.
    • Ошибка при выключении редактора графики.
    • В некоторых ситуациях не изменялась высота балуна-панели при изменении высоты карты.
    • Методы getElement и getBalloonElement возвращали некорректные значения в режиме панели.
    • В некоторых ситуациях в балуне кластера отсутствовал горизонтальной скролл.
    • Балун-панель мог перекрывать метку на которой был открыт.
    • В некоторых ситуациях не скрывался хинт пробок в браузере FireFox.
    • Проблемы с производительностью на iPad при включенном слое пробок.
    • В некоторых ситуациях сбрасывался пресет маркера после закрытия балуна.
  • JSAPI 2.1.7 (10 апреля 2014 г.) Скачать справочникСписок изменений Добавлено:
    • Маршрутизатор с альтернативными маршрутами.
    • Опция zoomMargin в SearchControl.
    • Метод setAll в менеджере данных data.Manager.
    Изменено:
    • Обновление дизайна балунов кластеров.
    • Стандартные метки кластера переведены на SVG.
    • Изменен дизайн балунов дорожных событий.
    • При задании опции position элементов управления значение опции float трактуется как none.

    Исправлено:

    • Небольшие интерфейсные ошибки.
    • Мигание элементов управления при отображении карт на мобильных устройствах.
    • Инициализация SearchControl из скрытого контейнера.
    • Применение опции drawingCursor.
    • В некоторых случаях не скрывалась подсказка геообъекта.
    • В некоторых случаях pixelgeometrychange происходило в неправильное время.
    • Небольшие ошибки в новом шаблонизаторе.
    • Не выбирался первый найденный элемент в элементе управления «Поиск на карте».
    • Некорректно отрисовывалась белая подложка линии линейки на больших расстояниях.
    • Режим редактирования полигонов и полилиний не отключался по двойному клику.
    • Маршрут продолжал редактироваться после деактивации соответствующего элемента управления.
    • Не вовремя генерировалось событие vertexdragend.
    • Не происходил клик в выпадающих списках в бразуерах операционной системы Android.
    • Ошибки при анимации элемента управления «Пробки».
    • Ошибки в верстке масштабного отрезка.
    • В менеджере элементов управления нельзя было подписаться на события дочерних элементов.
    • Неправильный индекс добавленной вершины в событии vertexadd редактора полигона.
    • При изменении позиции zoomcontrol принимал неверный размер.
    • Ошибки в верстке элемента управления «Поиск по карте» в Internet Explorer версий 8 и 9.
    • При вызове метода search у элемента управления «Поиск на карте» в состояниях small и medium по умолчанию не показывался выпадающий список с результатами поиска.
    • Линия на карте моргала, если при наведении увеличивать strokeWidth.
    • Откорректировано поведение .behavior.MultiTouch.
    • После удаления всех точек из полигона отключался режим рисования.
    • Открывался пустой балун по клику по линии маршрута.
    • Неправильное значение поля position в DOM-событиях в Internet Explorer.
    • Точки маршрута не ставились поверх геообъектов.
    • В некоторых случаях некорректно рассчитывались размеры содержимого балуна.
    • Опции отображения геообъекта неверно обрабатывались на устройствах с высокой плотностью пикселей.
    • Не изменялась активная область метки при изменении стиля метки.
    • Не помещалась информация об объекте в балуне-панели.
    • В некоторых случаях нажатие на объект на карте вызывало смещение карты.
    • Происходила ошибка, если открыть балун кластера в момент, когда на карте уже открыт другой балун.
    • Не работала опция tremor в behavior.Drag.
    • В Internet Explorer пропадала метка после закрытия балуна.
    • При переключении balloonPanelMaxMapArea некоторые опции не срабатывают корректно.
    • Не срабатывала геолокация пользователя по IP.
    • Тянущиеся метки не растягивались, если в содержимом метки был пробел.
    • Не появлялось контекстное меню по правому клику в балунах.
    • Ошибки при добавлении типов карт в TypeSelector.
    • Падение приложения на iPad с Retina-экраном.
    • Ошибка уничтожения карты сразу после создания.
    • Ошибки в модуле geoXML.
    • Смещение панели балуна и копирайтов при выделении текста.
  • JSAPI 2.1.5 (11 февраля 2014 г.) Скачать справочникСписок изменений Добавлено:
    • Методы ymaps.ready и ymaps.load возвращают объект класса vow.Promise.
    • Позиция выпадающего списка зависит от положения кнопки вызова списка на карте.
    • Поддержка вложенных неймспейсов для параметра «ns» загрузчика API.
    • Методы класса util.AsyncStorage возвращают объект класса vow.Promise.
    • Обновлена реализация vow.Promise для соответствия со стандартом http://dom.spec.whatwg.org/#promises.
    • Текстовые шаблоны переведены на новый синтаксис. Добавлена поддержка цикла for, обработка вложенных условий и циклов. Подробное описание читайте в документации.
    Изменено:
    • Ускорено построение макета балуна кластера.

    Исправлено:

    • Скроллинг длинных списков в Safari iOS7.
    • Ошибки верстки панели управления «Пробки» в Opera.
    • Конфликты верстки при подключении библиотеки bootstrap.
    • Конфликты показа результатов поиска и клавиатуры на мобильных устройствах для элемента управления «Поиск по карте».
    • Ошибки верстки выпадающего списка в Opera.
    • Поведение балунов и подсказок меток в IE8.
    • Ошибки при динамическом изменении опций hasHint и hasBalloon кластеризатора.
    • Лишнее срабатывание анимации в элементе управления «Поиск по карте».
    • Ошибки при удалении элемента управления «Поиск по карте».
    • Отсутствует кнопка удаления поискового запроса в IE8.
    • Ошибки верстки панели управления «Пробки».
    • Убрали эмулирование события contextmenu в браузерах на WinPhone, которые его не поддерживают.
    • В некоторых случаях зависал мобильных браузер при смене масштаба карты при включенных пробках.
    • Зацикливание кода при вложенной подписке на обработчик ymaps.ready.
    • Конфликты при подключении двух версий на одной странице.
    • Метод getZoomRange не попадал в package.full.
    • Утечки памяти при обработке событий.
    • Дублировалось событие balloonopen и balloonclose кластеризатора.
    • Ошибки в режиме release при удалении кластеризатора с карты.
    • Сбрасывались пресеты меток при повторном закрытии балуна.
    • Дублирование событий mouseenter в IE8 и IE9.
    • Не приходило событие click на кластере, если на нем при этом открывался балун.
    • Отправка поискового запроса по клавише Enter в IE8.
    • Не работало масштабирование карты двойным щелчком кнопки мыши при клике на геообъекты без балуна.
    • Кластеризатор не генерировал события optionschange.
    • Не работала опция pane для точечных геообъектов.
    • При редактировании линии и полигона балун смещался.
    • Лишние событие close и balloonclose геообъекта и его балуна.
    • Лишние события autopanbegin и autopanend балуна геообъекта.
    • У программно созданных макетов не вызывался метод destroy.
    • В некоторых случаях дублировались события defaultaction в контролах.
    • После закрытия балуна геообъекта появлялась подсказка.
    • Не ставились точки линейки поверх геообъектов.
    • Некорректно позиционировались мини-балуны линейки в IE8 и IE9.
    • Ошибки панели управления «Пробки» при ее повторном добавлении на карту.
    • Ошибки в верстке выпадающих списков в IE8.
    • Изменялся центр карты по длинному нажатию по геообъекту в Safari iOS 6.1.
    • В некоторых случаях не пропадали подсказки кластеров.
    • В Windows 8 приходили одновременно события click и contextmenu.
    • При автоматическом проваливании в народную карту в Firefox не показывались тайлы для устройств с высокой плотностью пикселей.
    • В некоторых случаях пропадала интерактивность геообъектов при изменении масштаба карты.
    • При изменении опции pane выставлялось некорректное значение zIndex геообъектов.
  • JSAPI 2.1.4 (19 декабря 2013 г.) Скачать справочникСписок изменений Добавлено:
    • Возможность отображения всплывающей подсказки в кластеризаторе.
    • В geometry.LineString добавлен метод getDistance.
    • Поле currentTarget при распространении событий геообъектов.
    • Пресеты для кластеризатора можно напрямую задавать в метке кластера.
    • Значение опции clusterIconContentLayout можно выставлять в null для отображения метки кластера без содержимого.
    • Возможность задавать shape в описании меток кластеров.
    • Параметр context в методе GeoQueryResult.each.
    • Опция балуна panelMaxMapSize.
    • Опция interactiveZIndex, которая отключает автозадание zIndex в зависимости от состояния геообъекта.
    • Добавлен пейн overlays.
    • Опция iconOpacity для меток.
    • Кнопка «показать ещё результаты» для элемента управления «Поиск по карте».
    • Опция viewportMargin кластеризатора.
    Изменено:
    • Методы кластеризатора get, each, getIterator заменены на getGeoObjects и getClusters.
    • Объект Cluster переименован в ClusterPlacemark.
    • Улучшена логика проваливания в Народную карту.
    • Метод работы с балуном кластера placemark.balloon.open и cluster.balloon.open.
    • Теперь метки в кластеризатор всегда добавляются синхронно.

    Исправлено:

    • Поддержка Windows Phone 8.
    • Ошибки с видимостью текста в поисковой строке.
    • Ошибки с отображением копирайтов.
    • Ошибки при позиционировании элементов списка при отрицательных индексах.
    • Некорректное поведение кластеризатора при значении опции gridSize, не равном степени двойки.
    • На карте генерировались лишние события mouseleave в IE8 и IE9.
    • Ошибки при попытке сброса значения опции менеджера элементов управления.
    • Ошибки в удалении набора элементов управления с карты.
    • Ошибки после включения режима рисования метки.
    • Ошибки загрузки API без указания параметра load.
    • Утечки памяти при удалении событий налету в domEvent.manager.
    • Ошибки при клике правой кнопкой мыши в браузер с pointer-событиями.
    • При открытии панели балуна копирайты не смещались вверх.
    • Ошибки в верстке панели управления «Пробки» в Opera.
    • Ошибки в верстке выпадающего списка.
    • Неправильный учет zIndex оверлеев, которые находятся в разных пейнах.
    • Инвертированный scroll zoom в Chrome.
    • Ошибки в распространении событий на геообъектах, не имеющих балуна.
    • Неправильное перерисование балуна при изменении размеров карты или при перетаскивании метки.
    • Проблемы с производительностью при использовании проекции Cartesian.
    • В IE8 не появлялся балун при выходе из полноэкранного режима.
    • При удалении линейки оставались открытые подсказки, если крайнюю точку линейки удаляли двойным кликом.
    • Ломалась линейка после добавления новой точки из середины отрезка.
    • Балун превращался в панель, если карта невысокая, но широкая.
    • При открытии на метке балуна с autoPan на карте оставался курсор.
    • Hintclose отображался по движению карты, даже если подсказки нет.
    • Не менялся текст в элементе управления «Пробки» при перемещении в регион без данных.
    • Ошибки в интерактивности меток при экспорте через YMapsML.
    • Иконка не удалялась из кнопки после использования метода unset.
    • Некорректно позиционировались подсказки над узлами линейки.
    • Не скрывалась метка кластера при открытии балуна.
    • Разные размеры точки линейки в IE и Opera.
    • Съезжал балун у линии при зуме.
    • Лишние mouseenter на объектах карты.
    • При зуме колесом мыши вместе с картой скроллилась страница в Firefox.
    • В режиме редактирования при продолжении линии пропадала часть, отображающая «продолжение» при наведении.
    • В некоторых случаях не изменялось значение поля GeoObject.state.get (‘hover’) при первом движении курсора.
    • Правильный порядок событий click, select и press для FullscreenControl.
    • Часть элементов управления не сворачивалась при mousedown на карте.
    • В некоторых случаях балун не перемещалася вслед за геообъектом.
    • Ошибки опции drawOver в geometryEditor.
    • Ошибки при быстром завершении редактирования объектов.
    • Ошибки при включении опции geodesic.
    • Подсказка геообъекта появлялась при открытии балуна объекта активной области.
    • Некорректная работа API при подключении библиотеки bootstrap.
    • При изменении видимой области карты приходили события неправильного типа.
    • Ошибки при бросании balloonclose и balloonopen у активных областей.
    • Ошибки при autoPan при работе с линейкой.
    • Не работала опция interactivityModel у всплывающих подсказок.
    • При смене типа карты кнопки в зуме не переставали быть активными/неактивными.
    • Не появлялся курсор в поисковой строке по нажатию на SearchControl.
    • Ломалось перемещение геообъектов после перемещения касанием.
    • В некоторых случаях перестраивался элемент управления выбора типа карты при смене опций.
    • Лишнее сворачивание и разворачивание элементов управления при переходе в полноэкранный режим.
    • Ошибки при удалении типов карты из control.TypeSelector.
    • Ошибки рендеринга геометрий.
    • Изменение размера карты по вертикали в полноэкранном режиме в IE8.
    • Ошибки работы API в IE8.
  • JSAPI 2.1.3 (14 ноября 2013 г.) Скачать справочникСписок изменений Добавлено:
    • Поддержка IE11.
    • Поддержка iOS7.
    • Новые режимы работы метода panTo.
    • Кнопки изменения масштаба карты теперь становятся неактивными при достижении крайних масштабов.
    • Объект STOP_ITERATION в интерфейсе IIterator.

    Исправлено:

    • Ошибки в IE.
    • Не работало изменение zIndex-ов геообъектов в обработчике событий наведения мыши, открытия балуна, перемещения карты.
    • Ошибки в верстке элемента управления «Пробки».
    • Некорректная работа при вызове метода Balloon.autoPan во время плавного движения карты.
    • Не удалялась иконка из кнопки при использовании метода options.unset.
    • Невозможно было сделать кнопку линейки недоступной.
    • Слой активных областей кидал событие defaultaction два раза.
    • Переменная YMaps утекала в глобальную область видимости.
    • В некоторых ситуациях удаление кнопки с карты приводило к исключению. Ошибки при перетаскивании точек линейки.
    • Пустая подсказка над первой точкой линейки.
    • Не приходили события с содержимого SVG-меток.
    • Ошибка в верстке тянущихся иконок.
    • Некорректное перетаскивание меток в webkit-браузерах под Windows 8.
    • Не приходило событие contextmenu при двойном клике правой кнопки. Конфликт поведения ruler и routeEditor.
    • Не генерировались mouseenter и mouseleave на карте.
    • Не генерировалось событие press для FullscreenControl и GeolocationControl. Перед contextmenu не генерировалось событие mousedown.
    • Неправильная активная область у тянущейся метки.
    • На тач-устройствах не пропадала подсказка геообъекта после перетаскивания.
    • Не отображалась подсказка при открытом балуне.
    • Событие userclose в балуне срабатывало дважды.
    • В некоторых ситуациях не срабатывал элемент управления Fullscreen. Неправильный расчет размеров элементов в Firefox.

Форма обратной связи

Если при переключении версии API ваше приложение стало работать некорректно или вы обнаружили какие-либо ошибки в функциональности, пожалуйста, напишите нам об этом. Постарайтесь максимально подробно описать проблему и по возможности приложите скриншот.

tech.yandex.ru

History - Web technology for developers

The History interface allows manipulation of the browser session history, that is the pages visited in the tab or frame that the current page is loaded in.

Properties

The History interface doesn't inherit any property.

History.length Read only Returns an Integer representing the number of elements in the session history, including the currently loaded page. For example, for a page loaded in a new tab this property returns 1. History.current Read only Obsolete since Gecko 26 Returns a DOMString representing the URL of the active item of the session history. This property was never available to web content and is no more supported by any browser. Use Location.href instead. History.next Read only Obsolete since Gecko 26 Returns a DOMString representing the URL of the next item in the session history. This property was never available to web content and is not supported by other browsers. History.previous Read only Obsolete since Gecko 26 Returns a DOMString representing the URL of the previous item in the session history. This property was never available to web content and is not supported by other browsers. History.scrollRestoration  Allows web applications to explicitly set default scroll restoration behavior on history navigation. This property can be either auto or manual. History.state Read only Returns an any value representing the state at the top of the history stack. This is a way to look at the state without having to wait for a popstate event.

Methods

The History interface doesn't inherit any methods.

History.back() Goes to the previous page in session history, the same action as when the user clicks the browser's Back button. Equivalent to history.go(-1).

Calling this method to go back beyond the first page in the session history has no effect and doesn't raise an exception.

History.forward() Goes to the next page in session history, the same action as when the user clicks the browser's Forward button; this is equivalent to history.go(1).

Calling this method to go forward beyond the most recent page in the session history has no effect and doesn't raise an exception.

History.go() Loads a page from the session history, identified by its relative location to the current page, for example -1 for the previous page or 1  for the next page. If you specify an out-of-bounds value (for instance, specifying -1 when there are no previously-visited pages in the session history), this method silently has no effect. Calling go() without parameters or a value of 0 reloads the current page. Internet Explorer lets you also specify a string to go to a specific page in the history list. History.pushState() Pushes the given data onto the session history stack with the specified title and, if provided, URL. The data is treated as opaque by the DOM; you may specify any JavaScript object that can be serialized.  Note that Firefox currently ignores the title parameter; for more information, see manipulating the browser history. History.replaceState() Updates the most recent entry on the history stack to have the specified data, title, and, if provided, URL. The data is treated as opaque by the DOM; you may specify any JavaScript object that can be serialized.  Note that Firefox currently ignores the title parameter; for more information, see manipulating the browser history.

Specifications

Browser compatibility

Feature Chrome Edge Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support (Yes) (Yes) (Yes) (Yes) (Yes) (Yes)
pushState and replaceState 5.0 (Yes) 4.0 [1] 10 11.5 5
scrollRestoration 46.0 No support 46.0 (46.0) No support 33 (Yes)[2]
Feature Android Android Webview Edge Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile Chrome for Android
Basic support (Yes) (Yes) (Yes) (Yes) (Yes) (Yes) (Yes) (Yes)
pushState and replaceState 2.2 (Yes) (Yes) (Yes) 10 (Yes) 4.3 (Yes)
scrollRestoration No support 46.0 No support (Yes) No support (Yes) (Yes)[2] 46.0

[1] In Firefox 2 through 5, the passed object is serialized using JSON. Starting in Firefox 6, the object is serialized using the structured clone algorithm. This allows a wider variety of objects to be safely passed.

[2] WebKit bug 147782

See also

  • The Window.history property returning the history of the current session.

Document Tags and Contributors

 Contributors to this page: ryanf, HINMass, divyanshu013, jackblackevo, abehan, Siphalor, yisibl, arronei, erikadoyle, Sheppy, shvaikalesh, jpmedley, Jeremie, fscholz, codelahoma, teoli  Last updated by: ryanf, Oct 10, 2017, 6:50:55 PM

developer.mozilla.org

JavaScript | MDN

JavaScript (JS) is a lightweight interpreted or JIT-compiled programming language with first-class functions. While it is most well-known as the scripting language for Web pages, many non-browser environments also use it, such as Node.js, Apache CouchDB and Adobe Acrobat. JavaScript is a prototype-based, multi-paradigm, dynamic language, supporting object-oriented, imperative, and declarative (e.g. functional programming) styles. Read more about JavaScript.

This section is dedicated to the JavaScript language itself, and not the parts that are specific to Web pages or other host environments. For information about APIs specific to Web pages, please see Web APIs and DOM.

The standard for JavaScript is ECMAScript. As of 2012, all modern browsers fully support ECMAScript 5.1. Older browsers support at least ECMAScript 3. On June 17, 2015, ECMA International published the sixth major version of ECMAScript, which is officially called ECMAScript 2015, and was initially referred to as ECMAScript 6 or ES6. Since then, ECMAScript standards are on yearly release cycles. This documentation refers to the latest draft version, which is currently ECMAScript 2018.

Do not confuse JavaScript with the Java programming language. Both "Java" and "JavaScript" are trademarks or registered trademarks of Oracle in the U.S. and other countries. However, the two programming languages have very different syntax, semantics, and uses.

Tutorials

Learn how to program in JavaScript with guides and tutorials.

For complete beginners

Head over to our Learning Area JavaScript topic if you want to learn JavaScript but have no previous experience of JavaScript or programming. The complete modules available there are as follows:

JavaScript first steps Answers some fundamental questions such as "what is JavaScript?", "what does it look like?", and "what can it do?", along with discussing key JavaScript features such as variables, strings, numbers, and arrays. JavaScript building blocks Continues our coverage of JavaScript's key fundamental features, turning our attention to commonly-encountered types of code block such as conditional statements, loops, functions, and events. Introducing JavaScript objects The object-oriented nature of JavaScript is important to understand if you want to go further with your knowledge of the language and write more efficient code, therefore we've provided this module to help you.

JavaScript guide

JavaScript Guide A much more detailed guide to the JavaScript language, aimed at those with previous programming experience either in JavaScript or another language.

Intermediate

Client-side web APIs When writing client-side JavaScript for web sites or applications, you won't go very far before you start to use APIs — interfaces for manipulating different aspects of the browser and operating system the site is running on, or even data from other web sites or services. In this module we will explore what APIs are, and how to use some of the most common APIs you'll come across often in your development work.  A re-introduction to JavaScript An overview for those who think they know about JavaScript. JavaScript data structures Overview of available data structures in JavaScript. Equality comparisons and sameness JavaScript provides three different value-comparison operations: strict equality using ===, loose equality using ==, and the Object.is() method.

Advanced

Inheritance and the prototype chain Explanation of the widely misunderstood and under-estimated prototype-based inheritance. Strict mode Strict mode defines that you can not use any variable before initializing it. It is a restricted variant of ECMAScript 5, for faster performance and easier debugging. JavaScript typed arrays JavaScript typed arrays provide a mechanism for accessing raw binary data. Memory Management Memory life cycle and garbage collection in JavaScript. Concurrency model and Event Loop JavaScript has a concurrency model based on an "event loop".

Reference

Browse the complete JavaScript reference documentation.

Standard objects Get to know standard built-in objects Array, Boolean, Date, Error, Function, JSON, Math, Number, Object, RegExp, String, Map, Set, WeakMap, WeakSet, and others. Expressions and operators Learn more about the behavior of JavaScript's operators instanceof, typeof, new, this, the operator precedence, and more. Statements and declarations Learn how do-while, for-in, for-of, try-catch, let, var, const, if-else, switch, and more JavaScript statements and keywords work. Functions Learn how to work with JavaScript's functions to develop your applications.

Helpful tools for writing and debugging your JavaScript code.

Firefox Developer Tools Scratchpad, Web Console, JavaScript Profiler, Debugger, and more. JavaScript Shells A JavaScript shell allows you to quickly test snippets of JavaScript code. TogetherJS Collaboration made easy. By adding TogetherJS to your site, your users can help each other out on a website in real time! Stack Overflow Stack Overflow questions tagged with "JavaScript". JavaScript versions and release notes Browse JavaScript's feature history and implementation status. JSFiddle Edit JavaScript, CSS, HTML and get live results. Use external resources and collaborate with your team online. Plunker Plunker is an online community for creating, collaborating on and sharing your web development ideas. Edit your JavaScript, CSS, HTML files and get live results and file structure.

developer.mozilla.org

Intl - Web technology for developers

The Intl object is the namespace for the ECMAScript Internationalization API, which provides language sensitive string comparison, number formatting, and date and time formatting. The constructors for Collator, NumberFormat, and DateTimeFormat objects are properties of the Intl object. This page documents these properties as well as functionality common to the internationalization constructors and other language sensitive functions.

Properties

Intl.Collator Constructor for collators, objects that enable language sensitive string comparison. Intl.DateTimeFormat Constructor for objects that enable language sensitive date and time formatting. Intl.NumberFormat Constructor for objects that enable language sensitive number formatting. Intl.PluralRules Constructor for objects that enable plural sensitive formatting and plural language langue rules.

Methods

Intl.getCanonicalLocales() A method returning the canonical locale names.

Locale identification and negotiation

The internationalization constructors as well as several language sensitive methods of other constructors (listed under See also) use a common pattern for identifying locales and determing the one they will actually use: they all accept locales and options arguments, and negotiate the requested locale(s) against the locales they support using an algorithm specified in the options.localeMatcher property.

locales argument

The locales argument must be either a string holding a BCP 47 language tag, or an array of such language tags. If the locales argument is not provided or is undefined, the runtime's default locale is used.

A BCP 47 language tag defines a language and minimally contains a primary language code. In its most common form it can contain, in order: a language code, a script code, and a country or region code, all separated by hyphens. While the tag is not case sensitive, it is recommended to use title case for script code, upper case for country and region codes and lower case for everything else.

Examples:

  • "hi": Hindi (primary language).
  • "de-AT": German as used in Austria (primary language with country code).
  • "zh-Hans-CN": Chinese written in simplified characters as used in China (primary language with script and country codes).

The subtags identifying languages, scripts, countries (regions), and (rarely used) variants in BCP 47 language tags can be found in the IANA Language Subtag Registry.

BCP 47 also allows for extensions. JavaScript internationalization functions use the "u" (Unicode) extension, which can be used to request additional customization of Collator, NumberFormat, or DateTimeFormat objects. Examples:

  • "de-DE-u-co-phonebk": Use the phonebook variant of the German sort order, which expands umlauted vowels to character pairs: ä → ae, ö → oe, ü → ue.
  • "th-TH-u-nu-thai": Use Thai digits (๐, ๑, ๒, ๓, ๔, ๕, ๖, ๗, ๘, ๙) in number formatting.
  • "ja-JP-u-ca-japanese": Use the Japanese calendar in date and time formatting, so that 2013 is expressed as the year 25 of the Heisei period, or 平成25.
  • "en-GB-u-ca-islamic": use British English with the Islamic (Hijri) calendar, where the Gregorian date 14 October, 2017 is the Hijri date 24 Muharram, 1439.

Locale negotiation

The locales argument, after stripping off all Unicode extensions, is interpreted as a prioritized request from the application. The runtime compares it against the locales it has available and picks the best one available. Two matching algorithms exist: the "lookup" matcher follows the Lookup algorithm specified in BCP 47; the "best fit" matcher lets the runtime provide a locale that's at least, but possibly more, suited for the request than the result of the Lookup algorithm. If the application doesn't provide a locales argument, or the runtime doesn't have a locale that matches the request, then the runtime's default locale is used. The matcher can be selected using a property of the options argument (see below).

If the selected language tag had a Unicode extension substring, that extension is now used to customize the constructed object or the behavior of the function. Each constructor or function supports only a subset of the keys defined for the Unicode extension, and the supported values often depend on the language tag. For example, the "co" key (collation) is only supported by Collator, and its "phonebk" value is only supported for German.

options argument

The options argument must be an object with properties that vary between constructors and functions. If the options argument is not provided or is undefined, default values are used for all properties.

One property is supported by all language sensitive constructors and functions: The localeMatcher property, whose value must be a string "lookup" or "best fit" and which selects one of the locale matching algorithms described above.

Specifications

Browser compatibility

Basic supportgetCanonicalLocalesCollatorDateTimeFormatNumberFormatPluralRules
DesktopMobileServer
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidEdge MobileFirefox for AndroidOpera for AndroidiOS SafariSamsung InternetNode.js
Full support 24 Full support Yes Full support 29 Full support 11 Full support 15 Full support 10 No support No Full support 26 Full support Yes Full support 56 ? Full support 10 ? ?
Full support 54 No support No Full support 48 No support No No support No Full support 11 No support No No support No No support No Full support 56 No support No Full support 11 ? No support No
Full support 24 Full support Yes Full support 29 Full support 11 Full support 15 Full support 10 No support No Full support 26 Full support Yes Full support 56 ? Full support 10 ? ?
Full support 24 Full support Yes Full support 29 Full support 11 Full support 15 Full support 10 No support No Full support 26 Full support Yes Full support 56 ? Full support 10 ? ?
Full support 24 Full support Yes Full support 29 Full support 11 Full support 15 Full support 10 Full support 4.4 Full support 26 Full support Yes Full support 56 Full support 37 Full support 10 ? ?
Full support 63 No support No Full support 58 No support No Full support 50 No support No Full support 63 Full support 63 No support No Full support 58 Full support 50 No support No ? No support No

Legend

Full support   Full support No support   No support Compatibility unknown   Compatibility unknown

See also

developer.mozilla.org


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

 

..:::Новинки:::..

Windows Commander 5.11 Свежая версия.

Новая версия
IrfanView 3.75 (рус)

Обновление текстового редактора TextEd, уже 1.75a

System mechanic 3.7f
Новая версия

Обновление плагинов для WC, смотрим :-)

Весь Winamp
Посетите новый сайт.

WinRaR 3.00
Релиз уже здесь

PowerDesk 4.0 free
Просто - напросто сильный upgrade проводника.

..:::Счетчики:::..