---
metadata:
- name: generator
content: Diplodoc Platform v5.39.1
alternate:
- https://yandex.ru/dev/jsapi-v2-1/doc/en/v2-1/examples/cases/module_request.md
- https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/examples/cases/module_request.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/jsapi-v2-1/doc/ru/llms.txt
# Загрузка модуля по требованию
Open in CodeSandbox
В данном примере при инициализации загружаются только модули карты и кнопки.
По клику кнопки происходит загрузка модуля метки.
Загрузку отдельных модулей можно производить при помощи метода require модульной системы.
Метод возвращет объект-обещание, который подтверждается массивом запрошенных модулей.
Для удобства в примере используется метод spread, который передает в функцию данные в виде списка аргументов, а не в виде массива.
API Яндекс.Карт состоит из большого количества взаимосвязанных модулей.
По умолчанию при подключении API происходит загрузка стандартного набора модулей (package.full), который включает в себя все необходимое для работы API.
Для сокращения объема загружаемого кода API можно подключать некоторые модули вместо стандартного набора.
Это можно сделать, указав необходимые модули в GET-параметре load. Модули перечисляются через запятую.
Если GET-параметр load не указан, то просходит загрузка package.full.
Подробнее о работе модулей смотрите в разделе Модули.
{% list tabs %}
- index.html
```html
Загрузка модуля по требованию
```
- module_request.js
```js
ymaps.ready(function () {
var myMap = new ymaps.Map("map", {
center: [55.755381, 37.619044],
zoom: 7,
// Не отображаем на карте никакие стандартные элементы управления, так как они не были загружены.
controls: [],
});
var loadControl = new ymaps.control.Button({
data: { content: "Добавить метку" },
options: { maxWidth: 200, float: "right", selectOnClick: false },
});
myMap.controls.add(loadControl);
loadControl.events.add("click", function () {
if (ymaps.Placemark) {
// Если модуль уже был загружен, то нет необходимости повторно обращаться к модульной системе.
addPlacemark();
} else {
// Загружаем по требованию класс метки и оверлея метки.
// По умолчанию оверлей автоматически загружается после добавления метки на карту.
// В данном примере происходит асинхронная загрузка самого модуля метки и нет необходимости в отдельной подгрузке оверлея.
ymaps.modules
.require(["Placemark", "overlay.Placemark"])
.spread(function (Placemark, PlacemarkOverlay) {
// Добавляем в глобальную область видимости класс вручную,
// так как при использовании метода require модульной системы этого не происходит.
ymaps.Placemark = Placemark;
addPlacemark();
});
}
});
function addPlacemark() {
var center = myMap.getCenter();
// Устанавливаем случайную позицию, близкую к центру карты.
center[0] += Math.random() * 2 - 1;
center[1] += Math.random() * 2 - 1;
var placemark = new ymaps.Placemark(center);
myMap.geoObjects.add(placemark);
}
});
```
{% endlist %}