JavaScript. Подробное руководство, 6-е издание, стр. 488

<b>readonly Date lastModifiedDate</b>

Дата последнего изменения файла или null, если эта информация недоступна.

<b>readonly string name</b>

Имя файла (без пути к нему).

FileError

ошибка, возникшая во время чтения файла

Объект

<b>FileError</b>
представляет ошибку, возникшую при чтении файла с помощью объекта
<b>FileReader</b>
или
<b>FileReaderSync</b>
. Если использовался синхронный прикладной интерфейс, возбуждается непосредственно объект
<b>FileError</b>
. При использовании асинхронного прикладного интерфейса объект
<b>FileError</b>
передается обработчику в виде значения свойства
<b>error</b>
объекта
<b>FileReader</b>
.

Обратите внимание, что прикладной интерфейс объекта

<b>FileWriter</b>
(который описывается в разделе 22.7, но пока остается недостаточно стабильным, чтобы его можно было описать в этом справочнике) добавляет в этот объект новые константы с кодами ошибок.

Константы

Ниже перечислены коды ошибок в объекте

<b>FileError</b>
:

<b>unsigned short N0T_F0UND_ERR = 1</b>

Файл не существует. (Возможно, был удален после того, как пользователь выбрал его, но перед тем, как программа попыталась прочитать его.)

<b>unsigned short SECURITY_ERR = 2</b>

Неопределенная проблема, связанная с безопасностью, вынуждающая броузер запретить вашей программе читать файл,

<b>unsigned short AB0RT_ERR = З</b>

Операция чтения файла была прервана.

<b>unsigned short NOT_READABLE_ERR = 4</b>

Файл недоступен для чтения, возможно, потому что изменились права доступа к нему или другой процесс заблокировал файл.

<b>unsigned short ENCODING_ERR = 5</b>

Вызов

<b>readAsDatallRL()</b>
потерпел неудачу, потому что файл оказался слишком длинным, чтобы представить его в виде URL-адреса data://.

Свойства

<b>readonly unsigned short code</b>

Это свойство определяет тип возникшей ошибки. Это свойство получает значение одной из констант, перечисленных выше.

FileReader

асинхронный интерфейс чтения объекта File или Blob (EventTarget)

Объект

<b>FileReader</b>
определяет асинхронный прикладной интерфейс чтения содержимого объекта
<b>File</b>
или любого объекта
<b>Blob</b>
. Чтобы прочитать файл, следует выполнить следующие действия:

• Создать объект

<b>FileReader</b>
вызовом конструктора
<b>FileReader().</b>

• Определить необходимые обработчики событий.

• Передать объект

<b>File</b>
или
<b>Blob</b>
одному из четырех методов чтения.

• Затем, когда будет вызван обработчик

<b>onload</b>
, содержимое файла будет доступно в свойстве
<b>result</b>
. Или, если будет вызван обработчик
<b>отеrror</b>
, свойство
<b>error</b>
будет ссылаться на объект
<b>FileError</b>
, содержащий дополнительную информацию.

• После окончания операции чтения при необходимости можно повторно использовать объект

<b>FileReader</b>
или удалить его и создать новый.

Синхронный прикладной интерфейс, который можно использовать в фоновых потоках выполнения, описывается в справочной статье

<b>FileReaderSync</b>
.

Конструктор

<b>new FileReader()</b>

Новый объект

<b>FileReader</b>
создается с помощью конструктора
<b>FileReader(),</b>
который не требует аргументов.

Константы

Следующие константы определяют возможные значения свойства

<b>readyState</b>
:

<b>unsigned short EMPTY = 0</b>

Метод чтения еще не был вызваню

<b>unsigned short LOADING = 1</b>

Выполняется операция чтенияю

<b>unsigned short DONE = 2</b>

Операция чтения завершилась, успешно или с ошибкой.

Свойства

<b>readonly FileError error</b>

Если ошибка возникнет во время чтения, это свойство будет ссылаться на объект

<b>FileError</b>
, описывающий ошибку.

<b>readonly unsigned short readyState</b>

Это свойство описывает текущее состояние объекта

<b>FileReader</b>
. Его значением будет одна из трех констант, перечисленных выше.

<b>readonly any result</b>

Если операция чтения завершится успешно, это свойство будет хранить содержимое объекта

<b>File</b>
или
<b>Blob</b>
в виде строки или объекта
<b>ArrayBuffer</b>
(в зависимости от использовавшегося метода чтения). Когда свойство
<b>readyState</b>
имеет значение LOADING или когда возбуждается событие «progress», это свойство может хранить неполное содержимое объекта
<b>File</b>
или
<b>Blob</b>
. Если метод чтения еще не был вызван или если возникла ошибка, это свойство будет иметь значение null.

Методы

<b>void abort()</b>

Прерывает операцию чтения. Он присваивает свойству

<b>readyState</b>
значение DONE, свойству
<b>result</b>
- значение null и свойству
<b>error</b>
- объект
<b>FileError</b>
со свойством
<b>code</b>
, установленным в значение FileError.AB0RT_ERR. После этого возбуждаются события «abort» и «loadend».