WebEngineProfile QML Type
Enthält Einstellungen, Skripte und besuchte Links, die für mehrere Web-Engine-Ansichten gelten. Mehr...
| Import Statement: | import QtWebEngine |
| Since: | QtWebEngine 1.1 |
| In C++: | QQuickWebEngineProfile |
Eigenschaften
- 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
Signale
- clearHttpCacheCompleted()
(since QtWebEngine 6.7) - downloadFinished(WebEngineDownloadRequest download)
- downloadRequested(WebEngineDownloadRequest download)
- presentNotification(WebEngineNotification notification)
(since QtWebEngine 1.9)
Methoden
- 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)
Detaillierte Beschreibung
WebEngineProfile enthält Einstellungen, Skripte und die Liste der besuchten Links, die von allen Ansichten, die zu diesem Profil gehören, gemeinsam genutzt werden.
Die Informationen über besuchte Links werden zusammen mit dauerhaften Cookies und anderen dauerhaften Daten in einem durch die Eigenschaft storageName bestimmten Speicher gespeichert. Die dauerhaften Daten werden in einem Unterverzeichnis gespeichert, das durch die Eigenschaft persistentStoragePath bestimmt wird, und der Cache in einem Unterverzeichnis, das durch die Eigenschaft cachePath bestimmt wird. Die Eigenschaft httpCacheType beschreibt den Typ des Caches: In-Memory oder On-Disk. Wenn nur die Eigenschaft storageName festgelegt ist, werden die anderen Werte automatisch auf der Grundlage dieser Eigenschaft generiert. Wenn Sie einen der Werte manuell festlegen, sollten Sie dies tun, bevor Sie Seiten erstellen, die zu dem Profil gehören.
Profile können verwendet werden, um Seiten voneinander abzugrenzen. Ein typischer Anwendungsfall ist ein spezielles Off-the-Record-Profil für einen privaten Browsing-Modus. Ein Off-the-Record-Profil erzwingt, dass Cookies, der HTTP-Cache und andere normalerweise dauerhafte Daten nur im Speicher abgelegt werden. Die Eigenschaft offTheRecord gibt an, ob ein Profil "off-the-record" ist.
Jede Web-Engine-Ansicht hat ein zugehöriges Profil. Ansichten, für die kein spezifisches Profil festgelegt wurde, haben ein gemeinsames Profil, das standardmäßig "off-the-record" ist.
Eigenschaft Dokumentation
cachePath : string |
Der Pfad zu dem Ort, an dem die Caches des Profils gespeichert werden, insbesondere der HTTP-Cache.
Standardmäßig werden die Caches unter QStandardPaths::writableLocation(QStandardPaths::CacheLocation) in einem Verzeichnis mit dem Namen storageName gespeichert.
downloadPath : string |
Der Pfad zu dem Ort, an dem die heruntergeladenen Dateien gespeichert werden.
Überschreibt den Standardpfad, der für den Download-Speicherort verwendet wird.
Wird er auf eine leere Zeichenfolge gesetzt, wird der Standardpfad wiederhergestellt.
Hinweis: Standardmäßig lautet der Download-Pfad QStandardPaths::DownloadLocation.
Diese Eigenschaft wurde in QtWebEngine 1.9 eingeführt.
httpAcceptLanguage : string |
Der Wert des HTTP-Request-Header-Feldes "Accept-Language".
Diese Eigenschaft wurde in QtWebEngine 1.2 eingeführt.
httpCacheMaximumSize : int |
Die maximale Größe des HTTP-Caches. Falls 0, wird die Größe automatisch von QtWebEngine gesteuert. Der Standardwert ist 0.
Siehe auch httpCacheType.
httpCacheType : enumeration |
Diese Aufzählung beschreibt den Typ des HTTP-Caches:
| Konstante | Beschreibung |
|---|---|
WebEngineProfile.MemoryHttpCache | Verwendet einen In-Memory-Cache. Dies ist die einzige Einstellung, die möglich ist, wenn offTheRecord gesetzt ist oder kein storageName verfügbar ist, was der Standard ist. |
WebEngineProfile.DiskHttpCache | Verwendet einen Festplatten-Cache. Dies ist der Standardwert für ein nicht-off-the-record-Profil mit storageName. |
WebEngineProfile.NoCache | Deaktiviert Caching. (Hinzugefügt in 5.7) |
httpUserAgent : string |
Der User-Agent-String, der mit HTTP gesendet wird, um den Browser zu identifizieren.
Hinweis: Unter Windows 8.1 und neuer meldet der Standard-Benutzeragent immer "Windows NT 6.2" (Windows 8), es sei denn, die Anwendung enthält ein Manifest, das neuere Windows-Versionen als unterstützt deklariert.
isPushServiceEnabled : bool |
Ob der Push-Messaging-Dienst aktiviert ist.
Hinweis: Standardmäßig ist der Push-Nachrichtendienst deaktiviert.
Hinweis: Qt WebEngine verwendet Firebase Cloud Messaging (FCM) als Browser-Push-Dienst. Daher werden alle Push-Nachrichten über den Google-Push-Dienst und seine entsprechenden Server gesendet.
Diese Eigenschaft wurde in QtWebEngine 6.5 eingeführt.
offTheRecord : bool |
Ob das Profil der Web-Engine "off-the-record" ist. Ein Off-the-Record-Profil erzwingt, dass Cookies, der HTTP-Cache und andere normalerweise dauerhafte Daten nur im Speicher abgelegt werden. Das Profil ist standardmäßig "off-the-record".
Die Änderung eines Profils von off-the-record auf ein festplattenbasiertes Verhalten erfordert ebenfalls die Einstellung eines geeigneten storageName.
Siehe auch storageName.
persistentCookiesPolicy : enumeration |
Diese Aufzählung beschreibt die Richtlinie für die Persistenz von Cookies:
| Konstante | Beschreibung |
|---|---|
WebEngineProfile.NoPersistentCookies | Sowohl Sitzungs- als auch dauerhafte Cookies werden im Speicher abgelegt. Dies ist die einzige Einstellung, die möglich ist, wenn offTheRecord gesetzt ist oder keine storageName verfügbar ist, was der Standard ist. |
WebEngineProfile.AllowPersistentCookies | Cookies, die als persistent gekennzeichnet sind, werden auf der Festplatte gespeichert und von dort wiederhergestellt, während Sitzungscookies nur für die Wiederherstellung nach einem Absturz auf der Festplatte gespeichert werden. Dies ist der Standardwert für ein nicht-off-the-record-Profil mit storageName. |
WebEngineProfile.ForcePersistentCookies | Sowohl Sitzungscookies als auch dauerhafte Cookies werden auf der Festplatte gespeichert und von dort wiederhergestellt. |
persistentPermissionsPolicy : enumeration |
Diese Aufzählung beschreibt die Richtlinie für die Persistenz von Berechtigungen:
| Konstante | Beschreibung |
|---|---|
WebEngineProfile.AskEveryTime | Die Anwendung fragt jedes Mal nach Berechtigungen, wenn sie benötigt werden, unabhängig davon, ob sie zuvor gewährt wurden oder nicht. Dies ist für die Abwärtskompatibilität mit bestehenden Anwendungen gedacht und wird ansonsten nicht empfohlen. |
WebEngineProfile.StoreInMemory | Eine Anfrage wird nur beim ersten Mal gestellt, wenn eine Berechtigung benötigt wird. Alle weiteren Anfragen werden automatisch gewährt oder verweigert, je nach der ursprünglichen Entscheidung des Benutzers. Dies gilt für alle Seiten, die dieselbe QWebEngineProfile -Instanz verwenden, bis die Anwendung beendet wird. Diese Einstellung wird verwendet, wenn off-the-record gesetzt ist oder kein dauerhafter Datenpfad verfügbar ist. |
WebEngineProfile.StoreOnDisk | Funktioniert genauso wie PersistentPermissionsInMemory, aber die Berechtigungen werden auf der Festplatte gespeichert und von dort wiederhergestellt. Dies ist die Standardeinstellung. |
Diese Eigenschaft wurde in Qt 6.8 eingeführt.
persistentStoragePath : string |
Der Pfad zu dem Ort, an dem die dauerhaften Daten für den Browser und Webinhalte gespeichert werden. Zu den dauerhaften Daten gehören dauerhafte Cookies, lokaler HTML5-Speicher und besuchte Links.
Standardmäßig befindet sich der Speicher unterhalb von QStandardPaths::writableLocation(QStandardPaths::AppDataLocation) in einem Verzeichnis mit dem Namen storageName.
spellCheckEnabled : bool |
Diese Eigenschaft gibt an, ob die Rechtschreibprüfung der Web-Engine aktiviert ist.
Diese Eigenschaft wurde in QtWebEngine 1.4 eingeführt.
Diese Eigenschaft enthält die Liste der Sprachen, die von der Rechtschreibprüfung verwendet werden. Jede Sprache sollte mit dem Namen des .bdic Wörterbuchs übereinstimmen. Zum Beispiel wird die Sprache en-US die Wörterbuchdatei en-US.bdic laden.
Wie die Wörterbuchdateien durchsucht werden, ist in der Dokumentation der Rechtschreibprüfung beschrieben.
Weitere Informationen über das Kompilieren von .bdic Wörterbüchern finden Sie im Spellchecker-Beispiel.
Diese Eigenschaft wurde in QtWebEngine 1.4 eingeführt.
storageName : string |
Der Speichername, der verwendet wird, um separate Unterverzeichnisse für jedes Profil zu erstellen, das die Festplatte zum Speichern von persistenten Daten und Cache verwendet.
Siehe auch WebEngineProfile::persistentStoragePath und WebEngineProfile::cachePath.
userScripts : WebEngineScriptCollection |
Gibt die Sammlung von WebEngineScript Objekten zurück, die in alle Seiten injiziert werden, die dieses Profil verwenden.
Signal-Dokumentation
|
Dieses Signal wird ausgegeben, wenn der Vorgang clearHttpCache() abgeschlossen ist.
Hinweis: Der entsprechende Handler ist onClearHttpCacheCompleted.
Dieses Signal wurde in QtWebEngine 6.7 eingeführt.
Siehe auch clearHttpCache().
downloadFinished(WebEngineDownloadRequest download) |
Dieses Signal wird immer dann ausgegeben, wenn das Herunterladen gestoppt wird, weil es erfolgreich beendet, abgebrochen oder unterbrochen wurde (z.B. weil die Verbindung unterbrochen wurde). Das Argument download enthält den Zustand der beendeten Download-Instanz.
Hinweis: Der entsprechende Handler ist onDownloadFinished.
downloadRequested(WebEngineDownloadRequest download) |
Dieses Signal wird ausgesendet, wenn ein Download ausgelöst wurde. Das Argument download enthält den Status des Downloads. Der Download muss explizit mit WebEngineDownloadRequest::accept() akzeptiert werden oder der Download wird standardmäßig abgebrochen.
Hinweis: Der entsprechende Handler ist onDownloadRequested.
|
Dieses Signal wird immer dann ausgegeben, wenn es eine neu erstellte Benutzermeldung gibt. Das Argument notification enthält die Instanz WebEngineNotification, mit der Daten abgefragt und interagiert werden.
Hinweis: Der entsprechende Handler ist onPresentNotification.
Dieses Signal wurde in QtWebEngine 1.9 eingeführt.
Dokumentation der Methode
|
Entfernt die Cache-Einträge des Profils.
Hinweis: Achten Sie darauf, dass Sie keine neue Navigation oder einen anderen Vorgang auf dem Profil starten, während der Löschvorgang ausgeführt wird. Das Signal clearHttpCacheCompleted() informiert über den Abschluss des Vorgangs.
Diese Methode wurde in QtWebEngine 1.3 eingeführt.
Siehe auch WebEngineProfile::cachePath und clearHttpCacheCompleted().
|
Gibt eine list von webEnginePermission Objekten zurück, von denen jedes eine einzelne, derzeit im Berechtigungsspeicher vorhandene Berechtigung darstellt. Die zurückgegebene Liste enthält alle zuvor gewährten/entzogenen Berechtigungen für dieses Profil, sofern sie von einem dauerhaften Typ sind.
Hinweis: Wenn die Eigenschaft persistentPermissionPolicy auf AskEveryTime gesetzt ist, wird eine leere Liste zurückgegeben.
Diese Methode wurde in Qt 6.8 eingeführt.
Siehe auch queryPermission(), listPermissionsForOrigin(), listPermissionsForPermissionType(), und webEnginePermission::isPersistent().
|
Gibt eine list von webEnginePermission Objekten zurück, von denen jedes eine einzelne, derzeit im Berechtigungsspeicher vorhandene Berechtigung darstellt. Die zurückgegebene Liste enthält alle zuvor gewährten/entzogenen Berechtigungen, die mit einem bestimmten securityOrigin für dieses Profil verbunden sind, sofern sie von einem dauerhaften Typ sind.
Hinweis: Da Berechtigungen pro Ursprung gewährt werden, wird die angegebene securityOrigin in ihre Ursprungsform zerlegt, und die zurückgegebene Liste enthält alle Berechtigungen für den Ursprung. Daher ist die Übergabe von https://www.example.com/some/page.html dasselbe wie die Übergabe von https://www.example.com/.
Hinweis: Wenn persistentPermissionPolicy() auf AskEveryTime gesetzt ist, wird eine leere Liste zurückgegeben.
Diese Methode wurde in Qt 6.8 eingeführt.
Siehe auch queryPermission(), listAllPermissions(), listPermissionsForPermissionType(), und webEnginePermission::isPersistent().
|
Gibt eine list von webEnginePermission Objekten zurück, von denen jedes eine einzelne Berechtigung darstellt, die derzeit im Berechtigungsspeicher vorhanden ist. Die zurückgegebene Liste enthält alle zuvor gewährten/verweigerten Berechtigungen der angegebenen permissionType. Wenn der permissionType nicht persistent ist, ist die Liste leer.
Hinweis: Wenn persistentPermissionPolicy() auf AskEveryTime gesetzt ist, wird eine leere Liste zurückgegeben.
Diese Methode wurde in Qt 6.8 eingeführt.
Siehe auch queryPermission(), listAllPermissions(), listPermissionsForOrigin(), und webEnginePermission::isPersistent().
|
Gibt ein Objekt webEnginePermission zurück, das einer einzelnen Berechtigung für die angegebenen securityOrigin und permissionType entspricht. Das Objekt kann verwendet werden, um den aktuellen Status der Berechtigung abzufragen oder sie zu ändern. Es ist nicht erforderlich, dass eine Berechtigung bereits existiert; das zurückgegebene Objekt kann auch verwendet werden, um eine Berechtigung vorab zu erteilen, wenn bekannt ist, dass eine Website sie verwendet.
Hinweis: Diese Funktion kann nur für persistente Berechtigungstypen verwendet werden. Ein Aufruf mit einer nicht-persistenten permissionType gibt ein ungültiges Objekt zurück.
Diese Methode wurde in Qt 6.8 eingeführt.
Siehe auch listAllPermissions(), listPermissionsForOrigin(), und listPermissionsForPermissionType().
© 2025 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.
