FileReader.EMPTY - 0 (データの読み込みを開始していない)
EMPTYは、FileReaderの定数です。0を返します。この値は、データの読み込みをまだ開始していない状態を表します。
概要
- 名前
- EMPTY
- 所属
- FileReader
- IDL
const unsigned short EMPTY = 0;
- 仕様書
- https://w3c.github.io/FileAPI/#dfn-empty
チュートリアル
この定数は、readyStateの値と照合するために使います。下記はデータの読み込みを開始していない状態であることを確認する例です。
var fileReader = new FileReader() ;
if ( fileReader.readyState === FileReader.EMPTY ) {
console.log( "まだ読み込みを開始していません。" ) ;
}
デモ
FileReader.EMPTYのデモです。
<!-- このコードは編集できます。 -->
<!DOCTYPE html>
<html>
<head>
<style>
body {
white-space: pre-wrap ;
}
</style>
</head>
<body>
<script>
/** try it! **/
var fileReader = new FileReader() ;
var a = FileReader.EMPTY ;
var b = fileReader.EMPTY ;
/** try it! **/
var results = { a:a, b:b, } ;
for( var name in results ) {
console.log( name, results[name] ) ;
document.body.appendChild( new Text( name + " = " + JSON.stringify( results[name] ) + "\n" ) ) ;
}
</script>
</body>
</html>
サポート状況
Chrome | Firefox | Safari | Edge | IE | Opera | iOS Safari | Android |
---|---|---|---|---|---|---|---|
● | ● | ● 6.0+ | ● | ● 10+ | ● | ● 6.0+ | ● 4.0+ |
関連記事
- FileReader.onload
- onloadは、FileReaderのイベントです。データの読み込みが正常に完了した時にloadイベントが発生し、ここに設定したコールバック関数が呼び出されます。
- FileReader.result
- resultは、FileReaderのプロパティです。読み込んだデータを返します。データの型は、読み込む時にどのメソッドを実行したかで変わります。
- abortイベント
- abortイベントは、読み込みを中止した時に発生するイベントです。
- FileReader.abort()
- abort()は、FileReaderのメソッドです。ファイルの読み込みを中止するメソッドです。ローカル環境のファイルは、データサイズがよほど大きくない限りはすぐに読み込みが完了するし、データサイズが大きいと今度はブラウザがフリーズしてしまいます。その意味で、なかなか使う機会がないメソッドといえるかもしれません。読み込みを中止するとabortイベントが発生します。