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

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

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

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

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

インターフェイス

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

FileSystem

ファイルシステムを表します。

FileSystemEntry

ファイルシステムにおける単一の項目を表現する基本インターフェイス。ファイルやディレクトリーを表現する他のインターフェイスによって実装される。

FileSystemFileEntry

ファイルシステム内の単一のファイルを表します。

FileSystemDirectoryEntry

ファイルシステム内の単一のディレクトリーを表します。

FileSystemDirectoryReader

FileSystemDirectoryEntry.createReader() を呼び出すことで生成され、このインターフェイスはディレクトリーの内容を読み取る機能を提供します。

仕様書

Specification
File and Directory Entries API
# api-domfilesystem

ブラウザーの互換性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
FileSystem
name
root

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
See implementation notes.

関連情報