ファイルとディレクトリー項目 API

ファイルとディレクトリー項目 API (File and Directory Entries API) は、ウェブアプリケーションが移動してファイルにアクセスできるローカルファイルシステムをシミュレートします。サンドボックス化された仮想的なファイルシステムで、ファイルやディレクトリーの読み書きや作成を行うアプリを開発することができます。

ファイルシステムへのアクセス権の取得

仕様の現在の草案で定義されているファイルシステムへのアクセスを取得する方法は 2 つあります。

ドラッグ＆ドロップで drop イベントを扱う際、 DataTransferItem.webkitGetAsEntry() を呼び出すとドロップされたアイテムの FileSystemEntry を取得することができます。結果が null でなかった場合、これはドロップされたファイルまたはディレクトリーであり、ファイルシステム呼び出しを使用して取り扱うことができます。
HTMLInputElement.webkitEntries プロパティでは、現在選択されているファイルの FileSystemFileEntry オブジェクトにアクセスすることができますが、これはファイル選択へドラッグ＆ドロップされた場合に限られます（Firefox バグ 1326031）。 HTMLInputElement.webkitdirectory が true である場合、 <input> 要素はディレクトリーピッカーとなり、それぞれの選択されたディレクトリーの FileSystemDirectoryEntry オブジェクトを取得できます。

インターフェイス

ファイルとディレクトリー項目 API には以下のインターフェイスがあります。

FileSystem: ファイルシステムを表します。
FileSystemEntry: ファイルシステムにおける単一の項目を表現する基本インターフェイス。ファイルやディレクトリーを表現する他のインターフェイスによって実装される。
FileSystemFileEntry: ファイルシステム内の単一のファイルを表します。
FileSystemDirectoryEntry: ファイルシステム内の単一のディレクトリーを表します。
FileSystemDirectoryReader: FileSystemDirectoryEntry.createReader() を呼び出すことで生成され、このインターフェイスはディレクトリーの内容を読み取る機能を提供します。