QWebEngineExtensionInfo Class
The QWebEngineExtensionInfo provides information about a browser extension. More...
Header: | #include <QWebEngineExtensionInfo> |
CMake: | find_package(Qt6 REQUIRED COMPONENTS WebEngineCore) target_link_libraries(mytarget PRIVATE Qt6::WebEngineCore) |
qmake: | QT += webenginecore |
Since: | Qt 6.10 |
Properties
|
Public Functions
QUrl | actionPopupUrl() const |
QString | description() const |
QString | error() const |
QString | id() const |
bool | isEnabled() const |
bool | isInstalled() const |
bool | isLoaded() const |
QString | name() const |
QString | path() const |
Detailed Description
QWebEngineExtensionInfo provides information of an extension loaded into Qt WebEngine. Extensions can be loaded via the QWebEngineExtensionManager. You can check if the extension was successfully loaded using its isLoaded() property. The error() property contains error messages if the loading process failed. Extensions are always loaded in disabled state. To run an extension, it has to be enabled via QWebEngineExtensionManager::setExtensionEnabled().
An extension can be removed using QWebEngineExtensionManager::unloadExtension().
You can access extensions with QWebEngineExtensionManager::extensions() which provides a list of the loaded extensions, or connect to the manager's signals to be notified if the loading process is complete.
See also QWebEngineExtensionManager and QWebEngineProfile::extensionManager().
Property Documentation
[read-only]
actionPopupUrl : const QUrl
Returns the url of the extension's popup.
Extension developers usually provide a popup menu where users can control their extension. The menu can be accessed via this url.
Empty if the load failed.
Access functions:
QUrl | actionPopupUrl() const |
[read-only]
error : const QString
Errors happened during loading, installing or uninstalling the extension.
Multiple errors can happen during load time, like missing manifest, invalid file format or path. The loading process stops at the first error.
Empty if the load succeeded.
Access functions:
QString | error() const |
[read-only]
id : const QString
This property holds the id of the extension.
Generated at load time. Multiple QWebEngineExtensionInfo objects with the same id represent the same underlying extension.
The id is generated from the filesystem path where the extension was loaded from and the extensions manfiest file. Loading the same extension from the same path always have the same id.
Empty if the load failed.
Access functions:
QString | id() const |
[read-only]
isEnabled : const bool
This property holds whether the extension is enabled.
Access functions:
bool | isEnabled() const |
See also QWebEngineExtensionManager::setExtensionEnabled().
[read-only]
isLoaded : const bool
This property holds whether the extension is loaded.
If the extension was loaded or installed successfully this property returns true
. Returns false if the extension was unloaded, uninstalled or the loading process failed.
Access functions:
bool | isLoaded() const |
See also QWebEngineExtensionManager::loadExtension() and QWebEngineExtensionManager::unloadExtension().
[read-only]
name : const QString
This property holds the description of the extension.
Acquired from the extension's manifest file's description property.
Empty if the load failed.
Access functions:
QString | name() const |
[read-only]
path : const QString
This property holds the install path of the extension.
The filesystem path where the extension was loaded from.
Access functions:
QString | path() const |
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.