Об объекте SCS

JavaScript контроллера использует переменные и свойства, определенные в глобальном объекте SCS, для отображения веб-страницы. Перед включением файла controller.js необходимо определить глобальный объект JavaScript в файле контроллера. В объекте SCS имеются два основных свойства, которые можно использовать для настройки:

SCS.sitePrefix

Переменная SCS.sitePrefix определяет префикс пути для сайта, находящегося в режиме онлайн. Обычно по умолчанию используется site/<siteName>/.

JavaScript контроллера использует это значение для определения веб-страницы, которая будет отображаться. Например, если браузер запрашивает страницу в /site/SampleSite/products/index.html, sitePrefix /site/SampleSite/ позволяет JavaScript вычислить, что на сайте должна отображаться страница products/index.html. Обратите внимание, что sitePrefix должен быть строковым значением, которое начинается и заканчивается символом "/".

Если используется прокси-сервер или другая инфраструктура, например правила сопоставления Akamai и URL-адресов, изменение этой переменной позволяет настраивать префикс сайта. Например, установка для sitePrefix значения /intranet/ExampleSite/ позволит доставлять веб-сайт с использованием такого пути в браузере вместо префикса пути по умолчанию /site/SampleSite/.

Примечание.:

В качестве префикса sitePrefix в JavaScript контроллера по умолчанию используется "/", если URL-адрес в браузере не совпадает с префиксом сайта. Это позволяет сайту работать с использованием персонализированного домена без индивидуальной настройки.

SCS.preInitRendering

Если это определено, перед выполнением какой-либо из вычислительных логических операций код JavaScript контроллера вызывает функцию SCS.preInitRendering. Эта функция полезна для определения в пользовательских файлах контроллера. Она позволяет переопределить основные операции JavaScript контроллера.

Если это определено, SCS.preInitRendering должна быть функцией. Она вызывается без каких-либо аргументов, и возвращаемое значение не ожидается и не обрабатывается.

SCS.getDeviceInfo

Функция SCS.getDeviceInfo позволяет настраивать логику обнаружения устройств внутри JavaScript контроллера. Это обнаружение используется для определения необходимости доставки мобильной или оперативной версии страницы.

Функция SCS.getDeviceInfo не принимает никаких аргументов и возвращает объект JavaScript с двумя свойствами:

  • isMobile — логическое свойство, указывающее, что текущее устройство является мобильным клиентом, например смартфоном.

  • isIOS — логическое свойство, указывающее, что текущее устройство работает под управлением операционной системы на базе iOS.

Если пользовательский контроллер не переопределяет SCS.getDeviceInfo, используется встроенная реализация по умолчанию.