クリップボードAPIとイベント

dictionary ClipboardEventInit : EventInit {
  DataTransfer? clipboardData = null;
};

[Exposed=Window]
interface ClipboardEvent : Event {
  constructor(DOMString type, optional ClipboardEventInit eventInitDict = {});
  readonly attribute DataTransfer? clipboardData;
};

var pasteEvent = new ClipboardEvent('paste');
pasteEvent.clipboardData.items.add('My string', 'text/plain');
document.dispatchEvent(pasteEvent);

// クリップボードにコピーされる内容を上書きする例
document.addEventListener('copy', function(e) {
  // e.clipboardDataは初期状態では空ですが、コピーしたいデータを設定できます。
  e.clipboardData.setData('text/plain', 'Hello, world!');
  e.clipboardData.setData('text/html', '<b>Hello, world!</b>');

  // ドキュメント選択範囲がクリップボードに書き込まれるのを防ぐために必要です。
  e.preventDefault();
});

// クリップボードにコピーされる内容を上書きする例
document.addEventListener('cut', function(e) {
  // e.clipboardDataは初期状態では空ですが、切り取り時にコピーしたいデータを設定できます。
  // クリップボードにコピーしたいデータを書き込みます。
  e.clipboardData.setData('text/plain', 'Hello, world!');
  e.clipboardData.setData('text/html', '<b>Hello, world!</b>');

  // cut操作をキャンセルするため、選択されたテキストを手動で削除する必要があります。
  deleteCurrentDocumentSelection();

  // ドキュメント選択範囲がクリップボードに書き込まれるのを防ぐために必要です。
  e.preventDefault();
});

// クリップボードから貼り付けられる内容を上書きする例
document.addEventListener('paste', function(e) {
  // e.clipboardDataは貼り付け直前のデータを含みます。
  if (e.clipboardData.types.indexOf('text/html') > -1) {
    var oldData = e.clipboardData.getData('text/html');
    var newData = '<b>Ha Ha!</b> ' + oldData;

    // 貼り付け操作をキャンセルするため、手動でデータをドキュメントに貼り付けます。
    pasteClipboardData(newData);

    // デフォルトの貼り付け動作を防ぐために必要です。
    e.preventDefault();
  }
});

partial interface Navigator {
  [SecureContext, SameObject] readonly attribute Clipboard clipboard;
};

typedef Promise<(DOMString or Blob)> ClipboardItemData;

[SecureContext, Exposed=Window]
interface ClipboardItem {
  constructor(record<DOMString, ClipboardItemData> items,
              optional ClipboardItemOptions options = {});

  readonly attribute PresentationStyle presentationStyle;
  readonly attribute FrozenArray<DOMString> types;

  Promise<Blob> getType(DOMString type);

  static boolean supports(DOMString type);
};

enum PresentationStyle { "unspecified", "inline", "attachment" };

dictionary ClipboardItemOptions {
  PresentationStyle presentationStyle = "unspecified";
};

typedef sequence<ClipboardItem> ClipboardItems;

[SecureContext, Exposed=Window]
interface Clipboard : EventTarget {
  Promise<ClipboardItems> read(optional ClipboardUnsanitizedFormats formats = {});
  Promise<DOMString> readText();
  Promise<undefined> write(ClipboardItems data);
  Promise<undefined> writeText(DOMString data);
};

dictionary ClipboardUnsanitizedFormats {
  sequence<DOMString> unsanitized;
};

const items = await navigator.clipboard.read();
const textBlob = await items[0].getType("text/plain");
const text = await (new Response(textBlob)).text();

navigator.clipboard.readText().then(function(data) {
  console.log("取得した文字列: ", data);
});

var data = [new ClipboardItem({ "text/plain": Promise.resolve(new Blob(["Text data"], { type: "text/plain" })) })];
navigator.clipboard.write(data).then(function() {
  console.log("クリップボードへのコピーに成功しました！");
}, function() {
  console.error("クリップボードへの書き込みに失敗しました :-(");
});

await navigator.clipboard.writeText("こんにちは！");

script-may-access-clipboardフラグは、以下のように設定されます：

1. アクションがcopyまたはcutであり、スクリプトスレッドがクリップボードの変更が許可されている場合、

   1. アクションのscript-may-access-clipboardフラグをセットする

2. アクションがpasteであり、スクリプトスレッドがクリップボードからの読み取りが許可されている場合、

   1. アクションのscript-may-access-clipboardフラグをセットする。

コピーアクションは次の手順で構成されます：

1. script-triggeredフラグがセットされている場合、

   1. script-may-access-clipboardフラグが未セットの場合、

      1. コピーアクションからfalseを返し、このアルゴリズムを終了する

2. copyという名前のクリップボードイベントを発火する

3. イベントがキャンセルされなかった場合、

   1. 選択されている内容（あれば）をクリップボードにコピーする。実装は、ウェブページ内で選択された内容に対してtext/htmlおよびtext/plainのクリップボード形式も作成することが推奨されます。

   2. clipboardchangeという名前のクリップボードイベントを発火する

4. イベントがキャンセルされた場合、

   1. write content to the clipboardアルゴリズムを呼び出し、DataTransferItemListリストitems、clear-was-calledフラグ、types-to-clearリストを渡す。

5. コピーアクションからtrueを返す

切り取りアクションは次の手順で構成されます：

1. script-triggeredフラグがセットされている場合、

   1. script-may-access-clipboardフラグが未セットの場合、

      1. 切り取りアクションからfalseを返し、このアルゴリズムを終了する

2. cutという名前のクリップボードイベントを発火する

3. イベントがキャンセルされなかった場合、

   1. 編集可能コンテキストで切り取りが有効な選択範囲があれば、

      1. 選択されている内容（あれば）をクリップボードにコピーする。実装は、ウェブページ内で選択された内容に対してtext/htmlやtext/plainのクリップボード形式も作成することが推奨されます。

      2. 選択範囲の内容を文書から削除し、選択範囲を折りたたむ。

      3. clipboardchangeという名前のクリップボードイベントを発火する

      4. 変更によって発火すべきイベントをキューに追加する。詳細は§ 5.3 他のスクリプトやイベントとの統合を参照。

   2. 選択範囲がなく、またはコンテキストが編集不可の場合、

      1. falseを返す

4. イベントがキャンセルされた場合、

   1. write content to the clipboardアルゴリズムを呼び出し、DataTransferItemListリストitems、clear-was-calledフラグ、types-to-clearリストを渡す。

   2. clipboardchangeという名前のクリップボードイベントを発火する

5. 切り取りアクションからtrueを返す

貼り付けアクションは次の手順で構成されます：

1. script-triggeredフラグがセットされている場合、

   1. script-may-access-clipboardが未セットの場合、

      1. 貼り付けアクションからfalseを返し、このアルゴリズムを終了する

2. pasteという名前のクリップボードイベントを発火する

3. イベントがキャンセルされなかった場合、

   1. 編集可能コンテキスト内で貼り付けが有効な選択やカーソルがある場合、

      1. クリップボード上の最適な内容（あれば）をそのコンテキストに挿入する。

      2. 変更によって発火すべきイベントをキューに追加する。詳細は§ 5.3 他のスクリプトやイベントとの統合を参照。

   2. それ以外の場合、

      1. falseを返す

4. イベントがキャンセルされた場合

   1. falseを返す

5. アクションからtrueを返す

9.1.1. クリップボード読み取り権限の確認

1. hasGestureを、関連グローバルオブジェクトが一時的なアクティベーションを持つ場合true、そうでなければfalseとする。

2. もしhasGestureなら、

   1. 現在のスクリプトがユーザーエージェントまたはOSが作成した「貼り付け」要素のユーザー操作により実行されている場合trueを返す。

3. falseを返す。

9.2.1. クリップボード書き込み権限の確認

1. writeWithoutGestureを{ name: "clipboard-write", allowWithoutGesture: true }権限の権限状態とする。

2. writeWithoutGestureがgrantedならtrueを返す。

3. hasGestureを、関連グローバルオブジェクトが一時的なアクティベーションを持つ場合true、そうでなければfalseとする。

4. もしhasGestureなら、

   1. 現在のスクリプトがユーザーエージェントまたはOSが作成した「cut」または「copy」要素のユーザー操作により実行されている場合systemCopyをtrueとする。

   2. systemCopyがtrueならtrueを返す。

   3. 権限の利用要求を{ name: "clipboard-write", allowWithoutGesture: false }権限に対して実行した結果を返す。

      注: ユーザーエージェントは、より強い権限を要求し、暗黙的にこの権限を更新する選択も可能です。

5. 権限の利用要求を{ name: "clipboard-write", allowWithoutGesture: true }権限に対して実行した結果を返す。

クリップボードに内容を書き込む

入力

items: DataTransferItemList の書き込むアイテムリスト

clear-was-called: boolean型

types-to-clear: リスト型

出力

なし

1. itemsリストが空でない場合、

   1. クリップボードをクリアする

   2. リスト内の各パートについて、

      1. データ型がtext/plainの場合、

         1. OSやロケールの規則に従ってエンコーディングが正しいことを保証する

         2. プラットフォームの規則に従って改行コードを正規化する

         3. テキストを適切なOSクリップボード形式記述子でクリップボードに配置する

      2. それ以外でデータ型が必須データ型リストに含まれている場合、

         1. パートを適切なOSクリップボード形式記述子でクリップボードに配置する

      3. その他

         1. この部分は実装依存・・・

            実装依存にするのは好ましくありません。どうすべきか？

            注: OSクリップボードの実装制限により、スクリプトはカスタムフォーマットが他のアプリケーションで利用可能になると仮定すべきではありません。例えばMicrosoft Windowsでは、登録できるカスタムクリップボードフォーマット数に制限があります。setData()のtype引数には任意の文字列が使えますが、必須データ型を使うのが強く推奨されます。

2. それ以外の場合（itemsリストが空の場合）、クリップボードをクリアするかどうか以下の手順で判断する：

   1. アイテムリストが空で、clear-was-calledフラグがtrueの場合、

      1. types-to-clearリストが空なら、

         1. クリップボードをクリアする

      2. それ以外の場合、

         1. OS・実装依存の方法でtypes-to-clearリストに含まれる型をクリップボードから削除する

            「クリップボードから特定の型のみ削除する」機能はリスクがある。重要性が低く、主要プラットフォームで簡易に実装できるか疑問です。

blobとオプションをクリップボードに書き込む

入力

items: sequence<Blob>

presentationStyle: クリップボードアイテムのpresentation style

出力

なし

1. webCustomFormatsをsequence<Blob>として作成する。

2. itemsの各itemについて：

   1. formatStringをitemのtypeに対してOS固有のよく知られたフォーマットを実行した結果とする。

   2. formatStringが空の場合、以下の手順を実行：

      1. webCustomFormatStringをitemのtypeとする。

      2. webCustomFormatを空のtypeとして作成する。

      3. もしwebCustomFormatStringが"web "で始まる場合、"web "を除去し残りの文字列をwebMimeTypeStringに保存する。

      4. webMimeTypeをwebMimeTypeStringに対してMIME型のパースを実行した結果とする。

      5. もしwebMimeTypeが失敗なら、すべての手順を中断する。

      6. webCustomFormatのtypeの本質をwebMimeTypeに等しくする。

      7. itemのtypeをwebCustomFormatに設定する。

      8. webCustomFormatをwebCustomFormatsに追加する。

   3. payloadをitemのバイト列をUTF-8デコードした結果とする。

   4. payloadとpresentationStyleをformatStringをネイティブクリップボードフォーマットとして使い、システムクリップボードに挿入する。

   一部のOSには複数のクリップボード（例: Linuxの"primary"、"secondary"、"selection"）が存在します。どのクリップボードに書き込むか定義してください。

3. Webカスタムフォーマットの書き込みをwebCustomFormatsに対して実行する。

OS固有のよく知られたフォーマット

入力

mimeType: type

出力

wellKnownFormat: プラットフォーム固有の文字列型。MacではNSPasteboardType、WindowsではLPCWSTR、Linuxではconst char*。

Windowsの詳細は https://docs.microsoft.com/en-us/windows/win32/dataxchg/standard-clipboard-formats および https://docs.microsoft.com/en-us/windows/win32/dataxchg/about-atom-tables?redirectedfrom=MSDN Macの詳細は https://developer.apple.com/documentation/appkit/nspasteboardtype

1. wellKnownFormatを空文字列とする。

2. mimeTypeの本質が"text/plain"の場合、

   Windowsの場合：

   1. CF_UNICODETEXTをwellKnownFormatに代入する。

   MacOSの場合：

   1. NSPasteboardTypeStringをwellKnownFormatに代入する。

   Linux・ChromeOS・Androidの場合：

   1. "text/plain"をwellKnownFormatに代入する。

3. それ以外でmimeTypeの本質が"text/html"の場合、

   Windowsの場合：

   1. CF_HTMLをwellKnownFormatに代入する。

   MacOSの場合：

   1. NSPasteboardTypeHTMLをwellKnownFormatに代入する。

   Linux・ChromeOS・Androidの場合：

   1. "text/html"をwellKnownFormatに代入する。

4. それ以外でmimeTypeの本質が"image/png"の場合、

   Windowsの場合：

   1. "PNG"をwellKnownFormatに代入する。

   MacOSの場合：

   1. NSPasteboardTypePNGをwellKnownFormatに代入する。

   Linux・ChromeOS・Androidの場合：

   1. "image/png"をwellKnownFormatに代入する。

5. それ以外でmimeTypeの本質が"image/svg+xml"の場合、

   Windowsの場合：

   1. CFSTR_MIME_SVG_XMLをwellKnownFormatに代入する。

   MacOSの場合：

   1. UTTypeSVGをwellKnownFormatに代入する。

   Linux・ChromeOS・Androidの場合：

   1. "image/svg+xml"をwellKnownFormatに代入する。

6. wellKnownFormatを返す。

OS固有フォーマットからよく知られたMIME型を得る

入力

osFormatName: プラットフォーム固有の文字列型。MacではNSPasteboardType、WindowsではLPCWSTR、Linuxではconst char*。

出力

mimeType: MIME型

Windowsの詳細は https://docs.microsoft.com/en-us/windows/win32/dataxchg/standard-clipboard-formats および https://docs.microsoft.com/en-us/windows/win32/dataxchg/about-atom-tables?redirectedfrom=MSDN Macの詳細は https://developer.apple.com/documentation/appkit/nspasteboardtype

Windowsの場合：

1. osFormatNameが"UnicodeText"なら、mimeTypeStringを"text/plain"に設定する。

2. それ以外でosFormatNameが"HTML Format"なら、mimeTypeStringを"text/html"に設定する。

3. それ以外でosFormatNameが"PNG"なら、mimeTypeStringを"image/png"に設定する。

4. それ以外でosFormatNameがCFSTR_MIME_SVG_XMLなら、mimeTypeStringを"image/svg+xml"に設定する。

MacOSの場合：

1. osFormatNameがNSPasteboardTypeStringなら、mimeTypeStringを"text/plain"に設定する。

2. それ以外でosFormatNameがNSPasteboardTypeHTMLなら、mimeTypeStringを"text/html"に設定する。

3. それ以外でosFormatNameがNSPasteboardTypePNGなら、mimeTypeStringを"image/png"に設定する。

4. それ以外でosFormatNameがUTTypeSVGなら、mimeTypeStringを"image/svg+xml"に設定する。

Linux・ChromeOS・Androidの場合：

1. osFormatNameが"text/plain"なら、mimeTypeStringを"text/plain"に設定する。

2. それ以外でosFormatNameが"text/html"なら、mimeTypeStringを"text/html"に設定する。

3. それ以外でosFormatNameが"image/png"なら、mimeTypeStringを"image/png"に設定する。

4. それ以外でosFormatNameが"image/svg+xml"なら、mimeTypeStringを"image/svg+xml"に設定する。

1. mimeTypeをmimeTypeStringに対してMIME型のパースを実行した結果とする。

2. mimeTypeを返す。

Webカスタムフォーマットの読み取り

入力

item、クリップボードアイテム

1. webCustomFormatMapをOS固有のカスタムマップ名とする。

2. webCustomFormatMapをシステムクリップボードから読み取る。

   webCustomFormatMapの読み取り処理をより詳細に規定すべき。

3. webCustomFormatMapが空なら、itemを返す。

4. webCustomFormatMapStringをwebCustomFormatMapからデシリアライズしたJSON文字列とする。

   注: webCustomFormatMapの内容デシリアライズにはJSONリーダーが必要。

5. webCustomFormatMapString内の各(key, value)について：

   1. mimeTypeをkeyに対してMIME型のパースの結果とする。

   2. mimeTypeが失敗なら、ループを継続する。

   3. representationを新しいrepresentationとして作成する。

   4. representationのMIME typeをmimeTypeに設定する。

   5. representationのisCustomフラグをtrueに設定する。

   6. webCustomFormatをvalueを使ってシステムクリップボードから読み取る。

   7. 読み取りが成功した場合、representationのdataをシステムクリップボードの取得データに設定し、失敗ならループを継続する。

   8. representationをitemのlist of representationsに追加する。

Webカスタムフォーマットの書き込み

入力

items、sequence<Blob>

1. idxを0で初期化する。

2. webCustomFormatMapをOS固有のカスタムマップ名とする。

3. webCustomFormatMapStringを空のJSON文字列とする。

4. itemsの各itemについて：

   1. webCustomFormatをOS固有のカスタム名とする。

   2. webCustomFormatIdxをwebCustomFormatにidxを結合した結果とする。

   3. itemのtypeをキー、webCustomFormatIdxを値として webCustomFormatMapStringにJSONシリアライザーで追加する。

      注: webCustomFormatMapStringへのシリアライズにはJSONライターが必要。

   4. itemをwebCustomFormatIdxをフォーマットとしてシステムクリップボードに挿入する。

   5. idxをインクリメントする。

   6. idxが100を超えたら、このループを終了する。

5. webCustomFormatMapStringをwebCustomFormatMapをフォーマットとしてシステムクリップボードに挿入する。

OS固有のカスタムマップ名

出力

webCustomFormatMap、文字列

Windowsの場合：

1. webCustomFormatMapに"Web Custom Format Map"を代入する。

2. webCustomFormatMapを返す。

MacOSの場合：

1. webCustomFormatMapに"org.w3.web-custom-format.map"を代入する。

2. webCustomFormatMapを返す。

Linux、ChromeOS、Androidの場合：

1. webCustomFormatMapに"application/web;type=\"custom/formatmap\""を代入する。

2. webCustomFormatMapを返す。

OS固有のカスタム名

出力

webCustomFormat、文字列

Windowsの場合：

1. webCustomFormatに"Web Custom Format"を代入する。

2. webCustomFormatを返す。

MacOSの場合：

1. webCustomFormatに"org.w3.web-custom-format.type-"を代入する。

2. webCustomFormatを返す。

Linux、ChromeOS、Androidの場合：

1. webCustomFormatに"application/web;type=\"custom/format\""を代入する。

2. webCustomFormatを返す。

クリップボードイベントの発火

入力

e、発火するClipboardEvent

出力

なし

1. clear-was-calledをfalseとする。

2. types-to-clearを空リストとする。

3. clipboard-event-dataを空のDataTransfer オブジェクト（itemsリストは空）とする。

4. clipboard-entryを現在のクリップボード内容のシーケンス番号、またはOSクリップボードがシーケンス番号をサポートしない場合はnullとする。

5. trustedをイベントがユーザーエージェントによって生成された場合true、それ以外はfalseとする。

6. targetを次のように設定する：

   1. コンテキストが編集可能な場合：

      1. targetを、ドキュメント順で可視選択範囲またはカーソルの開始位置を含む要素、なければbody要素とする。

   2. コンテキストが編集不可の場合：

      1. targetをフォーカスされているノード、なければbody要素とする。

7. イベントを次のように処理する：

   1. eが"paste"の場合：

      1. clipboard-event-dataの内部drag data store modeフラグをread-onlyに設定する。

      2. trustedがtrue、または実装がスクリプト生成イベントにOSクリップボードの読み取り権限を与えるよう設定されている場合：

         1. OSクリップボード上の各clipboard-partについて以下を実行：

            1. clipboard-partがプレーンテキストの場合：

               1. テキストがスクリプトエンジン内部のエンコーディングであることを保証する。

               2. new-dataを新しいDataTransferItem とし、drag data item kindはstring、drag data item type stringはtext/plain。

               3. new-dataのデータをプレーンテキストに設定する。

               4. new-dataをclipboard-event-dataのitemsリストに追加する。

            2. clipboard-partがファイル参照の場合、その各ファイル参照について：

               1. 参照ファイルのMIME型を判定する。

               2. new-dataを新しいDataTransferItem とし、drag data item kindはfile、drag data item type stringはMIME型（不明ならapplication/octet-stream）。

               3. new-dataのデータをファイル参照データに設定する。

               4. new-dataをclipboard-event-dataのitemsリストに追加する。

            3. clipboard-partがOSの規則によるHTMLまたはXHTML形式テキストの場合：

               1. 実装がHTML貼り付けをサポートしていれば、HTML貼り付けイベントの処理をclipboard-partとclipboard-event-dataで実行する。

            4. clipboard-partが他のサポートされたバイナリまたはテキスト型（必須データ型参照）の場合：

               1. データのMIME型を判定する。

               2. new-dataを新しいDataTransferItem とし、drag data item kindはfile、drag data item type stringはMIME型。

               3. new-dataのデータをバイナリまたはテキストデータに設定する。

               4. new-dataをclipboard-event-dataのitemsリストに追加する。

      3. clipboard-event-dataのfiles プロパティをitemsリストに合わせて更新する。

      4. clipboard-event-dataのtypes プロパティをitemsリストに合わせて更新する。

   2. eが"copy"または"cut"の場合：

      1. 関連DataTransfer オブジェクトの内部drag data store modeフラグをread/writeに設定する。

8. eのclipboardData をclipboard-event-dataに設定する。

9. eのisTrusted をtrustedに設定する。

10. eのcomposed をtrueに設定する。

11. イベントeをバブル・キャンセル可能として、ClipboardEvent インターフェースを使用しtargetで発火する。

    イベント発火中のデータアクセス要件は[HTML]で定義されています。追加のクリップボードイベント固有の処理規則は下記の通りです：

    なぜここに？なぜHTML仕様に記載しない？

    1. スクリプトがclearData()またはclear() を呼び出し、かつDataTransfer オブジェクトの内部drag data store modeフラグがread/writeの場合：

       1. clear-was-calledフラグをtrueに設定する。引数が指定されている場合はその引数をtypes-to-clearリストに追加する。

    2. スクリプトがsetData()を呼び出すかitemsを変更し、clear-was-calledフラグがtrueの場合：

       1. types-to-clearリストが空なら：

          1. clear-was-calledフラグをfalseに設定する。

       2. それ以外の場合、setData()のtype引数または新規アイテムのdrag data item type stringが types-to-clearリストに含まれていれば：

          1. それをリストから除去し、リストが空になったらclear-was-calledフラグをfalseに設定する。

    3. スクリプトがgetData()を呼び出すかDataTransferItemList のitemsにアクセスし、clipboard-entryがセットされている場合：

       1. クリップボードデータのシーケンス番号がclipboard-entryと一致するか確認し、一致しない場合はDataTransferItemList オブジェクトの内部drag data store modeをprotectedに設定する。

    警告！pasteイベントを監視する悪意のあるスクリプトは、ユーザーが今後クリップボードに置く内容を読み取るため、無限ループを仕掛ける可能性があります。クリップボードのシーケンス番号が取得できないプラットフォームでは、他の制限を実装すべきです。

HTML貼り付けイベントの処理

入力

clipboard-part、処理対象のクリップボードパート

clipboard-event-data、このイベント用のDataTransferオブジェクト

出力

なし

1. new-dataを新しいDataTransferItem とし、drag data item kindはPlain Unicode string、drag data item type stringは適宜text/htmlまたはapplication/xhtml+xml。

2. clipboard-partからマークアップを抽出し、適切なパーサーでDOMツリーを構築する。

3. マークアップのソースURLが判明している場合、HREFやSRC属性の相対URLをソースURLを基準に絶対URLに解決し、属性値を絶対URLにする。

4. マークアップのオリジンがローカルアプリケーションの場合、ローカルファイルやOSクリップボード内の他パート参照があるか確認し、参照があればsub-part参照はcid:URLスキーム[RFC2392]でcontent-id参照に必ず置換する。各属性について下記手順で処理：

   これらの手順は必要か？内部参照を持つネイティブ（プラットフォーム）クリップボード実装の存在を把握しているか？

   この機能は要件不明かつクロスプラットフォームで検証困難なためリスクあり。

   1. clipboard-event-dataのitems に参照されたファイルまたはクリップボード部品のエントリが既に存在する場合、

      1. itemNumberに既存エントリのインデックスを設定する。

   2. それ以外の場合、

      1. new-file-dataを新しいDataTransferItem （drag data item kindは"file"、drag data item type stringはファイルまたはクリップボード部品のMIME型（不明ならapplication/octet-stream））として作成する。

      2. file-infoを新しいFile オブジェクト（nameはHTML属性内容の名前部分、lastModifiedは参照ファイルのタイムスタンプまたはクリップボード部品参照なら0）として作成する。

      3. new-file-dataの内部File オブジェクトにfile-infoを設定する。

      4. new-file-dataをclipboard-event-dataのitems に追加し、そのエントリのインデックスをitemNumberとする（DataTransferItemList内）。

   3. ローカルファイルやクリップボード部品を参照していたDOM属性を 'cid:'＋itemNumber の文字列に更新する。

5. 処理後のDOMをシリアライズし、そのHTMLコードでnew-dataを更新する。

6. new-dataをclipboard-event-dataのitems に追加する。