Руководство по отладке

Проверка схемы

Первый шаг при отладке Vega-Lite — убедиться, что спецификация корректна. Vega Editor показывает предупреждения, если ссылка $schema действительна, но спецификация не соответствует схеме указанной версии. При неожиданном поведении проверьте, что используете ту же версию библиотеки, что и редактор.

Отладка среды выполнения Vega

Спецификации Vega-Lite компилируются в Vega и выполняются средой Vega. Во время выполнения диаграмма из спецификации Vega-Lite ничем не отличается от диаграммы из скомпилированной спецификации Vega. Поэтому для отладки нужно понимать поведение среды Vega. Используйте руководство по отладке в документации Vega.

Пошаговое выполнение

При отладке Vega и Vega-Lite в браузере полезно пошагово выполнять код в инструментах разработчика Firefox, Chrome или Safari.

Vega и Vega-Lite предоставляют карты исходного кода (source maps), поэтому отлаживать можно даже минифицированные файлы JavaScript. Иногда удобнее использовать исходники без минификации: они доступны через CDN jsDelivr.

Например, для подключения таких файлов вместе с Vega-Embed загрузите следующие скрипты:

<script src="https://cdn.jsdelivr.net/npm/vega@6.2.0/build/vega.js"></script>
<script src="https://cdn.jsdelivr.net/npm/vega-lite@6.4.2/build/vega-lite.js"></script>
<script src="https://cdn.jsdelivr.net/npm/vega-embed@7.1.0/build/vega-embed.js"></script>

Вывод предупреждений

Vega Editor автоматически собирает и показывает сообщения. Если вы отлаживаете собственное приложение и замечаете странное поведение, проверьте сообщения Vega-Lite.