Sur cette page

QWebEngineProfileBuilder Class

La classe QWebEngineProfileBuilder permet de construire QWebEngineProfile. Plus...

En-tête : #include <QWebEngineProfileBuilder>
CMake : find_package(Qt6 REQUIRED COMPONENTS WebEngineCore)
target_link_libraries(mytarget PRIVATE Qt6::WebEngineCore)
qmake : QT += webenginecore
Depuis : Qt 6.9

Fonctions publiques

QWebEngineProfile *createProfile(const QString &storageName, QObject *parent = nullptr) const
(since 6.10) QWebEngineProfileBuilder &setAdditionalTrustedCertificates(const QList<QSslCertificate> &certificates)
QWebEngineProfileBuilder &setCachePath(const QString &path)
QWebEngineProfileBuilder &setHttpCacheMaximumSize(int maxSizeInBytes)
QWebEngineProfileBuilder &setHttpCacheType(QWebEngineProfile::HttpCacheType httpCacheType)
QWebEngineProfileBuilder &setPersistentCookiesPolicy(QWebEngineProfile::PersistentCookiesPolicy persistentCookiePolicy)
QWebEngineProfileBuilder &setPersistentPermissionsPolicy(QWebEngineProfile::PersistentPermissionsPolicy persistentPermissionPolicy)
QWebEngineProfileBuilder &setPersistentStoragePath(const QString &path)

Membres publics statiques

QWebEngineProfile *createOffTheRecordProfile(QObject *parent = nullptr)

Description détaillée

Une page QWebEngineProfileBuilder crée une instance de la classe QWebEngineProfile. Certaines propriétés du profil doivent être initialisées en un seul appel et ne doivent pas être modifiées pendant la durée de vie du profil. Le constructeur de profil du moteur web s'en occupe simplement.

Documentation des fonctions membres

[static] QWebEngineProfile *QWebEngineProfileBuilder::createOffTheRecordProfile(QObject *parent = nullptr)

Crée un profil hors enregistrement avec l'objet parent parent qui ne laisse aucun enregistrement sur la machine locale et n'a pas de données persistantes ou de cache. Cela forcera les cookies, les données persistantes et le cache HTTP à être stockés en mémoire.

QWebEngineProfile *QWebEngineProfileBuilder::createProfile(const QString &storageName, QObject *parent = nullptr) const

Construit un profil avec le nom de stockage storageName et le parent parent.

Le nom de stockage est utilisé pour donner à chaque profil sur disque un sous-répertoire distinct pour les données persistantes et le cache. L'emplacement de stockage doit être unique pendant toute la durée de vie de l'application. Il appartient à l'utilisateur d'empêcher la création de profils ayant le même emplacement de stockage, ce qui peut entraîner la corruption du cache du navigateur.

Un profil sur disque QWebEngineProfile doit être détruit avant la sortie de l'application, sinon le cache et les données persistantes risquent de ne pas être entièrement vidés sur le disque.

Remarque : lors de la création d'un profil sur disque, si le chemin de données est déjà utilisé par un autre profil, la fonction renvoie un pointeur nul.

Voir aussi QWebEngineProfile::storageName().

[since 6.10] QWebEngineProfileBuilder &QWebEngineProfileBuilder::setAdditionalTrustedCertificates(const QList<QSslCertificate> &certificates)

Définit des certificats supplémentaires pour la base de données de certificats CA de ce profil à certificates.

Cette fonction a été introduite dans Qt 6.10.

QWebEngineProfileBuilder &QWebEngineProfileBuilder::setCachePath(const QString &path)

Définit le chemin utilisé pour le cache à path.

Par défaut, ce chemin se trouve sous StandardPaths::CacheLocation dans un sous-répertoire spécifique à QtWebengine/StorageName.

Voir aussi QWebEngineProfile::cachePath() et QStandardPaths::writableLocation().

QWebEngineProfileBuilder &QWebEngineProfileBuilder::setHttpCacheMaximumSize(int maxSizeInBytes)

Fixe la taille maximale du cache HTTP à maxSizeInBytes octets.

Si vous lui donnez la valeur 0, la taille sera contrôlée automatiquement par QtWebEngine.

Voir aussi QWebEngineProfile::httpCacheMaximumSize() et setHttpCacheType().

QWebEngineProfileBuilder &QWebEngineProfileBuilder::setHttpCacheType(QWebEngineProfile::HttpCacheType httpCacheType)

Définit le type de cache HTTP à httpCacheType.

Voir aussi QWebEngineProfile::httpCacheType() et setCachePath().

QWebEngineProfileBuilder &QWebEngineProfileBuilder::setPersistentCookiesPolicy(QWebEngineProfile::PersistentCookiesPolicy persistentCookiePolicy)

Définit la politique en matière de cookies persistants à persistentCookiePolicy.

Voir aussi QWebEngineProfile::persistentCookiesPolicy().

QWebEngineProfileBuilder &QWebEngineProfileBuilder::setPersistentPermissionsPolicy(QWebEngineProfile::PersistentPermissionsPolicy persistentPermissionPolicy)

Définit la politique des permissions persistantes pour persistentPermissionPolicy.

Voir aussi QWebEngineProfile::persistentPermissionsPolicy().

QWebEngineProfileBuilder &QWebEngineProfileBuilder::setPersistentStoragePath(const QString &path)

Définit le chemin utilisé pour stocker les données persistantes du navigateur et du contenu web à path. Les données persistantes comprennent les cookies persistants, le stockage local HTML5 et les liens visités.

Par défaut, ce chemin se trouve sous QStandardPaths::DataLocation dans un sous-répertoire spécifique à QtWebengine/StorageName.

Note : Utilisez QStandardPaths::writableLocation(QStandardPaths::DataLocation) pour obtenir le chemin QStandardPaths::DataLocation.

Voir également QWebEngineProfile::persistentStoragePath() et QStandardPaths::writableLocation().

© 2026 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.