QWebEnginePermission Class

Descripción detallada

El patrón de uso típico es el siguiente:

1. Un sitio web solicita un permiso específico, activando la señal QWebEnginePage::permissionRequested();
2. El controlador de la señal lanza una pregunta al usuario sobre si desea conceder el permiso;
3. Cuando el usuario ha tomado su decisión, la aplicación llama a grant() o deny();

Alternativamente, una aplicación interesada en modificar permisos ya concedidos puede utilizar QWebEngineProfile::listAllPermissions() para obtener una lista de los permisos existentes asociados a un perfil, o QWebEngineProfile::queryPermission() para obtener un objeto QWebEnginePermission para un permiso específico.

La propiedad origin() puede utilizarse para consultar a qué origen está asociado el QWebEnginePermission, mientras que la propiedad permissionType() describe el tipo de permiso solicitado. El origen de un sitio web es la combinación de su esquema, nombre de host y puerto. Los permisos se conceden por origen; así, si la página web https://www.example.com:12345/some/page.html solicita un permiso, se concederá al origen https://www.example.com:12345/.

QWebEnginePermission::PermissionType describe todos los tipos de permisos que admite Qt WebEngine. Sólo algunos tipos de permisos se recuerdan entre sesiones de navegación; son persistentes. Los permisos no persistentes consultan al usuario cada vez que un sitio web los solicita. Puedes comprobar si un tipo de permiso es persistente en tiempo de ejecución utilizando el método estático QWebEnginePermission::isPersistent().

Los permisos persistentes se almacenan dentro del activo QWebEngineProfile, y su vida útil depende del valor de QWebEngineProfile::persistentPermissionsPolicy(). Por defecto, los perfiles con nombre almacenan sus permisos en disco, mientras que los que no tienen nombre los almacenan en memoria (y los destruyen cuando se destruye el perfil). Un permiso almacenado no se consultará al usuario la próxima vez que un sitio web lo solicite; en su lugar, se concederá o denegará automáticamente, dependiendo de la resolución que el usuario haya elegido inicialmente. Para borrar un permiso almacenado, llame a reset().

Un permiso no persistente, por otro lado, sólo es utilizable hasta que el QWebEnginePage relacionado realice una navegación a una URL diferente, o sea destruido.

Puedes comprobar si un QWebEnginePermission está en un estado válido utilizando su propiedad isValid(). Para los objetos no válidos, las llamadas a grant(), deny() o reset() no harán nada, mientras que las llamadas a state() siempre devolverán QWebEnginePermission::Invalid.