Установить заголовок страницы BX24.setTitle

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

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

Метод BX24.setTitle меняет заголовок страницы Битрикс24 над фреймом приложения. Название вкладки браузера при этом не меняется.

Метод работает, только когда приложение открыто на своей странице в Битрикс24. В местах встраивания, например во вкладке карточки CRM, Битрикс24 команду не выполняет. Вызывайте метод после инициализации библиотеки в обработчике BX24.init. Собственный scope методу не нужен: он управляет интерфейсом, а не обращается к REST API.

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

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

Название
тип

Описание

title*
string

Новый заголовок. Число библиотека превратит в строку

callback
callable

Функция обратного вызова. Получает объект с новым заголовком (подробное описание)

Пример кода

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

BX24.init(function () {
    BX24.setTitle('Заявки за неделю', function (result) {
        console.log('Новый заголовок:', result.title);
    });
});

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

Метод не возвращает данные (void). Когда Битрикс24 обработает команду, он вызовет callback и передаст объект с новым заголовком:

{
    "title": "Заявки за неделю"
}

Возвращаемые данные

Название
тип

Описание

title
string

Новый заголовок страницы

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

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

Ситуация

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

Что делать

Метод вызван в месте встраивания

Заголовок не меняется, callback не вызывается

Показать заголовок в интерфейсе самого приложения

Метод вызван в окне, которое открыл BX24.openApplication

Меняется заголовок страницы под окном. У самого окна заголовка нет. callback вызывается как обычно

Показать заголовок в интерфейсе самого приложения

В title передан null или undefined

Код приложения завершается ошибкой JavaScript TypeError, команда не уходит в Битрикс24

Передать строку

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