readAsText メソッドは、 指定された Blob ないし File オブジェクトを読み込むために使用します。 読込処理が終了すると readyState は DONE に変わり、loadend イベントが生じます。それと同時に result プロパティにはファイルの内容が文字列として格納されます。
構文
instanceOfFileReader.readAsText(blob[, encoding]);
パラメータ
blob- メソッドで読み込む
BlobまたはFileオブジェクトです。 - encoding Optional
- 読込の際に使用する文字エンコーディングを指定する文字列です。パラメータ未指定の場合は UTF-8 で解釈されます。
仕様
| Specification | Status | Comment |
|---|---|---|
| File API The definition of 'FileReader' in that specification. |
Working Draft | Initial definition. |
ブラウザ実装状況
| Feature | Firefox (Gecko) | Chrome | Internet Explorer* | Opera* | Safari |
|---|---|---|---|---|---|
| Basic support | 3.6 (1.9.2) | 7 | 10 | 12.02 | 6.0.2 |
| Feature | Firefox Mobile (Gecko) | Android | IE Mobile | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|
| Basic support | 32 | 3 | 10 | 11.5 | 6.1 |
Implementation notes
- IE9 has a File API Lab.
- Opera has partial support in 11.1.
Gecko-specific notes
- Prior to Gecko 2.0 beta 7 (Firefox 4.0 beta 7), all
Blobparameters below wereFileparameters; this has since been updated to match the specification correctly. - Prior to Gecko 13.0 (Firefox 13.0 / Thunderbird 13.0 / SeaMonkey 2.10) the
FileReader.errorproperty returned aFileErrorobject. This interface has been removed andFileReader.erroris now returning theDOMErrorobject as defined in the latest FileAPI draft.