ファイルとディレクトリー項目 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()
を呼び出すことで生成され、このインターフェイスはディレクトリーの内容を読み取る機能を提供します。
仕様書
Specification |
---|
File and Directory Entries API # api-domfilesystem |
ブラウザーの互換性
BCD tables only load in the browser