--- metadata: - name: generator content: Diplodoc Platform v5.39.1 alternate: - en/ - ru/ - tr/ --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/browser-constructor/doc/ru/llms.txt # Как помочь посетителю сайта обновить свой браузер? Некоторые посетители вашего сайта могут пользоваться устаревшим или совсем не подходящим для вашего сайта браузером. Чтобы помочь такому посетителю обновить или установить нужный браузер, вы можете настроить уведомления на сайте с помощью скрипта Яндекса. Доступно два типа уведомлений: «браузер устарел» и «браузер не поддерживается сайтом». #### **Браузер устарел** Пользователи устаревших браузеров видят предложение обновиться при каждой загрузке страницы. Уведомление выводится в виде плашки вверху страницы. По клике на плашку открывается попап со ссылками на последние версии популярных браузеров. Вы можете выбрать минимальные версии браузеров самостоятельно, либо положиться на список по умолчанию, который поддерживает Яндекс (подробнее — в инструкциях ниже). Если вы пользуетесь собственным списком, не забывайте обновлять его по мере выхода новых версий браузеров. Посетитель, который закрыл уведомление и не обновился, по умолчанию не увидит плашку снова в течение 30 дней. Вы можете изменить эту логику, вручную указав нужные значения параметров `remember` и `rememberFor` из [таблицы дополнительных параметров](#doppar). #### **Браузер не поддерживается сайтом** Если браузер посетителя не поддерживается сайтом, он увидит только уведомление со ссылкой на последнюю версию поддерживаемого браузера. Уведомление полностью блокирует содержимое страниц, так что пользоваться сайтом в неподходящем браузере становится невозможно. Код уведомления можно получить двумя способами: [Сгенерировать с помощью конструктора](#generate)
[Написать самостоятельно](#scenarios) ## Настроить уведомление с помощью конструктора {#generate} В [конструкторе](https://tech.yandex.ru/browser/constructor/) вы можете выбрать: - Тип уведомления и язык сообщений (параметры `exclusive` и `lang` в [таблице основных параметров](#osnpar)). - Цвет полоски-уведомления (параметр `theme` в [таблице основных параметров](#osnpar)). Если сайт доступен только для одного браузера, параметр не используется. - Список версий браузеров, которые вы хотите считать устаревшими (управляются параметром `browsers` из [таблицы основных параметров](#osnpar)). Предлагаемый Яндексом список отмечен в конструкторе по умолчанию. Список по умолчанию время от времени обновляется. Если у вас нет специфических требований к версиям браузеров, вы можете автоматически получать самый свежий список устаревших версий. Для этого достаточно удалить параметр `browsers` из сгенерированного кода. Полученный код вставьте на каждой странице вашего сайта после открывающего тега ``. Для всех [дополнительных параметров](#doppar), не указанных в этом коде, скрипт будет использовать значения по умолчанию. ## Настроить уведомление самостоятельно {#scenarios} Код подключения и вызова скрипта нужно вставить после открывающего тега `` на каждой странице вашего сайта. Подключите скрипт с сервера Яндекса: ```no-highlight ``` Создайте объект уведомления с помощью метода `ya.browserUpdater.init()` и передайте [параметры уведомления](#param) в аргументах: ```no-highlight ``` ## Пример кода для уведомления об устаревшем браузере > ```no-highlight > > > ``` ### Параметры уведомления {#param} #### Основные параметры {#osnpar} #| || **Параметр** | **Описание** | **Возможные значения** | **Формат** || ||`exclusive` {#d-exclusive} | Признак того, что сайт доступен только для одного браузера. | `true` — сайт доступен только для одного браузера.
`false` — браузер посетителя устарел.
Значение по умолчанию — `false`. | boolean || ||`theme` {#d-theme} | Цвет полоски-уведомления. Игнорируется, если вы используете уведомление, что сайт доступен только для одного браузера. | Доступны следующие цвета:
`yellow` — желтый;
`red` — красный;
`blue` — синий;
`green` — зеленый;
`white` — белый;
`black` — черный;
`grey` — серый.
Значение по умолчанию — `yellow`. | string || ||`lang` {#d-lang} | Язык уведомления. | Доступны следующие языки:
`ru` — русский;
`tr` — турецкий;
`en` — английский.
Значение по умолчанию — `ru`. | string || ||`browsers` {#bro-gen} | Ограничения для версий браузеров. Чтобы всегда использовать список по умолчанию, который поддерживается Яндексом, не указывайте параметр `browsers` совсем. Для некоторых браузеров все версии считаются устаревшими, если вы не укажете какую-либо старую версию в качестве максимально допустимой. Версиии можно указать для следующих браузеров: - `chromium` — Chromium; - `iron` — Iron; - `flock` — Flock; - `palemoon` — Pale Moon; - `camino` — Camino; - `safari` — Safari; - `yandexinternet` — Yandex Internet; - `fx` — Firefox; - `ie` — Internet Explorer; - `opera` — Opera; - `chrome` — Google Chrome; - `maxthon` — Maxthon; - `seamonkey` — SeaMonkey; - `yabrowser`— Yandex Browser. | Поддерживаемые значение ключа зависят от значения параметра `exclusive`. #### exclusive=true Сайт доступен только для одного браузера. Можно выбрать следующие браузеры:
`chrome`;
`fx`;
`ie`;
`yabrowser` (по умолчанию).
#### exclusive=false Список идентификаторов браузеров с минимальными поддерживаемыми версиями. Версию можно задать числом или словом `Infinity`, которое означает, что все версии браузера считаются устаревшими. | string или object || |# #### Дополнительные параметры {#doppar} Учитываются только для уведомления об устаревшем браузере. #| || **Параметр** | **Описание** | **Возможные значения** | **Формат** || ||`remember` {#remember} | Признак того, что нужно выставить куку `yaBrowserUpdaterHide`, где записано, что посетитель сайта закрыл полоску-уведомление, и нужно сделать паузу в ее выдаче. Пауза действует в течении срока, заданного параметром `rememberFor`, при условии, что посетитель сайта не почистит куки. | `true` — не показывать уведомление в течение времени, заданного параметром `rememberFor` (по умолчанию — 30 дней).
`false` — показывать уведомление при каждой загрузке страницы.
Значение по умолчанию — `true`. | boolean || ||`rememberFor` {#remember-for} | Продолжительность паузы в выдаче уведомлений, в днях. Учитывается при отсутствии параметра `remember` или значении`remember=true`. | Значение по умолчанию — `30`. | number || ||`cookiePrefix` | Имя куки, устанавливаемой скриптом. Если вы уже выставляете куку с именем `yaBrowserUpdaterHide`, то имя куки, которую должен выставлять скрипт, нужно задать с помощью этого параметра. | Ваше имя куки. | string || ||`classNamePrefix` | Префикс в имени CSS-классов, генерируемых скриптом. Если вы уже используете CSS-класс с префиксом `ya-browser-updater`, то префикс, который должен использоваться скриптом, нужно задать с помощью этого параметра. | Ваш префикс имени CSS-классов. | string || ||`jsonpCallback` | Название глобальной callback-функции [JSONP](https://ru.wikipedia.org/wiki/JSONP), которая будет вызвана после получения обработанных данных о браузере. Если вы уже используете callback-функцию с именем `yaBrowserUpdaterJSONPCallback` в другом месте, то имя функции, которая должна использоваться скриптом, нужно задать с помощью этого параметра. | Ваше имя callback-функции. | string || ||`onStripeShow` | Функция, срабатывающая при выдаче полоски-уведомления. С ее помощью можно передать информацию о [достижении цели в Метрику](https://yandex.ru/support/metrika/objects/reachgoal.xml) или задать верхний отступ на странице, чтобы полоска не перекрывала часть содержимого. | Название функции или сама функция, например: ```cpp onStripeShow: function () { alert('show') } ``` Значение по умолчанию — `null`. | string или function || ||`onStripeHide` | Функция, срабатывающая при исчезновении полоски-уведомления. С ее помощью можно передать информацию о [достижении цели в Метрику](https://yandex.ru/support/metrika/objects/reachgoal.xml) или убрать верхний отступ на странице. | Название функции или сама функция, например: ```cpp onStripeHide: function() { yaCounterXXXXXX.reachGoal('stripe_hidden'); } ``` Значение по умолчанию — `null`. | string или function || |# [*theme-popup]: Цвет полоски-уведомления.
Игнорируется, если вы используете уведомление, что сайт доступен только для одного браузера. [*lang-popup]: Язык уведомления. [*exclusive-popup]: Признак того, что сайт доступен только для одного браузера. [*browsers-popup]: Ограничения для версий браузеров. Чтобы всегда использовать список по умолчанию, который поддерживается Яндексом, не указывайте параметр `browsers` совсем. [*remember-popup]: Признак того, что нужно выставить куку `yaBrowserUpdaterHide`, где записано, что посетитель сайта закрыл полоску-уведомление, и нужно сделать паузу в ее выдаче. [*rememberFor-popup]: Продолжительность паузы в выдаче уведомлений, в днях. [*cookiePrefix-popup]: Имя куки, устанавливаемой скриптом. [*classNamePrefix-popup]: Префикс в имени CSS-классов, генерируемых скриптом. [*jsonpCallback-popup]: Название глобальной callback-функции [JSONP](https://ru.wikipedia.org/wiki/JSONP), которая будет вызвана после получения обработанных данных о браузере. [*onStripeShow-popup]: Функция, срабатывающая при выдаче полоски-уведомления. [*onStripeHide-popup]: Функция, срабатывающая при исчезновении полоски-уведомления.