File
File インターフェイスは、ファイルについての情報を提供したり、ウェブページ内の JavaScript からその内容にアクセスできるようにしたりします。
File オブジェクトは通常、 <input> 要素を使用してファイルを選択した結果として返される FileList オブジェクト、ドラッグ＆ドロップ操作の DataTransfer オブジェクト、または HTMLCanvasElement 上の mozGetAsFile() API から取得します。
File オブジェクトは特別な種類の Blob オブジェクトであり、 Blob が利用できる場面ではどこでも利用できます。特に、FileReader、URL.createObjectURL()、createImageBitmap()、XMLHttpRequest.send() は、Blob と File の両方を受け付けます。
詳しい情報や例は、ウェブアプリケーションからのファイルの使用 (en-US) を参照してください。
コンストラクター
File()-
新しく構築された
Fileオブジェクトを返します。
インスタンスプロパティ
File.prototype.lastModified読取専用-
ファイルの最終更新時刻を、 UNIX 元期 (1970 年 1 月 1 日深夜) からの経過ミリ秒数で返します。
File.prototype.lastModifiedDateDeprecated 読取専用-
Fileオブジェクトが参照しているファイルの最終更新時刻のDateを返します。 File.prototype.name読取専用-
Fileオブジェクトが参照しているファイルの名前を返します。 File.prototype.webkitRelativePathNon-standard 読取専用-
Fileの URL の相対パスを返します。
File は Blob を実装しているので、以下のようなプロパティも利用できます。
File.prototype.size読取専用-
ファイルのサイズをバイト単位で返します。
File.prototype.type読取専用-
ファイルの MIME タイプを返します。
インスタンスメソッド
File インターフェイスはメソッドを定義せず、Blob インターフェイスからメソッドを継承しています。
Blob.prototype.slice([start[, end[, contentType]]])-
ソース
Blobの指定したバイト数の範囲のデータを含む新しいBlobオブジェクトを返します。 Blob.prototype.stream()-
FileをReadableStreamに変換し、Fileの内容を読み込めるようにします。 Blob.prototype.text()-
Fileをストリームに変換し、最後まで読み込みます。これは、USVString(テキスト) で解決するプロミスを返します。 Blob.prototype.arrayBuffer()-
Fileをストリームに変換し、最後まで読み込みます。ArrayBufferで解決するプロミスを返します。
仕様書
| Specification |
|---|
| File API # file-section |
ブラウザーの互換性
BCD tables only load in the browser
関連情報
- ウェブアプリケーションからのファイルの使用 (en-US)
FileReader- DOM の File API をクロームコードで使う (Firefox アドオンのような Gecko で実行される特権コード向け)