QWebEngineProfile Class

Documentation des fonctions membres

[explicit] QWebEngineProfile::QWebEngineProfile(QObject *parent = nullptr)

Construit un nouveau profil non enregistré avec le parent parent.

Un profil "off-the-record" ne laisse aucun enregistrement sur la machine locale et n'a pas de données persistantes ni de cache. Ainsi, le cache HTTP ne peut être qu'en mémoire et les cookies ne peuvent être que non persistants. Essayer de modifier ces paramètres n'aura aucun effet.

Voir également isOffTheRecord().

[explicit] QWebEngineProfile::QWebEngineProfile(const QString &storageName, QObject *parent = nullptr)

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

Le nom de stockage doit être unique.

Un QWebEngineProfile basé sur le disque doit être détruit avant ou à 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.

Voir également storageName().

[since 6.10] QList<QSslCertificate> QWebEngineProfile::additionalTrustedCertificates() const

Renvoie des certificats de confiance supplémentaires dans la base de données des certificats de l'autorité de certification de ce profil.

Cette fonction a été introduite dans Qt 6.10.

Voir aussi QWebEngineProfileBuilder::setAdditionalTrustedCertificates().

QString QWebEngineProfile::cachePath() const

Renvoie le chemin utilisé pour les caches.

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

Voir aussi setCachePath(), storageName(), et QStandardPaths::writableLocation().

void QWebEngineProfile::clearAllVisitedLinks()

Efface tous les liens de la base de données des liens visités.

Voir aussi clearVisitedLinks().

void QWebEngineProfile::clearHttpCache()

Supprime les entrées du cache du profil.

Voir aussi QWebEngineProfile::clearHttpCacheCompleted().

[signal, since 6.7] void QWebEngineProfile::clearHttpCacheCompleted()

Ce signal est émis lorsque l'opération clearHttpCache() est terminée.

Cette fonction a été introduite dans Qt 6.7.

Voir aussi QWebEngineProfile::clearHttpCache().

void QWebEngineProfile::clearVisitedLinks(const QList<QUrl> &urls)

Efface les liens de urls de la base de données des liens visités.

Voir aussi clearAllVisitedLinks().

QWebEngineClientCertificateStore *QWebEngineProfile::clientCertificateStore()

Renvoie le magasin de certificats du client du profil.

[since 6.8] QWebEngineClientHints *QWebEngineProfile::clientHints() const

Renvoie les paramètres des conseils du client associés à ce contexte de navigation.

Cette fonction a été introduite dans Qt 6.8.

Voir aussi QWebEngineClientHints.

QWebEngineCookieStore *QWebEngineProfile::cookieStore()

Renvoie le magasin de cookies pour ce profil.

[static] QWebEngineProfile *QWebEngineProfile::defaultProfile()

Renvoie le profil par défaut.

Le profil par défaut est "off-the-record".

Voir aussi storageName().

QString QWebEngineProfile::downloadPath() const

Chemin d'accès à l'emplacement où sont stockés les fichiers téléchargés.

Voir également setDownloadPath() et QStandardPaths::writableLocation().

[signal] void QWebEngineProfile::downloadRequested(QWebEngineDownloadRequest *download)

Ce signal est émis lorsqu'un téléchargement a été déclenché. L'argument download contient l'état du téléchargement. Le téléchargement doit être explicitement accepté avec QWebEngineDownloadRequest::accept() ou il sera annulé par défaut. L'élément de téléchargement est rattaché au profil. S'il n'est pas accepté, il sera supprimé immédiatement après l'émission du signal. Ce signal ne peut pas être utilisé avec une connexion en file d'attente.

Voir également QWebEngineDownloadRequest et QWebEnginePage::download().

[since 6.10] QWebEngineExtensionManager *QWebEngineProfile::extensionManager() const

Renvoie le gestionnaire d'extension associé à ce contexte de navigation.

Cette fonction a été introduite dans Qt 6.10.

Voir aussi QWebEngineExtensionManager.

QString QWebEngineProfile::httpAcceptLanguage() const

Renvoie la valeur du champ Accept-Language de l'en-tête de requête HTTP.

Voir aussi setHttpAcceptLanguage().

int QWebEngineProfile::httpCacheMaximumSize() const

Renvoie la taille maximale du cache HTTP en octets.

Renverra 0 si la taille est automatiquement contrôlée par QtWebEngine.

Voir aussi setHttpCacheMaximumSize() et httpCacheType().

QWebEngineProfile::HttpCacheType QWebEngineProfile::httpCacheType() const

Renvoie le type de cache HTTP utilisé.

Si le profil n'est pas enregistré, MemoryHttpCache est renvoyé.

Voir aussi setHttpCacheType() et cachePath().

QString QWebEngineProfile::httpUserAgent() const

Renvoie la chaîne du user-agent envoyée avec HTTP pour identifier le navigateur.

Voir également setHttpUserAgent() et Windows Application Manifest.

void QWebEngineProfile::installUrlSchemeHandler(const QByteArray &scheme, QWebEngineUrlSchemeHandler *handler)

Enregistre un gestionnaire handler pour le schéma d'URL personnalisé scheme dans le profil.

Il est nécessaire d'enregistrer d'abord le schéma avec QWebEngineUrlScheme::registerScheme au démarrage de l'application.

bool QWebEngineProfile::isOffTheRecord() const

Renvoie true s'il s'agit d'un profil "off-the-record" qui ne laisse aucune trace sur l'ordinateur.

Cela obligera les cookies et le cache HTTP à être en mémoire, mais aussi toutes les autres données normalement persistantes à être stockées en mémoire.

[since 6.5] bool QWebEngineProfile::isPushServiceEnabled() const

Renvoie true si le service de messagerie push est activé.

Cette fonction a été introduite dans Qt 6.5.

Voir aussi setPushServiceEnabled().

bool QWebEngineProfile::isSpellCheckEnabled() const

Renvoie true si le correcteur orthographique est activé ; sinon, il renvoie false.

Voir aussi setSpellCheckEnabled().

[since 6.8] QList<QWebEnginePermission> QWebEngineProfile::listAllPermissions() const

Renvoie un QList d'objets QWebEnginePermission, chacun représentant une seule autorisation actuellement présente dans la base de données des autorisations. La liste renvoyée contient toutes les autorisations précédemment accordées/refusées pour ce profil, à condition qu'elles soient de type persistant.

Cette fonction a été introduite dans Qt 6.8.

Voir aussi queryPermission(), QWebEnginePermission::PermissionType, et QWebEnginePermission::isPersistent().

[since 6.8] QList<QWebEnginePermission> QWebEngineProfile::listPermissionsForOrigin(const QUrl &securityOrigin) const

Renvoie un QList d'objets QWebEnginePermission, chacun représentant une seule autorisation actuellement présente dans le magasin des autorisations. La liste renvoyée contient toutes les autorisations précédemment accordées/refusées associées à un securityOrigin spécifique pour ce profil, à condition qu'elles soient d'un type persistant.

Cette fonction a été introduite dans Qt 6.8.

Voir aussi queryPermission(), QWebEnginePermission::PermissionType, et QWebEnginePermission::isPersistent().

[since 6.8] QList<QWebEnginePermission> QWebEngineProfile::listPermissionsForPermissionType(QWebEnginePermission::PermissionType permissionType) const

Renvoie un QList d'objets QWebEnginePermission, chacun représentant une seule autorisation actuellement présente dans le registre des autorisations. La liste renvoyée contient toutes les autorisations précédemment accordées/refusées pour l'objet permissionType fourni. Si le type de permission est non persistant, la liste sera vide.

Cette fonction a été introduite dans Qt 6.8.

Voir aussi queryPermission(), QWebEnginePermission::PermissionType, et QWebEnginePermission::isPersistent().

QWebEngineProfile::PersistentCookiesPolicy QWebEngineProfile::persistentCookiesPolicy() const

Renvoie la politique actuelle en matière de cookies persistants.

Si le profil n'est pas enregistré, NoPersistentCookies est renvoyé.

Voir aussi setPersistentCookiesPolicy().

[since 6.8] QWebEngineProfile::PersistentPermissionsPolicy QWebEngineProfile::persistentPermissionsPolicy() const

Renvoie la politique actuelle en matière d'autorisations persistantes.

Les profils non enregistrés ne sont pas autorisés à enregistrer des données sur le disque, ils ne peuvent donc renvoyer que StoreInMemory ou AskEveryTime.

Cette fonction a été introduite dans Qt 6.8.

Voir aussi QWebEngineProfile::PersistentPermissionsPolicy et setPersistentPermissionsPolicy().

QString QWebEngineProfile::persistentStoragePath() const

Renvoie le chemin utilisé pour stocker 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, ce chemin se trouve sous QStandardPaths::DataLocation dans un sous-répertoire spécifique à QtWebengine/StorageName.

Voir également setPersistentStoragePath(), storageName() et QStandardPaths::writableLocation().

[since 6.8] QWebEnginePermission QWebEngineProfile::queryPermission(const QUrl &securityOrigin, QWebEnginePermission::PermissionType permissionType) const

Renvoie un objet QWebEnginePermission correspondant à une seule autorisation pour les sites securityOrigin et permissionType fournis. L'objet peut être utilisé pour demander l'état actuel de la permission ou pour la modifier. Il n'est pas nécessaire qu'une autorisation existe déjà ; l'objet retourné peut également être utilisé pour pré-accorder une autorisation si un site web est connu pour l'utiliser.

Vous pouvez utiliser cet objet pour pré-attribuer une autorisation d'un type non persistant. Ce faisant, la permission restera dans l'état accordé (ou refusé) jusqu'à la prochaine demande d'un site web ayant l'origine associée. À ce moment-là, la durée de vie de la permission sera liée à la durée de vie de cette page web spécifique, et le fait de naviguer ailleurs invalidera la permission.

Cette fonction a été introduite dans Qt 6.8.

Voir aussi listAllPermissions(), listPermissionsForOrigin(), listPermissionsForPermissionType(), et QWebEnginePermission::PermissionType.

void QWebEngineProfile::removeAllUrlSchemeHandlers()

Supprime tous les gestionnaires d'URL personnalisés installés dans le profil.

void QWebEngineProfile::removeUrlScheme(const QByteArray &scheme)

Supprime le schéma d'URL personnalisé scheme du profil.

Voir aussi removeUrlSchemeHandler().

void QWebEngineProfile::removeUrlSchemeHandler(QWebEngineUrlSchemeHandler *handler)

Supprime le gestionnaire d'URL personnalisé handler du profil.

Voir aussi removeUrlScheme().

[since 6.2] void QWebEngineProfile::requestIconForIconURL(const QUrl &url, int desiredSizeInPixel, std::function<void (const QIcon &, const QUrl &)> iconAvailableCallback) const

Demande à la base de données une icône avec l'adresse url spécifiée. Chaque profil possède sa propre base de données d'icônes, qui est stockée dans la mémoire permanente. Les icônes stockées sont donc accessibles sans connexion réseau. L'icône doit avoir été chargée au préalable pour être stockée dans la base de données.

url spécifie l'URL de l'icône. Si plusieurs icônes sont disponibles, celle dont la taille est la plus proche de desiredSizeInPixel sera renvoyée. L'icône résultante est redimensionnée à desiredSizeInPixel. Si desiredSizeInPixel vaut 0, la plus grande icône disponible est renvoyée.

Cette fonction est asynchrone et le résultat est renvoyé par iconAvailableCallback. Le rappel est appelé si une demande d'icône est effectuée. Si l'icône demandée est disponible, le premier paramètre (de type QIcon) est le résultat. Dans le cas contraire, il est nul.

Le deuxième paramètre contient l'URL de l'icône demandée. Il est vide si l'icône ne peut pas être récupérée.

Cette fonction a été introduite dans Qt 6.2.

Voir aussi requestIconForPageURL().

[since 6.2] void QWebEngineProfile::requestIconForPageURL(const QUrl &url, int desiredSizeInPixel, std::function<void (const QIcon &, const QUrl &, const QUrl &)> iconAvailableCallback) const

Demande à la base de données une icône pour une page précédemment chargée avec ce profil. Chaque profil possède sa propre base de données d'icônes, qui est stockée dans la mémoire permanente. Les icônes stockées sont donc également accessibles sans connexion réseau. L'icône doit avoir été chargée précédemment pour être stockée dans la base de données.

url spécifie l'URL de la page pour laquelle l'icône est demandée. Si plusieurs icônes sont disponibles, celle dont la taille est la plus proche de desiredSizeInPixel sera renvoyée. L'icône résultante est redimensionnée à desiredSizeInPixel. Si desiredSizeInPixel vaut 0, la plus grande icône disponible est renvoyée.

Cette fonction est asynchrone et le résultat est renvoyé par iconAvailableCallback. Le rappel est appelé si une demande d'icône est effectuée. Si l'icône demandée est disponible, le premier paramètre (de type QIcon) est le résultat. Dans le cas contraire, il est nul.

Le deuxième paramètre contient l'URL de l'icône demandée. Il est vide si l'icône ne peut pas être récupérée.

Le troisième paramètre contient l'URL de la page à laquelle l'icône est affectée.

Cette fonction a été introduite dans Qt 6.2.

Voir aussi requestIconForIconURL().

QWebEngineScriptCollection *QWebEngineProfile::scripts() const

Renvoie la collection de scripts injectés dans toutes les pages qui partagent ce profil.

Voir aussi QWebEngineScriptCollection, QWebEngineScript, QWebEnginePage::scripts(), et Script Injection.

void QWebEngineProfile::setCachePath(const QString &path)

Remplace le chemin d'accès par défaut utilisé pour les caches de disque, en lui attribuant la valeur path.

S'il est défini sur la chaîne null, le chemin par défaut est rétabli.

Voir également cachePath().

void QWebEngineProfile::setDownloadPath(const QString &path)

Remplace le chemin d'accès par défaut utilisé pour l'emplacement du téléchargement, en lui attribuant la valeur path.

S'il s'agit d'une chaîne nulle, le chemin d'accès par défaut est rétabli.

Voir aussi downloadPath().

void QWebEngineProfile::setHttpAcceptLanguage(const QString &httpAcceptLanguage)

Définit la valeur du champ Accept-Language de l'en-tête de requête HTTP à httpAcceptLanguage.

Voir aussi httpAcceptLanguage().

void QWebEngineProfile::setHttpCacheMaximumSize(int maxSize)

Fixe la taille maximale du cache HTTP à maxSize octets.

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

Voir aussi httpCacheMaximumSize() et setHttpCacheType().

void QWebEngineProfile::setHttpCacheType(QWebEngineProfile::HttpCacheType httpCacheType)

Définit le type de cache HTTP à httpCacheType.

Voir également httpCacheType(), setCachePath() et clearHttpCache().

void QWebEngineProfile::setHttpUserAgent(const QString &userAgent)

Remplace la chaîne user-agent par défaut, en lui attribuant la valeur userAgent.

Voir aussi httpUserAgent().

void QWebEngineProfile::setNotificationPresenter(std::function<void (std::unique_ptr<QWebEngineNotification>)> notificationPresenter)

Définit la fonction notificationPresenter comme responsable de la présentation des notifications envoyées.

Voir aussi QWebEngineNotification.

void QWebEngineProfile::setPersistentCookiesPolicy(QWebEngineProfile::PersistentCookiesPolicy newPersistentCookiesPolicy)

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

Voir aussi persistentCookiesPolicy().

[since 6.8] void QWebEngineProfile::setPersistentPermissionsPolicy(QWebEngineProfile::PersistentPermissionsPolicy newPersistentPermissionsPolicy)

Définit la politique pour les permissions persistantes à newPersistentPermissionsPolicy.

Cette fonction a été introduite dans Qt 6.8.

Voir aussi QWebEngineProfile::PersistentPermissionsPolicy et persistentPermissionsPolicy().

void QWebEngineProfile::setPersistentStoragePath(const QString &path)

Remplace le chemin par défaut utilisé pour stocker les données persistantes du moteur web.

Si path est défini comme une chaîne nulle, le chemin par défaut est rétabli.

Voir également persistentStoragePath().

[since 6.5] void QWebEngineProfile::setPushServiceEnabled(bool enable)

Active le service de messagerie push si enable est true, sinon le désactive.

Cette fonction a été introduite dans Qt 6.5.

Voir aussi isPushServiceEnabled().

void QWebEngineProfile::setSpellCheckEnabled(bool enable)

Active le correcteur orthographique si enable est true, sinon le désactive.

Voir aussi isSpellCheckEnabled().

void QWebEngineProfile::setSpellCheckLanguages(const QStringList &languages)

Définit la liste actuelle de languages pour le correcteur orthographique. Chaque langue doit correspondre au nom du dictionnaire .bdic. Par exemple, la langue en-US chargera le fichier de dictionnaire en-US.bdic.

Voir la documentation sur les fonctionnalités du correcteur orthographique pour savoir comment les fichiers de dictionnaire sont recherchés.

Pour plus d'informations sur la compilation des dictionnaires .bdic, voir l'exemple de Spellchecker.

Voir aussi spellCheckLanguages().

void QWebEngineProfile::setUrlRequestInterceptor(QWebEngineUrlRequestInterceptor *interceptor)

Enregistre un singleton d'intercepteur de requêtes interceptor pour intercepter les requêtes URL.

Le profil ne prend pas possession du pointeur.

Voir aussi QWebEngineUrlRequestInfo et QWebEngineUrlRequestInterceptor.

QWebEngineSettings *QWebEngineProfile::settings() const

Renvoie les paramètres par défaut pour toutes les pages de ce profil.

QStringList QWebEngineProfile::spellCheckLanguages() const

Renvoie la liste des langues utilisées par le correcteur orthographique.

Voir aussi setSpellCheckLanguages().

QString QWebEngineProfile::storageName() const

Renvoie le nom de stockage du profil.

Le nom du stockage est utilisé pour donner à chaque profil qui utilise le disque des sous-répertoires distincts pour les données persistantes et le cache.

const QWebEngineUrlSchemeHandler *QWebEngineProfile::urlSchemeHandler(const QByteArray &scheme) const

Renvoie le registre du gestionnaire de schéma d'URL personnalisé pour le schéma d'URL scheme.

bool QWebEngineProfile::visitedLinksContainsUrl(const QUrl &url) const

Renvoie true si url est considéré comme un lien visité par ce profil.