webEnginePermission QML Value Type

特定のオリジンURLに許可または拒否された1つのパーミッションにアクセスし、その状態を変更するために使用されるオブジェクトです。詳細...

プロパティ

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

メソッド

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

詳細説明

典型的な使用パターンは以下の通りです：

1. ウェブサイトが特定の機能を要求し、WebEngineView::permissionRequested シグナルをトリガーする；
2. シグナルハンドラは、ユーザーに許可を与えるかどうかを尋ねるプロンプトをトリガーする；
3. ユーザーが決定すると、アプリケーションはgrant() またはdeny() を呼び出す；

また、すでに許可されているパーミッションの変更に興味のあるアプリケーションは、WebEngineProfile::listAllPermissions() を使用してプロファイルに関連付けられた既存のパーミッションのリストを取得したり、WebEngineProfile::queryPermission() を使用して特定のパーミッションの webEnginePermission オブジェクトを取得したりすることもできます。

origin プロパティは、webEnginePermission がどのオリジンに関連付けられているかをクエリするために使用でき、permissionType プロパティは関連する機能を説明します。Web サイトのオリジンは、スキーム、ホスト名、およびポートの組み合わせです。したがって、Web ページhttps://www.example.com:12345/some/page.html がパーミッションを要求した場合、そのパーミッションはオリジンhttps://www.example.com:12345/ に付与されます。

permissionType 列挙は QtWebEngine がサポートするすべてのパーミッション・タイプを記述しています。いくつかのパーミッション・タイプのみが、ブラウジング・セッション間で記憶されます。永続的でないパーミッションは、ウェブサイトから要求されるたびにユーザーに問い合わせます。静的メソッド WebEnginePermission::isPersistent() を使用すると、実行時にパーミッションの種類が永続的かどうかを確認できます。

永続的なパーミッションはアクティブなWebEngineProfile 内に保存され、その有効期間はWebEngineProfile::persistentPermissionsPolicy の値に依存します。 デフォルトでは、名前付きプロファイルはパーミッションをディスクに保存しますが、記録外のものはメモリに保存します（プロファイルが破棄されると破棄されます）。保存されたパーミッションは、次にウェブサイトがそれを要求したときに、ユーザーに問い合わせることはありません。その代わりに、ユーザーが最初に選んだ解決策に応じて、自動的に許可または拒否されます。保存されたパーミッションを消去するには、reset()を呼び出します。

一方、永続的でないパーミッションは、関連するWebEngineView が別の URL へのナビゲーションを実行するか、破棄されるまでしか使用できません。

WebEnginePermission が有効な状態にあるかどうかは、isValid プロパティで確認できます。無効なオブジェクトの場合、grant()、deny()、reset() を呼び出しても何も実行されず、state を呼び出すと常に WebEnginePermission::Invalid が返されます。

WebEngineView::permissionRequested 、WebEngineProfile::queryPermission()、WebEngineProfile::listAllPermissions()も参照して ください。

プロパティの説明

メソッドの説明