QWebEngineProfile Class

Documentación de las funciones miembro

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

Construye un nuevo perfil off-the-record con el padre parent.

Un perfil off-the-record no deja ningún registro en la máquina local, y no tiene datos persistentes ni caché. Por lo tanto, la caché HTTP sólo puede estar en memoria y las cookies sólo pueden ser no persistentes. Intentar cambiar esta configuración no tendrá ningún efecto.

Véase también isOffTheRecord().

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

Crea un nuevo perfil con el nombre de almacenamiento storageName y el padre parent.

El nombre del almacenamiento debe ser único.

Un QWebEngineProfile basado en disco debe ser destruido en o antes de la salida de la aplicación, de lo contrario la caché y los datos persistentes pueden no ser completamente volcados al disco.

Ver también storageName().

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

Devuelve certificados de confianza adicionales en la base de datos de certificados CA de este perfil.

Esta función se introdujo en Qt 6.10.

Véase también QWebEngineProfileBuilder::setAdditionalTrustedCertificates().

QString QWebEngineProfile::cachePath() const

Devuelve la ruta utilizada para las cachés.

Por defecto, está debajo de StandardPaths::CacheLocation en un subdirectorio específico de QtWebengine/StorageName.

Véase también setCachePath(), storageName(), y QStandardPaths::writableLocation().

void QWebEngineProfile::clearAllVisitedLinks()

Borra todos los enlaces de la base de datos de enlaces visitados.

Véase también clearVisitedLinks().

void QWebEngineProfile::clearHttpCache()

Elimina las entradas de caché del perfil.

Véase también QWebEngineProfile::clearHttpCacheCompleted().

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

Esta señal se emite cuando finaliza la operación clearHttpCache().

Esta función se introdujo en Qt 6.7.

Véase también QWebEngineProfile::clearHttpCache().

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

Borra los enlaces de urls de la base de datos de enlaces visitados.

Véase también clearAllVisitedLinks().

QWebEngineClientCertificateStore *QWebEngineProfile::clientCertificateStore()

Devuelve el almacén de certificados de cliente del perfil.

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

Devuelve la configuración de Client Hints asociada a este contexto de navegación.

Esta función se introdujo en Qt 6.8.

Véase también QWebEngineClientHints.

QWebEngineCookieStore *QWebEngineProfile::cookieStore()

Devuelve el almacén de cookies de este perfil.

[static] QWebEngineProfile *QWebEngineProfile::defaultProfile()

Devuelve el perfil por defecto.

El perfil por defecto es off-the-record.

Véase también storageName().

QString QWebEngineProfile::downloadPath() const

La ruta a la ubicación donde se almacenan los archivos descargados.

Véase también setDownloadPath() y QStandardPaths::writableLocation().

[signal] void QWebEngineProfile::downloadRequested(QWebEngineDownloadRequest *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 QWebEngineDownloadRequest::accept() o se cancelará por defecto. El elemento de descarga está relacionado con el perfil. Si no se acepta, se borrará inmediatamente después de la emisión de la señal. Esta señal no puede utilizarse con una conexión en cola.

Véase también QWebEngineDownloadRequest y QWebEnginePage::download().

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

Devuelve el gestor de extensiones asociado a este contexto de navegación.

Esta función se introdujo en Qt 6.10.

Véase también QWebEngineExtensionManager.

QString QWebEngineProfile::httpAcceptLanguage() const

Devuelve el valor del campo Accept-Language del encabezado de petición HTTP.

Véase también setHttpAcceptLanguage().

int QWebEngineProfile::httpCacheMaximumSize() const

Devuelve el tamaño máximo de la caché HTTP en bytes.

Devolverá 0 si el tamaño está controlado automáticamente por QtWebEngine.

Véase también setHttpCacheMaximumSize() y httpCacheType().

QWebEngineProfile::HttpCacheType QWebEngineProfile::httpCacheType() const

Devuelve el tipo de caché HTTP utilizado.

Si el perfil es off-the-record, se devuelve MemoryHttpCache.

Véase también setHttpCacheType() y cachePath().

QString QWebEngineProfile::httpUserAgent() const

Devuelve la cadena de agente de usuario enviada con HTTP para identificar el navegador.

Véase también setHttpUserAgent() y Windows Application Manifest.

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

Registra un gestor handler para el esquema de URL personalizado scheme en el perfil.

Es necesario registrar primero el esquema con QWebEngineUrlScheme::registerScheme al iniciar la aplicación.

bool QWebEngineProfile::isOffTheRecord() const

Devuelve true si se trata de un perfil off-the-record que no deja ningún registro en el ordenador.

Esto forzará a que las cookies y la caché HTTP estén en memoria, pero también forzará a que todos los demás datos normalmente persistentes se almacenen en memoria.

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

Devuelve true si el servicio de mensajería push está habilitado.

Esta función se introdujo en Qt 6.5.

Véase también setPushServiceEnabled().

bool QWebEngineProfile::isSpellCheckEnabled() const

Devuelve true si el corrector ortográfico está activado; en caso contrario devuelve false.

Véase también setSpellCheckEnabled().

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

Devuelve un QList de objetos QWebEnginePermission, 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.

Esta función se introdujo en Qt 6.8.

Véase también queryPermission(), QWebEnginePermission::PermissionType, y QWebEnginePermission::isPersistent().

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

Devuelve un QList de objetos QWebEnginePermission, 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.

Esta función se introdujo en Qt 6.8.

Véase también queryPermission(), QWebEnginePermission::PermissionType, y QWebEnginePermission::isPersistent().

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

Devuelve un QList de objetos QWebEnginePermission, 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.

Esta función se introdujo en Qt 6.8.

Véase también queryPermission(), QWebEnginePermission::PermissionType, y QWebEnginePermission::isPersistent().

QWebEngineProfile::PersistentCookiesPolicy QWebEngineProfile::persistentCookiesPolicy() const

Devuelve la política actual para cookies persistentes.

Si el perfil es off-the-record, se devuelve NoPersistentCookies.

Véase también setPersistentCookiesPolicy().

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

Devuelve la política actual de permisos persistentes.

Los perfiles fuera de registro no pueden guardar datos en el disco, por lo que sólo pueden devolver StoreInMemory o AskEveryTime.

Esta función se introdujo en Qt 6.8.

Véase también QWebEngineProfile::PersistentPermissionsPolicy y setPersistentPermissionsPolicy().

QString QWebEngineProfile::persistentStoragePath() const

Devuelve la ruta utilizada para almacenar datos persistentes para el navegador y el contenido web.

Los datos persistentes incluyen cookies persistentes, almacenamiento local HTML5 y enlaces visitados.

Por defecto, se encuentra debajo de QStandardPaths::DataLocation en un subdirectorio específico de QtWebengine/StorageName.

Ver también setPersistentStoragePath(), storageName(), y QStandardPaths::writableLocation().

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

Devuelve un objeto QWebEnginePermission 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 el permiso ya exista; el objeto devuelto también puede utilizarse para preconceder un permiso si se sabe que un sitio web lo utiliza.

Puede utilizarlo para preconceder un permiso de tipo no persistente. Al hacerlo, el permiso se mantendrá en estado concedido (o denegado) hasta la próxima vez que un sitio web con el origen asociado lo solicite. En ese momento, el tiempo de vida del permiso estará ligado al tiempo de vida de esa página web específica, y navegar fuera de ella invalidará el permiso.

Esta función se introdujo en Qt 6.8.

Véase también listAllPermissions(), listPermissionsForOrigin(), listPermissionsForPermissionType(), y QWebEnginePermission::PermissionType.

void QWebEngineProfile::removeAllUrlSchemeHandlers()

Elimina todos los gestores de esquemas de URL personalizados instalados en el perfil.

void QWebEngineProfile::removeUrlScheme(const QByteArray &scheme)

Elimina el esquema de URL personalizado scheme del perfil.

Véase también removeUrlSchemeHandler().

void QWebEngineProfile::removeUrlSchemeHandler(QWebEngineUrlSchemeHandler *handler)

Elimina el gestor de esquema de URL personalizado handler del perfil.

Véase también removeUrlScheme().

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

Solicita a la base de datos un icono con la dirección url especificada. Cada perfil tiene su propia base de datos de iconos y se almacena en el almacenamiento persistente, por lo que también se puede acceder a los iconos almacenados sin conexión a la red. El icono debe ser cargado previamente para ser almacenado en la base de datos.

url especifica la URL del icono. En caso de que haya más de un icono disponible, se devolverá el que tenga el tamaño más cercano a desiredSizeInPixel. El icono resultante se redimensiona a desiredSizeInPixel. Si desiredSizeInPixel es 0 se devuelve el icono más grande disponible.

Esta función es asíncrona y el resultado es devuelto por iconAvailableCallback. Si se solicita un icono, se llama a la llamada de retorno. Si el icono solicitado está disponible, el primer parámetro (con tipo QIcon) es el resultado. En caso contrario, es nulo.

El segundo parámetro almacena la URL del icono solicitado. Está vacío si el icono no puede obtenerse.

Esta función se introdujo en Qt 6.2.

Véase también requestIconForPageURL().

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

Solicita a la base de datos un icono para una página previamente cargada con este perfil. Cada perfil tiene su propia base de datos de iconos y se almacena en el almacenamiento persistente, por lo que también se puede acceder a los iconos almacenados sin conexión a la red. El icono debe haber sido cargado previamente para ser almacenado en la base de datos.

url especifica la URL de la página para la que se solicita el icono. En caso de que haya más de un icono disponible, se devolverá el que tenga el tamaño más cercano a desiredSizeInPixel. El icono resultante se redimensiona a desiredSizeInPixel. Si desiredSizeInPixel es 0 se devuelve el icono más grande disponible.

Esta función es asíncrona y el resultado es devuelto por iconAvailableCallback. Se llama a la llamada de retorno si se realiza una solicitud de un icono. Si el icono solicitado está disponible, el primer parámetro (con tipo QIcon) es el resultado. En caso contrario, es nulo.

El segundo parámetro almacena la URL del icono solicitado. Está vacío si el icono no puede obtenerse.

El tercer parámetro almacena la URL de la página a la que se asigna el icono.

Esta función se introdujo en Qt 6.2.

Véase también requestIconForIconURL().

QWebEngineScriptCollection *QWebEngineProfile::scripts() const

Devuelve la colección de scripts que se inyectan en todas las páginas que comparten este perfil.

Véase también QWebEngineScriptCollection, QWebEngineScript, QWebEnginePage::scripts(), y Script Injection.

void QWebEngineProfile::setCachePath(const QString &path)

Anula la ruta predeterminada utilizada para las cachés de disco, estableciéndola en path.

Si se establece como cadena nula, se restaura la ruta por defecto.

Véase también cachePath().

void QWebEngineProfile::setDownloadPath(const QString &path)

Anula la ruta predeterminada utilizada para la ubicación de descarga, estableciéndola en path.

Si se establece como cadena nula, se restaura la ruta por defecto.

Véase también downloadPath().

void QWebEngineProfile::setHttpAcceptLanguage(const QString &httpAcceptLanguage)

Establece el valor del campo Accept-Language HTTP request-header en httpAcceptLanguage.

Véase también httpAcceptLanguage().

void QWebEngineProfile::setHttpCacheMaximumSize(int maxSize)

Establece el tamaño máximo de la caché HTTP en maxSize bytes.

Establecerlo a 0 significa que el tamaño será controlado automáticamente por QtWebEngine.

Véase también httpCacheMaximumSize() y setHttpCacheType().

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

Establece el tipo de caché HTTP en httpCacheType.

Véase también httpCacheType(), setCachePath(), y clearHttpCache().

void QWebEngineProfile::setHttpUserAgent(const QString &userAgent)

Anula la cadena de agente de usuario por defecto, estableciéndola en userAgent.

Véase también httpUserAgent().

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

Establece la función notificationPresenter como responsable de presentar las notificaciones enviadas.

Véase también QWebEngineNotification.

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

Establece la política de cookies persistentes en newPersistentCookiesPolicy.

Véase también persistentCookiesPolicy().

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

Establece la política de permisos persistentes en newPersistentPermissionsPolicy.

Esta función fue introducida en Qt 6.8.

Véase también QWebEngineProfile::PersistentPermissionsPolicy y persistentPermissionsPolicy().

void QWebEngineProfile::setPersistentStoragePath(const QString &path)

Anula la ruta por defecto utilizada para almacenar los datos persistentes del motor web.

Si path se establece como cadena nula, se restaura la ruta predeterminada.

Véase también persistentStoragePath().

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

Habilita el servicio de mensajería push si enable es true, en caso contrario lo deshabilita.

Esta función se introdujo en Qt 6.5.

Véase también isPushServiceEnabled().

void QWebEngineProfile::setSpellCheckEnabled(bool enable)

Activa el corrector ortográfico si enable es true, en caso contrario lo desactiva.

Véase también isSpellCheckEnabled().

void QWebEngineProfile::setSpellCheckLanguages(const QStringList &languages)

Establece la lista actual de languages para el corrector ortográfico. Cada idioma debe coincidir con el nombre del diccionario .bdic. Por ejemplo, el idioma en-US cargará el archivo de 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.

Véase también spellCheckLanguages().

void QWebEngineProfile::setUrlRequestInterceptor(QWebEngineUrlRequestInterceptor *interceptor)

Registra un singleton interceptor de peticiones interceptor para interceptar peticiones URL.

El perfil no se apropia del puntero.

Véase también QWebEngineUrlRequestInfo y QWebEngineUrlRequestInterceptor.

QWebEngineSettings *QWebEngineProfile::settings() const

Devuelve la configuración por defecto para todas las páginas de este perfil.

QStringList QWebEngineProfile::spellCheckLanguages() const

Devuelve la lista de idiomas utilizados por el corrector ortográfico.

Véase también setSpellCheckLanguages().

QString QWebEngineProfile::storageName() const

Devuelve el nombre de almacenamiento del perfil.

El nombre de almacenamiento se utiliza para dar a cada perfil que utiliza el disco subdirectorios separados para datos persistentes y caché.

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

Devuelve el registro del gestor de esquema de URL personalizado para el esquema de URL scheme.

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

Devuelve true si url es considerado un enlace visitado por este perfil.