QWebEnginePermission Class

Description détaillée

Le schéma d'utilisation typique est le suivant :

1. Un site web demande une autorisation spécifique, ce qui déclenche le signal QWebEnginePage::permissionRequested() ;
2. Le gestionnaire du signal déclenche une invite demandant à l'utilisateur s'il souhaite accorder la permission ;
3. Lorsque l'utilisateur a pris sa décision, l'application appelle grant() ou deny() ;

Une application souhaitant modifier des autorisations déjà accordées peut également utiliser QWebEngineProfile::listAllPermissions() pour obtenir une liste des autorisations existantes associées à un profil, ou QWebEngineProfile::queryPermission() pour obtenir un objet QWebEnginePermission pour une autorisation spécifique.

La propriété origin() peut être utilisée pour demander à quelle origine la QWebEnginePermission est associée, tandis que la propriété permissionType() décrit le type de la permission demandée. L'origine d'un site web est la combinaison de son schéma, de son nom d'hôte et de son port. Les autorisations sont accordées par origine ; ainsi, si la page web https://www.example.com:12345/some/page.html demande une autorisation, celle-ci sera accordée à l'origine https://www.example.com:12345/.

QWebEnginePermission::PermissionType décrit tous les types de permissions que Qt WebEngine prend en charge. Seuls certains types de permissions sont mémorisés entre les sessions de navigation ; ils sont persistants. Les autorisations non persistantes interrogent l'utilisateur chaque fois qu'un site web les demande. Vous pouvez vérifier si un type de permission est persistant au moment de l'exécution en utilisant la méthode statique QWebEnginePermission::isPersistent().

Les autorisations persistantes sont stockées dans le fichier actif QWebEngineProfile, et leur durée de vie dépend de la valeur de QWebEngineProfile::persistentPermissionsPolicy(). Par défaut, les profils nommés stockent leurs autorisations sur le disque, tandis que les profils non enregistrés les stockent en mémoire (et les détruisent lorsque le profil est détruit). Une autorisation stockée ne sera pas demandée à l'utilisateur la prochaine fois qu'un site web la sollicitera ; elle sera automatiquement accordée ou refusée, en fonction de la résolution choisie initialement par l'utilisateur. Pour effacer une autorisation stockée, appelez reset().

Une autorisation non persistante, en revanche, n'est utilisable que jusqu'à ce que le site QWebEnginePage concerné navigue vers une URL différente ou soit détruit.

Vous pouvez vérifier si une QWebEnginePermission est dans un état valide en utilisant sa propriété isValid(). Pour les objets non valides, les appels à grant(), deny() ou reset() ne donnent rien, tandis que les appels à state() renvoient toujours QWebEnginePermission::Invalid.