Перезагрузить страницу BX24.reloadWindow
Выберите инструмент для разработки с AI-агентом:
- используйте Битрикс24 Вайбкод, чтобы создать приложение для Битрикс24 по описанию задачи без знания языков программирования. Агент напишет код и разместит приложение на сервере без ручной настройки хостинга
- используйте MCP-сервер, чтобы разрабатывать интеграцию через REST API в своем проекте. Агент будет обращаться к официальной REST-документации
BX24.reloadWindow(callback?: callable): void;
Метод BX24.reloadWindow перезагружает страницу Битрикс24, на которой открыто приложение. Вместе со страницей заново загружается и само приложение. Начиная с версии модуля rest 25.800.0 метод можно использовать в местах встраивания приложения.
Чтобы перезагрузить только приложение, а страницу Битрикс24 оставить, вызовите location.reload() в коде страницы приложения: библиотека инициализируется заново.
Метод работает только внутри фрейма приложения в Битрикс24. Вызывайте его после инициализации библиотеки в обработчике BX24.init. Собственный scope методу не нужен: он управляет интерфейсом, а не обращается к REST API.
Параметры метода
|
Название |
Описание |
|
callback |
Библиотека принимает параметр, но Битрикс24 эту функцию не вызывает: страница перезагружается вместе с приложением |
Пример кода
Как использовать примеры в документации
Перезагрузить страницу по кнопке:
<button id="reload-page">Обновить страницу</button>
<script>
BX24.init(function () {
document.getElementById('reload-page').addEventListener('click', function () {
BX24.reloadWindow();
});
});
</script>
Обработка ответа
Метод не возвращает данные (void). Код, который должен выполниться после перезагрузки, разместите в обработчике BX24.init: после перезагрузки приложение снова пройдет инициализацию.
Обработка ошибок
Кодов ошибок метод не возвращает.
|
Ситуация |
Что происходит |
Что делать |
|
Метод вызван сразу в обработчике BX24.init |
Страница перезагружается без остановки: после каждой перезагрузки обработчик срабатывает снова |
Вызывать метод по действию пользователя или при условии, которое после перезагрузки не повторится |
|
Метод вызван в окне, которое открыл BX24.openApplication |
Перезагружается вся страница под окном, окно закрывается |
Чтобы обновить только приложение в окне, вызвать |