VKWebAppSetLocation

VKWebAppSetLocation устанавливает новое значение хеша — строки после символа # в URL мини-приложения или игры вида https://vk.com/app123#some-value. Это значение используется для навигации внутри приложений и передачи параметров. Для обработки изменений в хеше используйте событие VKWebAppChangeFragment.

Пример

JavaScript
bridge.send('VKWebAppSetLocation', { location: 'fragment' }) .then((data) => { if (data.width) { // Новое значение хеша установлено } }) .catch((error) => { // Ошибка console.log(error); });

Платформы

Android, iOS, Mobile Web, Web

Параметры

Поле
Тип
Описание
location обязательное
string
Новое значение хеша. Символ # в поле указывать не нужно.

Результат

Проверить результат можно:

  • •

    Используя объект Promise, который возвращается вызовом bridge.send(...).

  • •

    С помощью событий VKWebAppSetLocationResult и VKWebAppSetLocationFailed.

Подробнее о проверке результатов при вызовах VK Bridge.

Объект Promise

Если обращение к платформе прошло успешно, управление будет передано в then-обработчик объекта Promise.

Если при обращении к платформе произошла ошибка, управление передаётся в метод catch. В качестве ответа платформа возвращает объект с информацией об ошибке, общий для всех событий VK Bridge.

События

VKWebAppSetLocationResult

Сигнализирует, что новое значение хеша установлено. В обработчик события на стороне пользователя передаются следующие данные:

JavaScript
{ detail: { type: "VKWebAppSetLocationResult", data: { } } }

Передаваемый объект подобен объекту, возвращаемому при успешном выполнении промиса.

VKWebAppSetLocationFailed

Информирует об ошибке, которая произошла при взаимодействии с платформой.

В обработчик события на стороне пользователя передаётся объект с информацией об ошибке, общий для всех методов VK Bridge.

Пример обработки событий

Подробнее — в разделе Обработка результата.

Песочница

VKWebAppSetLocation

Материалы по теме