En esta página

WebEngineProfilePrototype QML Type

Crea una instancia de la clase QQuickWebEngineProfile. Más...

Import Statement: import QtWebEngine
Since: QtWebEngine 6.9

Propiedades

Métodos

Descripción detallada

WebEngineProfile contiene ajustes, scripts y la lista de enlaces visitados compartidos por todas las vistas que pertenecen al perfil. Algunas de las propiedades del perfil deben inicializarse en una llamada y no deben modificarse durante la vida del perfil. WebEngineProfilePrototype proporciona una forma de crear un perfil, cuando todas las propiedades requeridas están configuradas.

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

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

Documentación de propiedades

additionalTrustedCertificateFiles : list<string>

Una lista de rutas de certificados de confianza adicionales en la base de datos de certificados de CA de este perfil.

Los certificados se leen cuando se crea el perfil; cualquier ruta o archivo de certificado no válido se descarta. La propiedad sólo contiene las rutas que este perfil ha cargado correctamente. Esta propiedad espera que los archivos de certificado estén codificados en PEM.

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.

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 WebEngineProfilePrototype::httpCacheType.

httpCacheType : enumeration

Esta enumeración describe el tipo de caché HTTP:

ConstanteDescripción
WebEngineProfile.MemoryHttpCacheUtiliza una caché en memoria. Esta es la única opción posible si offTheRecord está activada o si no se dispone de storageName, que es la opción predeterminada.
WebEngineProfile.DiskHttpCacheUtiliza una caché de disco. Este es el valor por defecto para el perfil no offTheRecord con storageName.
WebEngineProfile.NoCacheDesactiva la caché.

persistentCookiesPolicy : enumeration

Esta enumeración describe la política de persistencia de las cookies:

ConstanteDescripción
WebEngineProfile.NoPersistentCookiesTanto las cookies de sesión como las persistentes se almacenan en memoria. Esta es la única configuración posible si offTheRecord está configurado o si no se dispone de storageName, que es el valor predeterminado.
WebEngineProfile.AllowPersistentCookiesLas 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 la recuperación en caso de fallo. Este es el valor por defecto para perfiles no off-the-record con storageName.
WebEngineProfile.OnlyPersistentCookiesLas cookies marcadas como persistentes se guardan y restauran desde el disco, mientras que las cookies de sesión nunca se almacenan en el disco, ni siquiera para la recuperación de un fallo.
WebEngineProfile.ForcePersistentCookiesTanto las cookies de sesión como las persistentes se guardan y restauran desde el disco.

persistentPermissionsPolicy : enumeration

Esta enumeración describe la política de persistencia de permisos:

ConstanteDescripción
WebEngineProfile.AskEveryTimeLa 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.StoreInMemorySó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.StoreOnDiskFunciona de la misma manera que PersistentPermissionsInMemory, pero los permisos se guardan y restauran desde el disco. Esta es la configuración por defecto.

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.

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é. El nombre de almacenamiento debe ser único.

Véase también WebEngineProfilePrototype::persistentStoragePath y WebEngineProfilePrototype::cachePath.

Documentación del método

WebEngineProfile instance()

Devuelve una instancia de WebEngineProfile.

Nota: Esta función devuelve un objeto nulo si persistentStoragePath ya está siendo utilizado por otro perfil.

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