QWebEnginePermission Class

詳細説明

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

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

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

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

QWebEnginePermission::PermissionType Qt がサポートするすべてのパーミッション・タイプについて説明します。いくつかのパーミッション・タイプだけが、ブラウジング・セッション間で記憶されます。永続的でないパーミッションは、ウェブサイトから要求されるたびにユーザーに問い合わせます。パーミッション・タイプが永続的かどうかは、静的メソッド () を使って実行時に確認することができます。WebEngine QWebEnginePermission::isPersistent

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

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

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