Web Share API

このAPIは Navigator インターフェイスに以下の内部スロットを追加します。

Promise? [[sharePromise]]

this.[[sharePromise]] は、ユーザーが現在データを 共有先 に共有しようとする意図を表すPromiseです。初期値は null です。

share() メソッドが data 引数付きで呼び出された場合、以下のステップをセキュリティ上の注意事項も考慮しながら実行します。

Web Shareはウェブサイトから共有先（ネイティブアプリ等）へデータを送信できる機能を提供します。この機能はWeb Share固有ではありませんが、プラットフォームによって深刻度が異なるさまざまなセキュリティリスクを伴います。

share() に渡されたデータは、 共有先のバッファオーバーフローやリモートコード実行脆弱性の悪用に使われる可能性があります。一般的な対策はありませんが、特にファイル共有時には実装者はこの可能性を認識しておくべきです。

共有先が共有されたURLを解決して情報転送する場合、機密情報が漏洩する可能性があります。共有が参照するコンテンツが、そのアプリやホスト、ネットワークロケーションでのみアクセス可能な場合、意図しない情報漏洩につながることがあります。

悪意あるサイトは、最終的にローカルリソース（"file:" URL やローカルサービス等）に解決されるURLを提供することで、情報漏洩する共有先を悪用する可能性があります。このAPIは共有可能なスキームを制限しますが、リダイレクトやDNSレコードの操作によって、アプリがコンテンツを取得させられる可能性もあります。

このような攻撃への対策として、共有先はURLを取得して処理するのみで他へ共有しないようにできます。たとえば、画像編集アプリが共有された画像のみ取得する場合や、URLだけ共有して内容を取得しない場合などです。

プレビューや共有のためにコンテンツを取得する共有先は、情報漏洩リスクがあります。ユーザーがプレビューや許可した内容なら安全ですが、機密性の判断が難しい場合もあり、内容の転送はリスクを伴います。特に、title は攻撃者がユーザーを誤認させるために利用する可能性があります（5. アクセシビリティに関する考慮事項も参照）。

DOMException を使用する場合、実装者は share() の拒否時にエラーメッセージでどの情報が公開されるか慎重に検討する必要があります。共有先がない場合とユーザーキャンセルの場合を区別するだけでも、デバイスにどの共有先がインストールされているかが漏洩する可能性があります。

1. global を this の 関連グローバルオブジェクトとします。
2. document を global の 関連付けられた Documentとします。
3. document が 完全にアクティブでない場合、promiseを拒否し "InvalidStateError" DOMException を返します。
4. document が "web-share" を使用許可されていない場合、promiseを拒否し "NotAllowedError" DOMException を返します。
5. this.[[sharePromise]] が null でない場合、promiseを拒否し "InvalidStateError" DOMException を返します。
6. global が 一時的なアクティベーションを持たない場合、promiseを拒否し "NotAllowedError" DOMException を返します。
7. globalのユーザーアクティベーションを消費します。
8. base を this の 関連設定オブジェクト の APIベースURL とします。
9. validate share data を data と base で実行した結果が false の場合、promiseを拒否し TypeError を返します。
10. data の url メンバーが存在する場合：
    1. url を URL パーサーで data の url と base を使って実行した結果とします。
    2. Assert: url は URL です。
    3. data をコピーし、その url メンバーに url を URLシリアライザー でシリアライズした結果を設定します。
11. セキュリティ上の理由でファイルタイプがブロックされている場合、promiseを拒否し "NotAllowedError" DOMException を返します。
12. this.[[sharePromise]] に 新しいPromise をセットします。
13. this.[[sharePromise]] を返し、並行して：
    1. 利用可能な 共有先 がない場合、グローバルタスクをキューし、ユーザーインタラクションタスクソースを global で使用して：
       1. reject this.[[sharePromise]] を "AbortError" DOMException で拒否します。
       2. this.[[sharePromise]] を null に設定します。
       3. このアルゴリズムを終了します。
    2. ユーザーに1つ以上の 共有先 の選択肢と操作中止の選択肢を提示します。このUIはセキュリティ確認の役割を持ち、ウェブサイトがデータをネイティブアプリへ密かに送信できないようにします。ユーザーエージェントはOSレベルUIでこの機能がない場合、中間UIを表示してユーザーが共有内容を確認できるように 推奨 します。
    3. ユーザーの選択を待ちます。
    4. ユーザーが共有操作を中止した場合は、グローバルタスクをキューし ユーザーインタラクションタスクソースを global で使用して：
       1. reject this.[[sharePromise]] を "AbortError" DOMException で拒否します。
       2. this.[[sharePromise]] を null に設定します。
       3. このアルゴリズムを終了します。
    5. 選択された 共有先 を起動し、dataを共有先向けの形式に変換し、変換したデータを送信します。
    6. 共有先の起動やデータ送信でエラーが発生した場合は、グローバルタスクをキューし ユーザーインタラクションタスクソースを global で使用して：
       1. reject this.[[sharePromise]] を "DataError" DOMException で拒否します。
       2. this.[[sharePromise]] を null に設定します。
       3. このアルゴリズムを終了します。
    7. データが 共有先 に正常に送信された場合、またはOSに正常に送信された場合（共有先への送信可否が確認できない場合）、グローバルタスクをキューし ユーザーインタラクションタスクソースを global で使用して：
       注記
       1. resolve this.[[sharePromise]] を undefined で解決します。
       2. this.[[sharePromise]] を null に設定します。

canShare() メソッドが ShareData data 引数付きで呼び出された場合、次の手順を実行します：

1. document を this の 関連グローバルオブジェクト の 関連付けられた Document とします。
2. document が 完全にアクティブでない場合、false を返します。
3. document が "web-share" を使用許可されていない場合、false を返します。
4. validate share data を data と this の 関連設定オブジェクト の APIベースURL で実行した結果を返します。

共有可能なスキーム とは、以下の URL スキーム のいずれかです：

• http
• https
• ユーザーエージェントが共有目的でサポートする 安全リスト化されたスキーム

共有データの検証 を data と base で実行するには、次の手順を実行します：

1. data の title, text、url、files のいずれも存在しない場合、false を返します。
2. title、text、url のいずれかが存在する場合、titleTextOrUrl を true とします。
3. data の files メンバーが存在する場合：
   1. titleTextOrUrl が false で、data の files メンバーが空の場合、false を返します。
      注記

      { files: [] } のような辞書は空辞書として扱われます。ただし {text: "text", files: []} のような辞書は、files が単に無視されるだけなので問題ありません。

   2. 実装がファイル共有をサポートしていない場合、false を返します。
   3. ユーザーエージェントが files 内のいずれかのファイルが悪意ある共有（内容・サイズ・その他特徴によって悪意があると判断した場合）になると考える場合、false を返します。
4. data の url メンバーが存在する場合：
   1. url を URLパーサーで data の url メンバーと base を使い、エンコーディングオーバーライド無しで実行した結果とします。
   2. url が失敗の場合、false を返します。
   3. url の スキーム が ローカルスキーム、file、javascript、ws、wss のいずれかの場合、false を返します。
   4. url の スキーム が 共有可能なスキーム でない場合、false を返します。
5. true を返します。