WebEngineProfile QML Type
Contiene configuraciones, scripts y enlaces visitados comunes a múltiples vistas del motor web. Más...
| Import Statement: | import QtWebEngine |
| Since: | QtWebEngine 1.1 |
| In C++: | QQuickWebEngineProfile |
Propiedades
- cachePath : string
- downloadPath : string
(since QtWebEngine 1.9) - httpAcceptLanguage : string
(since QtWebEngine 1.2) - httpCacheMaximumSize : int
- httpCacheType : enumeration
- httpUserAgent : string
- isPushServiceEnabled : bool
(since QtWebEngine 6.5) - offTheRecord : bool
- persistentCookiesPolicy : enumeration
- persistentPermissionsPolicy : enumeration
(since 6.8) - persistentStoragePath : string
- spellCheckEnabled : bool
(since QtWebEngine 1.4) - spellCheckLanguages : list<string>
(since QtWebEngine 1.4) - storageName : string
- userScripts : WebEngineScriptCollection
Señales
- clearHttpCacheCompleted()
(since QtWebEngine 6.7) - downloadFinished(WebEngineDownloadRequest download)
- downloadRequested(WebEngineDownloadRequest download)
- presentNotification(WebEngineNotification notification)
(since QtWebEngine 1.9)
Métodos
- void clearHttpCache()
(since QtWebEngine 1.3) - list<webEnginePermission> listAllPermissions()
(since 6.8) - list<webEnginePermission> listPermissionsForOrigin(url securityOrigin)
(since 6.8) - list<webEnginePermission> listPermissionsForPermissionType(WebEnginePermission.PermissionType permissionType)
(since 6.8) - void queryPermission(url securityOrigin, WebEnginePermission.PermissionType permissionType)
(since 6.8)
Descripción detallada
WebEngineProfile contiene configuraciones, scripts y la lista de enlaces visitados compartida por todas las vistas que pertenecen al perfil.
La información sobre los enlaces visitados se almacena junto con las cookies persistentes y otros datos persistentes en un almacenamiento determinado por la propiedad storageName. Los datos persistentes se almacenan en un subdirectorio determinado por la propiedad persistentStoragePath y la caché en un subdirectorio determinado por la propiedad cachePath. La propiedad httpCacheType describe el tipo de caché: en memoria o en disco. Si sólo se establece la propiedad storageName, los demás valores se generan automáticamente en función de ella. Si especifica alguno de los valores manualmente, debe hacerlo antes de crear cualquier página que pertenezca al perfil.
Los perfiles pueden utilizarse para aislar páginas entre sí. Un caso típico de uso es un perfil off -the-record dedicado para un modo de navegación privada. Un perfil "off-the-record" obliga a que las cookies, la caché HTTP y otros datos normalmente persistentes se almacenen sólo en memoria. La propiedad offTheRecord indica si un perfil es "off-the-record".
Cada vista del motor web tiene un perfil asociado. Las vistas que no tienen un perfil específico comparten uno común, que es off-the-record por defecto.
Nota: Se recomienda utilizar la nueva WebEngineProfilePrototype para la creación de perfiles a partir de la versión 6.9.
Documentación de propiedades
cachePath : string
La ruta a la ubicación donde se almacenan las cachés del perfil, en particular la caché HTTP.
Por defecto, las cachés se almacenan debajo de QStandardPaths::writableLocation(QStandardPaths::CacheLocation) en un directorio cuyo nombre utiliza storageName.
downloadPath : string [since QtWebEngine 1.9]
La ruta a la ubicación donde se almacenan los archivos descargados.
Anula la ruta predeterminada utilizada para la ubicación de descarga.
Si se establece en una cadena vacía, se restaura la ruta por defecto.
Nota: Por defecto, la ruta de descarga es QStandardPaths::DownloadLocation.
Esta propiedad se introdujo en QtWebEngine 1.9.
httpAcceptLanguage : string [since QtWebEngine 1.2]
El valor del campo Accept-Language HTTP request-header.
Esta propiedad se introdujo en QtWebEngine 1.2.
httpCacheMaximumSize : int
El tamaño máximo de la caché HTTP. Si 0, el tamaño será controlado automáticamente por QtWebEngine. El valor por defecto es 0.
Véase también httpCacheType.
httpCacheType : enumeration
Esta enumeración describe el tipo de caché HTTP:
| Constante | Descripción |
|---|---|
WebEngineProfile.MemoryHttpCache | Utiliza una caché en memoria. Esta es la única configuración posible si offTheRecord está configurado o no hay storageName disponible, que es el valor predeterminado. |
WebEngineProfile.DiskHttpCache | Utiliza una caché de disco. Este es el valor por defecto para el perfil no off-the-record con storageName. |
WebEngineProfile.NoCache | Desactiva la caché. (Añadido en 5.7) |
httpUserAgent : string
La cadena de agente de usuario enviada con HTTP para identificar el navegador.
Nota: En Windows 8.1 y versiones posteriores, el agente de usuario predeterminado siempre indicará "Windows NT 6.2" (Windows 8), a menos que la aplicación contenga un manifiesto que declare como compatibles versiones de Windows más recientes.
isPushServiceEnabled : bool [since QtWebEngine 6.5]
Si el servicio de mensajería push está activado.
Nota: Por defecto el servicio de mensajería push está deshabilitado.
Nota: Qt WebEngine utiliza Firebase Cloud Messaging (FCM) como servicio push del navegador. Por lo tanto, todos los mensajes push pasarán por el servicio push de Google y sus respectivos servidores.
Esta propiedad se introdujo en QtWebEngine 6.5.
offTheRecord : bool
Si el perfil del motor web es off-the-record. Un perfil off-the-record obliga a que las cookies, la caché HTTP y otros datos normalmente persistentes se almacenen sólo en memoria. El perfil es off-the-record por defecto.
Para cambiar un perfil de comportamiento off-the-record a comportamiento basado en disco también es necesario configurar un storageName adecuado.
Véase también storageName.
persistentCookiesPolicy : enumeration
Esta enumeración describe la política de persistencia de las cookies:
| Constante | Descripción |
|---|---|
WebEngineProfile.NoPersistentCookies | Tanto las cookies de sesión como las persistentes se almacenan en memoria. Esta es la única configuración posible si offTheRecord está configurado o no storageName está disponible, que es el valor predeterminado. |
WebEngineProfile.AllowPersistentCookies | Las cookies marcadas como persistentes se guardan en el disco y se restauran desde él, mientras que las cookies de sesión sólo se guardan en el disco para recuperarlas en caso de fallo. Este es el valor por defecto para el perfil no off-the-record con storageName. |
WebEngineProfile.OnlyPersistentCookies | Las cookies marcadas como persistentes se guardan y se restauran desde el disco, mientras que las cookies de sesión nunca se guardan en el disco, ni siquiera para la recuperación de fallos. |
WebEngineProfile.ForcePersistentCookies | Tanto las cookies de sesión como las persistentes se guardan y restauran desde el disco. |
persistentPermissionsPolicy : enumeration [since 6.8]
Esta enumeración describe la política de persistencia de permisos:
| Constante | Descripción |
|---|---|
WebEngineProfile.AskEveryTime | La aplicación pedirá permisos cada vez que los necesite, independientemente de si se han concedido antes o no. Esto está pensado para la compatibilidad hacia atrás con las aplicaciones existentes, y por lo demás no se recomienda. |
WebEngineProfile.StoreInMemory | Sólo se realizará una solicitud la primera vez que se necesite un permiso. Cualquier solicitud posterior se concederá o denegará automáticamente, dependiendo de la elección inicial del usuario. Esto se aplica a todas las páginas que utilicen la misma instancia QWebEngineProfile, hasta que se cierre la aplicación. Esta es la configuración que se aplica si off-the-record está configurado o no hay ninguna ruta de datos persistente disponible. |
WebEngineProfile.StoreOnDisk | Funciona de la misma manera que PersistentPermissionsInMemory, pero los permisos se guardan y restauran desde el disco. Esta es la configuración por defecto. |
Esta propiedad se introdujo en Qt 6.8.
persistentStoragePath : string
La ruta a la ubicación donde se almacenan los datos persistentes para el navegador y el contenido web. Los datos persistentes incluyen cookies persistentes, almacenamiento local HTML5 y enlaces visitados.
De forma predeterminada, el almacenamiento se encuentra debajo de QStandardPaths::writableLocation(QStandardPaths::AppDataLocation) en un directorio denominado mediante storageName.
spellCheckEnabled : bool [since QtWebEngine 1.4]
Esta propiedad indica si el corrector ortográfico del motor web está habilitado.
Esta propiedad se introdujo en QtWebEngine 1.4.
spellCheckLanguages : list<string> [since QtWebEngine 1.4]
Esta propiedad contiene la lista de idiomas utilizados por el corrector ortográfico. Cada idioma debe coincidir con el nombre del diccionario .bdic. Por ejemplo, el idioma en-US cargará el archivo del diccionario en-US.bdic.
Consulte la documentación de la función Corrector ortográfico para saber cómo se buscan los archivos de diccionario.
Para obtener más información sobre cómo compilar diccionarios .bdic, consulte el Ejemplo del corrector ortográfico.
Esta propiedad se introdujo en QtWebEngine 1.4.
storageName : string
El nombre de almacenamiento que se utiliza para crear subdirectorios separados para cada perfil que utiliza el disco para almacenar datos persistentes y caché.
Véase también WebEngineProfile::persistentStoragePath y WebEngineProfile::cachePath.
userScripts : WebEngineScriptCollection [read-only]
La colección de objetos WebEngineScript que se inyectan en todas las páginas que comparten este perfil.
Documentación sobre señales
[since QtWebEngine 6.7] clearHttpCacheCompleted()
Esta señal se emite cuando finaliza la operación clearHttpCache().
Nota: El manejador correspondiente es onClearHttpCacheCompleted.
Esta señal se introdujo en QtWebEngine 6.7.
Véase también clearHttpCache().
downloadFinished(WebEngineDownloadRequest download)
Esta señal se emite siempre que se detiene la descarga, ya sea porque ha finalizado correctamente, porque se ha cancelado o porque se ha interrumpido (por ejemplo, porque se ha perdido la conectividad). El argumento download contiene el estado de la instancia de descarga finalizada.
Nota: El manejador correspondiente es onDownloadFinished.
downloadRequested(WebEngineDownloadRequest download)
Esta señal se emite cada vez que se activa una descarga. El argumento download contiene el estado de la descarga. La descarga debe aceptarse explícitamente con WebEngineDownloadRequest::accept() o se cancelará por defecto.
Nota: El manejador correspondiente es onDownloadRequested.
[since QtWebEngine 1.9] presentNotification(WebEngineNotification notification)
Esta señal se emite cada vez que hay una notificación de usuario recién creada. El argumento notification contiene la instancia WebEngineNotification para consultar datos e interactuar con ella.
Nota: El manejador correspondiente es onPresentNotification.
Esta señal se introdujo en QtWebEngine 1.9.
Documentación del método
[since QtWebEngine 1.3] void clearHttpCache()
Elimina las entradas de caché del perfil.
Nota: Asegúrese de no iniciar una nueva navegación o cualquier operación en el perfil mientras la operación de borrado esté en curso. La señal clearHttpCacheCompleted() notifica la finalización.
Este método se introdujo en QtWebEngine 1.3.
Véase también WebEngineProfile::cachePath y clearHttpCacheCompleted().
[since 6.8] list<webEnginePermission> listAllPermissions()
Devuelve un list de objetos webEnginePermission, cada uno de los cuales representa un único permiso actualmente presente en el almacén de permisos. La lista devuelta contiene todos los permisos concedidos/denegados previamente para este perfil, siempre que sean de tipo persistente.
Nota: Si la propiedad persistentPermissionPolicy es AskEveryTime, devolverá una lista vacía.
Este método se introdujo en Qt 6.8.
Véase también queryPermission(), listPermissionsForOrigin(), listPermissionsForPermissionType(), y webEnginePermission::isPersistent().
[since 6.8] list<webEnginePermission> listPermissionsForOrigin(url securityOrigin)
Devuelve un list de objetos webEnginePermission, cada uno de los cuales representa un único permiso actualmente presente en el almacén de permisos. La lista devuelta contiene todos los permisos concedidos/denegados previamente asociados con un securityOrigin específico para este perfil, siempre que sean de tipo persistente.
Nota: Dado que los permisos se conceden en función del origen, el securityOrigin proporcionado se reducirá a su forma de origen, y la lista devuelta contendrá todos los permisos para el origen. Por lo tanto, pasar https://www.example.com/some/page.html es lo mismo que pasar sólo https://www.example.com/.
Nota: Cuando persistentPermissionPolicy() se establece en AskEveryTime, devolverá una lista vacía.
Este método se introdujo en Qt 6.8.
Ver también queryPermission(), listAllPermissions(), listPermissionsForPermissionType(), y webEnginePermission::isPersistent().
[since 6.8] list<webEnginePermission> listPermissionsForPermissionType(WebEnginePermission.PermissionType permissionType)
Devuelve un list de objetos webEnginePermission, cada uno de los cuales representa un único permiso actualmente presente en el almacén de permisos. La lista devuelta contiene todos los permisos previamente concedidos/denegados del permissionType proporcionado. Si el permissionType es no persistente, la lista estará vacía.
Nota: Cuando persistentPermissionPolicy() se establece en AskEveryTime, devolverá una lista vacía.
Este método se introdujo en Qt 6.8.
Véase también queryPermission(), listAllPermissions(), listPermissionsForOrigin(), y webEnginePermission::isPersistent().
[since 6.8] void queryPermission(url securityOrigin, WebEnginePermission.PermissionType permissionType)
Devuelve un objeto webEnginePermission correspondiente a un único permiso para los datos proporcionados securityOrigin y permissionType. El objeto puede utilizarse para consultar el estado actual del permiso o para modificarlo. No es necesario que un permiso ya exista; el objeto devuelto también puede utilizarse para preconceder un permiso si se sabe que un sitio web lo utiliza.
Nota: Sólo puede utilizarse para tipos de permisos persistentes. Llamarlo con un permissionType no persistente devolverá un objeto inválido.
Este método se introdujo en Qt 6.8.
Véase también listAllPermissions(), listPermissionsForOrigin(), y listPermissionsForPermissionType().
© 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.
