SYNCERのロゴ
アイキャッチ画像

FileReader.abort() - 読み込みを中止する

abort()は、FileReaderのメソッドです。ファイルの読み込みを中止するメソッドです。ローカル環境のファイルは、データサイズがよほど大きくない限りはすぐに読み込みが完了するし、データサイズが大きいと今度はブラウザがフリーズしてしまいます。その意味で、なかなか使う機会がないメソッドといえるかもしれません。読み込みを中止するとabortイベントが発生します。

概要

名前
abort
所属
FileReader
IDL
void abort();
仕様書
https://w3c.github.io/FileAPI/#dfn-abort

説明

このメソッドに引数はありません。返り値もありません。

チュートリアル

メソッドを利用して読み込みを中止する例です。

<input type="file" multiple id="hoge">
// 要素を取得
var element = document.getElementById( "hoge" ) ;

// 読み込むファイル
var file = element.files[0] ;

// FileReaderを作成
var fileReader = new FileReader() ;

// 読み込みを実行
fileReader.readAsDataURL( file ) ;

// 読み込みを中止
fileReader.abort() ;

デモ

ファイルを選択すると、読み込みを開始し、その読み込みを中止します。コメントアウトをしてabort()をしないパターンも試してみて下さい。

<!-- このコードは編集できます。 -->

<!DOCTYPE html>
<html>
<head>
<style>
	div#result { white-space: pre-wrap ; }
	input { width: 95% ; font-size: 16px ; }
</style>
</head>
<body>
	<input type="file" multiple id="hoge">
<hr>
	<div id="result"></div>
<script>
var element = document.getElementById( "hoge" ) ;
var resultElement = document.getElementById( "result" ) ;

element.onchange = function () {
	var fileReader = new FileReader() ;

	fileReader.onload = function () {
		console.log( this.result ) ;
		resultElement.appendChild( new Text( "読み込みが完了しました!!" ) ) ;
	}

	fileReader.onabort = function ( event ) {
		console.log( event ) ;
		resultElement.appendChild( new Text( "読み込みを中止しました!!" ) ) ;
	}

	var file = element.files[0] ;
	fileReader.readAsText( file ) ;

	fileReader.abort() ;	// コメントアウトをしてみよう!
}
</script>
</body>
</html>

サポート状況

ChromeFirefoxSafariEdgeIEOperaiOS SafariAndroid
6.0+ 10+ 6.0+ 4.0+
  • Twitterでシェア
  • Facebookでシェア
  • Google+でシェア
  • はてなブックマークでシェア
  • pocketに保存
  • LINEでシェア
更新履歴
2017年10月4日 (水)
コンテンツを公開しました。