<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».
