JavaScript API

У виджета нет отдельного SDK или npm-пакета — вся программная интеграция построена на одном глобальном объекте и одном DOM-событии.

window.__cb

После инициализации виджет кладёт текущую конфигурацию и состояние согласия в window.__cb:

window.__cb.config   // текущая конфигурация баннера
window.__cb.consent  // текущее состояние согласия (появляется
                      // после того, как посетитель принял решение)

consent содержит поля necessary, preferences, statistics, marketing (булевы), а также action, timestamp, version. Учтите, что window.__cb заполняется асинхронно после загрузки конфигурации с сервера — не читайте его синхронно сразу после вставки тега скрипта, используйте событие ниже.

Блокировка собственных скриптов

Чтобы виджет не пускал сторонний трекер до согласия, пометьте его тег как инертный — браузер никогда не выполнит <script type="text/plain"> — и укажите категорию, которая должна его разблокировать:

<script
  type="text/plain"
  data-cookie-category="marketing"
  src="https://example.com/pixel.js"
></script>

Допустимые категории: preferences, statistics, marketing (necessary разблокируется всегда). Виджет отслеживает такие теги через MutationObserver, поэтому это работает и для тегов, добавленных в DOM позже — например, другим скриптом или тег-менеджером — а не только для тех, что были в HTML изначально. Механизм включается настройкой autoBlock в конфигурации баннера.

Далее

• Справочник событий — как реагировать на решение посетителя.
• Кастомизация стилей.