requestStorageAccessFor API

1. p を新しい Promiseとします。

2. doc が完全にアクティブでない場合、p を「InvalidStateError」 DOMException で拒否し、 p を返します。

3. doc のノードナビゲーション可能がトラバーサブルナビゲーション可能でない場合、 p を「NotAllowedError」 DOMException で拒否し、 p を返します。

4. doc のオリジンが不透明なオリジンである場合、p を「NotAllowedError」 DOMException で拒否し、 p を返します。

5. doc の関連するグローバルオブジェクトがセキュアコンテキストでない場合、p を「NotAllowedError」 DOMException で拒否し、 p を返します。

6. parsedURL を、requestedOrigin に対してURL パーサーを実行した結果とします。

7. parsedURL が失敗である場合、p を TypeError で拒否し、 p を返します。

8. origin を parsedURL のオリジンとします。

9. origin が不透明なオリジンである場合、p を「NotAllowedError」 DOMException で拒否し、 p を返します。

10. doc のオリジンが origin と同一オリジンである場合、p を解決して返します。

11. descriptor を、新しく作成された TopLevelStorageAccessPermissionDescriptor とします。その name は「top-level-storage-access」 に設定し、requestedOrigin は origin に設定します。

12. has activation を、doc の Window オブジェクトが一時的なアクティベーションを持つ場合は true、 それ以外の場合は false とします。

13. 次の手順を並行して実行します。

    1. settings を doc の関連する設定オブジェクトとします。

    2. global を doc の関連するグローバルオブジェクトとします。

    3. existing state を、settings における descriptor の許可状態とします。

    4. existing state が許可済みである場合:

       1. global を指定し、許可タスクソース上で、 p を解決するグローバルタスクをキューに追加します。

       2. 返します。

    5. existing state が拒否済みである場合:

       1. doc の Window オブジェクトが一時的なアクティベーションを持つ場合、 それを使用してユーザーアクティベーションを消費します。

       2. global を指定し、許可タスクソース上で、 p を「NotAllowedError」 DOMException で拒否するグローバルタスクをキューに追加します。

       3. 返します。

    6. doc のノードナビゲーション可能がトラバーサブルナビゲーション可能であることを表明します。

    7. has activation が false である場合:

       1. global を指定し、許可タスクソース上で、 p を「NotAllowedError」 DOMException で拒否するグローバルタスクをキューに追加します。

       2. 返します。

    8. permissionState を、descriptor を使用して「top-level-storage-access」 の使用許可を要求した結果とします。

       注: 許可を要求し、プロンプトを表示するかどうかを決定するとき、 ユーザーエージェントは、エンドユーザー体験を形成するために実装定義の動作を適用することに注意してください。特に top-level-storage-access については、ユーザーエージェントが、プロンプトを表示せずに 許可を付与または拒否する独自の規則を適用することが知られています。

    9. permissionState が許可済みである場合:

       1. global を指定し、許可タスクソース上で、 p を解決するグローバルタスクをキューに追加します。

       2. 返します。

    10. doc の Window オブジェクトが一時的なアクティベーションを持つ場合、 それを使用してユーザーアクティベーションを消費します。

    11. global を指定し、許可タスクソース上で、 p を「NotAllowedError」 DOMException で拒否するグローバルタスクをキューに追加します。

14. p を返します。

許可タスク ソースを直接使用すべきではありません。[privacycg/requestStorageAccessFor Issue #15]

1. settings を、request のクライアントの関連するグローバルオブジェクトの関連する設定オブジェクトとします。

2. embedded origin を、request のURL のオリジンとします。

3. descriptor を、新しく作成された TopLevelStorageAccessPermissionDescriptor とします。その name は「top-level-storage-access」 に設定し、requestedOrigin は embedded origin に設定します。

4. existing state を、settings における descriptor の許可状態とします。

5. existing state が許可済み である場合、true を返します。

6. false を返します。

1. has top-level access を、request に対してリクエストが トップレベルストレージアクセスを持つかどうかを判定した結果とします。

2. has top-level access が false である場合、false を返します。

3. is subresource を、request がサブリソースリクエストである場合は true、 それ以外の場合は false とします。

4. allowed subresource mode を、request のモードが "cors" であり、かつ request の資格情報モードが "include" である場合は true、それ以外の場合は false とします。

5. is subresource が true で、allowed subresource mode が false である場合、false を返します。

6. request のクライアントの関連するグローバルオブジェクトの関連付けられた文書がトラバーサブルナビゲーション可能でない場合、false を返します。

7. true を返します。

1. settings を doc の関連する設定オブジェクトとします。

2. origin を settings のオリジンとします。

3. descriptor を、新しく作成された TopLevelStorageAccessPermissionDescriptor とします。その name は「top-level-storage-access」 に設定し、requestedOrigin は origin に設定します。

4. descriptor の許可状態が許可済み である場合、global を指定し、許可タスクソース上で、p を解決するグローバルタスクをキューに追加し、返します。

5. descriptor の許可状態が拒否済み である場合、global を指定し、許可タスクソース上で、p を「NotAllowedError」 DOMException で拒否するグローバルタスクをキューに追加し、返します。