Каждый разработчик сталкивался с моментом, когда даже самое продуманное приложение вдруг оказывается «слишком жестким». Пользователю не хватает одной функции, тестирование требует правки логики, а ради мелкого изменения приходится пересобирать весь проект и заново проходить цикл релиза.
Эта глава аккуратно подводит к неожиданному решению: вы обнаружите, как встроенный язык сценариев может превратить C++-приложение на Qt в гибкую платформу, которую можно расширять и настраивать без перекомпиляции. Здесь раскрывается секрет, почему профессиональные разработчики все чаще отделяют «ядро» от логики расширения и как это напрямую экономит время поддержки и развития продукта.
Будет показано, как за счет метаобъектной модели Qt, нескольких макросов и встроенного движка JavaScript управлять объектами приложения, автоматизировать длительные операции и создавать гибридные решения.
Если идея расширяемого приложения без боли уже зацепила — дальше будет только интереснее.
В этой главе вы найдёте готовые к использованию примеры кода.
Самопроверка по главе
Почему слоты и свойства класса, унаследованного от QObject, автоматически становятся доступными в JavaScript без написания дополнительного кода?Ответ
Правильный ответ: Благодаря метаобъектной модели Qt и препроцессору MOC, который генерирует метаинформацию о классе, включая данные о его слотах, сигналах и свойствах, делая их видимыми для языка сценариев.
Что возвращает метод evaluate() класса QJSEngine и какие типы данных может содержать возвращаемое значение?Ответ
Правильный ответ: Метод возвращает объект QJSValue, который может содержать значения разных типов: строки, числа, булевы значения, массивы, объекты QVariant или ошибку в случае неуспешной интерпретации.
Зачем необходимо создавать класс обертки (wrapper) для обычных C++ классов, не унаследованных от QObject?Ответ
Правильный ответ: Класс обертки, унаследованный от QObject, агрегирует объект нужного класса и предоставляет делегирующие методы в виде слотов и свойств, делая функциональность исходного класса доступной для JavaScript.
Почему производительно-критичные компоненты приложения рекомендуется реализовывать на C++, а не на JavaScript?Ответ
Правильный ответ: Интерпретируемый код JavaScript выполняется значительно медленнее, чем скомпилированный код C++, поэтому критичные по производительности операции лучше реализовывать на компилируемом языке.
Для чего используется макрос Q_INVOKABLE при объявлении методов класса?Ответ
Правильный ответ: Макрос делает обычный метод класса (не слот) видимым и доступным для вызова из языка сценариев JavaScript без необходимости объявлять его как слот.
Какой модуль Qt6 используется для поддержки JavaScript и почему нельзя использовать QtScript?Ответ
Правильный ответ: В Qt6 используется модуль QtQml, так как модуль QtScript был полностью удален из библиотеки. QtQml обеспечивает современную поддержку JavaScript на основе стандарта ECMAScript 2017.
Как поддержка языка сценариев упрощает предоставление технической поддержки пользователям программы?Ответ
Правильный ответ: Можно реализовывать код устранения ошибок (workarounds) и добавлять специфические функции для конкретных пользователей прямо на месте через сценарии, не изменяя и не перекомпилируя исходный код основного приложения.
В чём преимущество использования свойств (Q_PROPERTY) вместо прямых вызовов слотов при работе со сценариями?Ответ
Правильный ответ: Свойства обеспечивают более естественный и привычный синтаксис для разработчиков на языках сценариев (например,
object.property = value вместо object.setProperty(value)), делая API более интуитивным.Как проверить, что результат выполнения сценария содержит ошибку, и получить описание этой ошибки?Ответ
Правильный ответ: Нужно вызвать метод
isError() у объекта QJSValue, возвращенного методом evaluate(), а затем получить текст ошибки методом toString().Почему невозможно получить из JavaScript-сценария доступ ко всей функциональности Qt или приложения сразу?Ответ
Правильный ответ: Потому что сценарии получают доступ только к конкретным объектам приложения, которые разработчик явно сделал доступными через newQObject() и setProperty(), что является сознательным ограничением для контроля и безопасности.
Что произойдет, если передать в метод evaluate() строку с синтаксической ошибкой JavaScript?Ответ
Правильный ответ: Метод вернет объект QJSValue, содержащий ошибку, которую можно обнаружить проверкой isError() и получить описание через toString().
Какие три основных шага необходимы для добавления поддержки JavaScript в Qt-проект?Ответ
Правильный ответ: Добавить модуль QtQml в проектный файл (QT += qml), включить заголовочный файл QJSEngine, создать объект QJSEngine и зарегистрировать нужные объекты через newQObject().
Практические задания
Простой уровень
Калькулятор через JavaScript
Создайте Qt-приложение с полем ввода (QLineEdit) для математических выражений и кнопкой “Вычислить”. При нажатии на кнопку приложение должно использовать QJSEngine для вычисления введенного выражения и отображать результат в QLabel. Обработайте случаи синтаксических ошибок.
Подсказки: Используйте QLineEdit::text() для получения выражения. Передайте строку в scriptEngine.evaluate(). Проверьте результат методом isError(). Если ошибки нет — используйте toNumber() или toString() для отображения результата в метке.
Средний уровень
Конфигурируемый виджет через свойства
Создайте класс ConfigurableWidget, унаследованный от QWidget, с несколькими свойствами (Q_PROPERTY): цвет фона (backgroundColor), размер текста (fontSize), текст (text) и видимость (visible). Реализуйте возможность загрузки конфигурации из JavaScript-файла, который устанавливает значения этих свойств. Предусмотрите слот для применения конфигурации и сигнал, уведомляющий об изменениях.
Подсказки: Объявите Q_PROPERTY для каждого свойства с READ, WRITE и NOTIFY. Создайте метод loadConfig(QString filename), который читает JS-файл и выполняет его через evaluate(). Зарегистрируйте виджет в движке через newQObject() под именем “widget”. В JS-файле используйте синтаксис: widget.backgroundColor = “#ff0000”.
Сложный уровень
Система плагинов на JavaScript с API-оберткой
Разработайте мини-систему плагинов, где основное приложение на C++ предоставляет API через класс-обертку для сторонней библиотеки (например, класса для работы со списком задач). Создайте класс TaskManager (не-Qt класс) с методами добавления, удаления и получения задач. Реализуйте класс-обертку TaskManagerWrapper, наследованный от QObject, с соответствующими слотами, сигналами и свойствами. Загружайте JavaScript-плагины из папки plugins/, каждый плагин должен иметь функцию initialize() и иметь доступ к глобальному объекту taskManager.
Подсказки: В TaskManagerWrapper агрегируйте объект TaskManager. Создайте делегирующие слоты для всех операций. Используйте QDir для сканирования папки plugins/. Для каждого .js файла создавайте отдельный QJSEngine или используйте один движок. Зарегистрируйте taskManager через scriptEngine.globalObject().setProperty(). В плагинах вызывайте taskManager.addTask(“название”) и другие методы. Обрабатывайте ошибки загрузки и выполнения плагинов.
💬 Присоединяйтесь к обсуждению!
Разобрались с интеграцией JavaScript в Qt-приложения? Появились вопросы о создании оберток или использовании метаобъектной модели?
Поделитесь своим опытом реализации систем плагинов, расскажите о сложностях, с которыми столкнулись, или помогите другим читателям освоить использование JavaScript в Qt приложениях!