Загрузить javascript-файлы BX24.loadScript

Выберите инструмент для разработки с AI-агентом:

  • используйте Битрикс24 Вайбкод, чтобы создать приложение для Битрикс24 по описанию задачи без знания языков программирования. Агент напишет код и разместит приложение на сервере без ручной настройки хостинга
  • используйте MCP-сервер, чтобы разрабатывать интеграцию через REST API в своем проекте. Агент будет обращаться к официальной REST-документации
BX24.loadScript(script: string | array, callback?: callable): void;

Метод BX24.loadScript подключает к странице приложения один или несколько javascript-файлов и выполняет их. Файлы из массива загружаются по очереди: следующий — после того, как загрузился предыдущий. Так можно подключить библиотеку, а за ней скрипт, который ее использует.

Если страница еще не готова, метод сам дождется ее готовности — того же момента, когда срабатывают обработчики BX24.ready. Метод не обращается к Битрикс24, поэтому ждать BX24.init не нужно. Собственный scope методу не нужен.

Если файл не загрузился, например его нет на сервере, метод остановится без ошибки: следующие файлы не загрузятся, а callback не будет вызван. Сбой загрузки видно в консоли браузера.

Параметры метода

Обязательные параметры отмечены *

Название
тип

Описание

script*
string|array

Адрес javascript-файла или массив адресов. Относительный адрес браузер отсчитывает так же, как у тега <script> на странице приложения: от ее адреса или от адреса в теге <base>, если он есть, но не от адреса Битрикс24

callback
callable

Функция обратного вызова. Вызывается без параметров, когда загружены все файлы

Пример кода

Как использовать примеры в документации

Подключить библиотеку графиков, затем скрипт отчета, который ее использует:

BX24.loadScript(
    [
        'js/chart.min.js',
        'js/report.js'
    ],
    function () {
        console.log('Все скрипты загружены');
    }
);

Обработка ответа

Метод не возвращает данные (void). Когда загрузится последний файл, библиотека вызовет callback без параметров. Если страница уже готова и передан пустой массив, callback выполнится сразу.

Обработка ошибок

Кодов ошибок метод не возвращает.

Ситуация

Что происходит

Что делать

Файл не загрузился: его нет на сервере или пропала сеть

Загрузка молча останавливается, как описано в предупреждении выше

Проверить адреса файлов. Если приложению важно знать о сбое, ограничить ожидание callback таймером

В файле синтаксическая ошибка

Браузер не выполняет этот файл, но загрузка продолжается, и callback вызывается

Не считать вызов callback доказательством, что каждый файл сработал: проверить, что нужные объекты появились на странице

script не передан или равен null

Возникает исключение TypeError, callback не вызывается. Если страница еще не готова, исключение возникнет позже, когда метод дождется ее готовности, и блок try...catch вокруг вызова его не перехватит

Передать адрес файла или массив адресов

В callback передана не функция

Файлы загружаются без ошибки, но вызова не будет

Передать функцию

В script передана пустая строка или массив из пустых строк

Файлы не загружаются, ошибки нет, а callback вызывается

Если адреса собираются в коде, проверять их перед вызовом

Продолжите изучение

Предыдущая
Получить размеры страницы приложения
Следующая
Открыть путь в слайдере