webEnginePermission QML Value Type

Ein Objekt, das verwendet wird, um auf den Status einer einzelnen Erlaubnis zuzugreifen und diesen zu ändern, die für eine bestimmte Ursprungs-URL erteilt oder verweigert wurde. Mehr...

Eigenschaften

• isValid : bool
• origin : url
• permissionType : enumeration
• state : enumeration

Methoden

• void deny()
• void grant()
• void isPersistent(WebEnginePermission.PermissionType permissionType)
• void reset()

Detaillierte Beschreibung

Das typische Nutzungsmuster ist wie folgt:

1. Eine Website fordert eine bestimmte Funktion an und löst damit das Signal WebEngineView::permissionRequested aus;
2. Der Signalhandler löst eine Eingabeaufforderung aus, in der der Benutzer gefragt wird, ob er die Erlaubnis erteilen möchte;
3. Wenn der Benutzer seine Entscheidung getroffen hat, ruft die Anwendung grant() oder deny() auf;

Alternativ kann eine Anwendung, die an der Änderung bereits erteilter Berechtigungen interessiert ist, WebEngineProfile::listAllPermissions() verwenden, um eine Liste der mit einem Profil verbundenen bestehenden Berechtigungen zu erhalten, oder WebEngineProfile::queryPermission(), um ein webEnginePermission-Objekt für eine bestimmte Berechtigung zu erhalten.

Mit der Eigenschaft origin kann abgefragt werden, welcher Herkunft die webEnginePermission zugeordnet ist, während die Eigenschaft permissionType das zugehörige Feature beschreibt. Der Ursprung einer Website ist die Kombination aus Schema, Hostname und Port. Berechtigungen werden pro Ursprung gewährt; wenn also die Webseite https://www.example.com:12345/some/page.html eine Berechtigung anfordert, wird sie dem Ursprung https://www.example.com:12345/ gewährt.

Die Aufzählung permissionType beschreibt alle Berechtigungstypen, die Qt WebEngine unterstützt. Nur einige Berechtigungstypen werden zwischen Browsing-Sitzungen gespeichert; sie sind persistent. Nicht-persistente Berechtigungen fragen den Benutzer jedes Mal ab, wenn eine Website sie anfordert. Sie können überprüfen, ob ein Berechtigungstyp zur Laufzeit persistent ist, indem Sie die statische Methode WebEnginePermission::isPersistent() verwenden.

Persistente Berechtigungen werden innerhalb des aktiven WebEngineProfile gespeichert, und ihre Lebensdauer hängt vom Wert von WebEngineProfile::persistentPermissionsPolicy ab. Standardmäßig speichern benannte Profile ihre Berechtigungen auf der Festplatte, wohingegen Off-the-Record-Profile sie im Speicher speichern (und zerstören sie, wenn das Profil zerstört wird). Eine gespeicherte Berechtigung wird nicht abgefragt, wenn eine Website sie das nächste Mal anfordert; stattdessen wird sie automatisch gewährt oder verweigert, je nachdem, welche Auflösung der Benutzer ursprünglich gewählt hat. Um eine gespeicherte Berechtigung zu löschen, rufen Sie reset() auf.

Eine nicht-persistente Berechtigung hingegen ist nur so lange nutzbar, bis die zugehörige WebEngineView eine Navigation zu einer anderen URL durchführt oder zerstört wird.

Sie können überprüfen, ob eine WebEnginePermission in einem gültigen Zustand ist, indem Sie ihre isValid Eigenschaft verwenden. Bei ungültigen Objekten führen Aufrufe von grant(), deny() oder reset() zu nichts, während Aufrufe von state immer WebEnginePermission::Invalid zurückgeben.

Siehe auch WebEngineView::permissionRequested, WebEngineProfile::queryPermission(), und WebEngineProfile::listAllPermissions().

Eigenschaft Dokumentation

Dokumentation der Methode