Sur cette page

WebEngineProfilePrototype QML Type

Crée une instance de la classe QQuickWebEngineProfile. Plus d'informations...

Import Statement: import QtWebEngine
Since: QtWebEngine 6.9

Propriétés

Méthodes

Description détaillée

WebEngineProfile contient des paramètres, des scripts et la liste des liens visités partagés par toutes les vues qui appartiennent au profil. 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. WebEngineProfilePrototype permet de créer un profil lorsque toutes les propriétés requises sont définies.

// creating OTR profile
WebEngineProfilePrototype: {
    id: otrProfile
}
let otrProfile = otrProfile.instance();

// creating non-OTR profile
WebEngineProfilePrototype: {
    id: nonOtrProfile
    storageName: 'Test'
}
let profile = nonOtrProfile.instance();

Documentation sur les propriétés

additionalTrustedCertificateFiles : list<string>

Une liste de chemins d'accès à des certificats de confiance supplémentaires dans la base de données des certificats de l'autorité de certification de ce profil.

Les certificats sont lus lors de la création du profil ; tout chemin ou fichier de certificat non valide est rejeté. La propriété ne contient que les chemins qui ont été chargés avec succès par ce profil. Cette propriété s'attend à ce que les fichiers de certificats soient codés en PEM.

cachePath : string

Le chemin vers l'emplacement où sont stockés les caches du profil, en particulier le cache HTTP.

Par défaut, les caches sont stockés sous QStandardPaths::writableLocation(QStandardPaths::CacheLocation) dans un répertoire nommé using storageName.

httpCacheMaximumSize : int

La taille maximale du cache HTTP. Si 0, la taille sera contrôlée automatiquement par QtWebEngine. La valeur par défaut est 0.

Voir également WebEngineProfilePrototype::httpCacheType.

httpCacheType : enumeration

Cette énumération décrit le type de cache HTTP :

ConstanteDescription
WebEngineProfile.MemoryHttpCacheUtilise un cache en mémoire. C'est le seul paramètre possible si offTheRecord est défini ou si aucune adresse storageName n'est disponible, ce qui est la valeur par défaut.
WebEngineProfile.DiskHttpCacheUtilise un cache sur disque. C'est la valeur par défaut pour les profils non off-the-record avec storageName.
WebEngineProfile.NoCacheDésactive la mise en cache.

persistentCookiesPolicy : enumeration

Cette énumération décrit la politique de persistance des cookies :

ConstanteDescription
WebEngineProfile.NoPersistentCookiesLes cookies de session et les cookies persistants sont stockés en mémoire. C'est le seul paramètre possible si offTheRecord est défini ou si aucune adresse storageName n'est disponible, ce qui est la valeur par défaut.
WebEngineProfile.AllowPersistentCookiesLes cookies persistants sont enregistrés sur le disque et restaurés à partir de celui-ci, tandis que les cookies de session ne sont stockés sur le disque qu'à des fins de récupération en cas de panne. C'est la valeur par défaut pour un profil non off-the-record avec storageName.
WebEngineProfile.OnlyPersistentCookiesLes cookies persistants sont enregistrés et restaurés à partir du disque, tandis que les cookies de session ne sont jamais enregistrés sur le disque, même en cas de récupération après une panne.
WebEngineProfile.ForcePersistentCookiesLes cookies de session et les cookies persistants sont enregistrés et restaurés sur le disque.

persistentPermissionsPolicy : enumeration

Cette énumération décrit la politique de persistance des autorisations :

ConstanteDescription
WebEngineProfile.AskEveryTimeL'application demandera des autorisations à chaque fois qu'elles seront nécessaires, qu'elles aient été accordées auparavant ou non. Cette pratique est destinée à assurer la compatibilité ascendante avec les applications existantes et n'est pas recommandée par ailleurs.
WebEngineProfile.StoreInMemoryUne demande ne sera faite que la première fois qu'une permission est nécessaire. Toute demande ultérieure sera automatiquement accordée ou refusée, en fonction du choix initial de l'utilisateur. Ceci s'applique à toutes les pages utilisant la même instance de QWebEngineProfile, jusqu'à ce que l'application soit fermée. C'est le paramètre appliqué si off-the-record est défini ou si aucun chemin de données persistant n'est disponible.
WebEngineProfile.StoreOnDiskFonctionne de la même manière que PersistentPermissionsInMemory, mais les autorisations sont enregistrées sur le disque et restaurées à partir de celui-ci. Il s'agit du paramètre par défaut.

persistentStoragePath : string

Chemin d'accès à l'emplacement où sont stockées les données persistantes du navigateur et du contenu web. Les données persistantes comprennent les cookies persistants, le stockage local HTML5 et les liens visités.

Par défaut, le stockage est situé sous QStandardPaths::writableLocation(QStandardPaths::AppDataLocation) dans un répertoire nommé storageName.

storageName : string

Nom du stockage utilisé pour créer des sous-répertoires distincts pour chaque profil qui utilise le disque pour stocker des données persistantes et du cache. Le nom de stockage doit être unique.

Voir également WebEngineProfilePrototype::persistentStoragePath et WebEngineProfilePrototype::cachePath.

Documentation de la méthode

WebEngineProfile instance()

Renvoie une instance de WebEngineProfile.

Remarque : Cette fonction renvoie un objet nul si persistentStoragePath est déjà utilisé par un autre profil.

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