---
metadata:
- name: generator
content: Diplodoc Platform v5.39.1
alternate:
- https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/ready.md
- https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ready.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/jsapi-v2-1/doc/ru/llms.txt
# ready
Статическая функция.
Выполняет переданную функцию, когда API и DOM готовы к использованию.
**Возвращает** Promise объект, который подтверждается пространством имен API, либо отклоняется, если при загрузке произошла ошибка.
```javascript
{ vow.Promise } ready([successCallback[, errorCallback[, context]]])
```
**Параметры:**
#|
|| **Параметр** | **Значение по умолчанию** | **Описание** ||
|| [`successCallback`](#param-successCallback) | — | Тип: Function\|Object
Функция, которая будет вызвана при успешной загрузке и инициализации API и DOM, или объект с параметрами, если используется расширенный синтаксис.
Доступный список параметров:
- require - массив дополнительных модулей, которые должны быть загружены вместе с API;
- successCallback — функция, которая будет вызвана при успешной загрузке API;
- errorCallback — функция, которая будет вызвана в случае ошибки;
- context — контекст исполнения функций.
Все параметры являются необязательными.
В successCallback будет передано пространство имен API. ||
|| [`errorCallback`](#param-errorCallback) | — | Тип: Function
Функция, которая будет вызвана если произошла ошибка при инициализации. В функцию будет передана ошибка. ||
|| [`context`](#param-context) | — | Тип: Object
Контекст исполнения функции. ||
|#
**Примеры:**
**1.**
```javascript
Example
```
**2.**
```javascript
// Пример использования расширенного синтаксиса функции ready.
ymaps.ready({
// successCallback будет вызван, когда загрузятся API и модуль "myModule1".
require: ['myModule1'],
successCallback: function (ym) {
var map = new ymaps.Map('map', {
center: [55.7, 37.6],
zoom: 10
});
var obj = new ymaps.myModule1();
// ...
}})
```