Дата последнего изменения файла или null, если эта информация недоступна.
readonly string name
Имя файла (без пути к нему).
FileError
ошибка, возникшая во время чтения файла
Объект
FileError
представляет ошибку, возникшую при чтении файла с помощью объекта
FileReader
или
FileReaderSync
. Если использовался синхронный прикладной интерфейс, возбуждается непосредственно объект
FileError
. При использовании асинхронного прикладного интерфейса объект
FileError
передается обработчику в виде значения свойства
error
объекта
FileReader
.
Обратите внимание, что прикладной интерфейс объекта
FileWriter
(который описывается в разделе 22.7, но пока остается недостаточно стабильным, чтобы его можно было описать в этом справочнике) добавляет в этот объект новые константы с кодами ошибок.
Константы
Ниже перечислены коды ошибок в объекте
FileError
:
unsigned short N0T_F0UND_ERR = 1
Файл не существует. (Возможно, был удален после того, как пользователь выбрал его, но перед тем, как программа попыталась прочитать его.)
unsigned short SECURITY_ERR = 2
Неопределенная проблема, связанная с безопасностью, вынуждающая броузер запретить вашей программе читать файл,
unsigned short AB0RT_ERR = З
Операция чтения файла была прервана.
unsigned short NOT_READABLE_ERR = 4
Файл недоступен для чтения, возможно, потому что изменились права доступа к нему или другой процесс заблокировал файл.
unsigned short ENCODING_ERR = 5
Вызов
readAsDatallRL
потерпел неудачу, потому что файл оказался слишком длинным, чтобы представить его в виде URL-адреса data://.
Свойства
readonly unsigned short code
Это свойство определяет тип возникшей ошибки. Это свойство получает значение одной из констант, перечисленных выше.
FileReader
асинхронный интерфейс чтения объекта File или Blob (EventTarget)
Объект
FileReader
определяет асинхронный прикладной интерфейс чтения содержимого объекта
File
или любого объекта
Blob
. Чтобы прочитать файл, следует выполнить следующие действия:
• Создать объект
FileReader
вызовом конструктора
FileReader.
• Определить необходимые обработчики событий.
• Передать объект
File
или
Blob
одному из четырех методов чтения.
• Затем, когда будет вызван обработчик
onload
,
содержимое файла будет доступно в свойстве
result
. Или, если будет вызван обработчик
отеrror
, свойство
error
будет ссылаться на объект
FileError
, содержащий дополнительную информацию.
• После окончания операции чтения при необходимости можно повторно использовать объект
FileReader
или удалить его и создать новый.
Синхронный прикладной интерфейс, который можно использовать в фоновых потоках выполнения, описывается в справочной статье
FileReaderSync
.
Конструктор
new FileReader
Новый объект
FileReader
создается с помощью конструктора
FileReader,
который не требует аргументов.
Константы
Следующие константы определяют возможные значения свойства
readyState
:
unsigned short EMPTY = 0
Метод чтения еще не был вызваню
unsigned short LOADING = 1
Выполняется операция чтенияю
unsigned short DONE = 2
Операция чтения завершилась, успешно или с ошибкой.
Свойства
readonly FileError error
Если ошибка возникнет во время чтения, это свойство будет ссылаться на объект
FileError
, описывающий ошибку.
readonly unsigned short readyState
Это свойство описывает текущее состояние объекта
FileReader
. Его значением будет одна из трех констант, перечисленных выше.
readonly any result
Если операция чтения завершится успешно, это свойство будет хранить содержимое объекта
File
или
Blob
в виде строки или объекта
ArrayBuffer
(в зависимости от использовавшегося метода чтения). Когда свойство
readyState
имеет значение LOADING или когда возбуждается событие «progress», это свойство может хранить неполное содержимое объекта
File
или
Blob
. Если метод чтения еще не был вызван или если возникла ошибка, это свойство будет иметь значение null.
Методы
void abort
Прерывает операцию чтения. Он присваивает свойству
readyState
значение DONE, свойству
result
– значение null и свойству
error
– объект
FileError
со свойством
code
, установленным в значение FileError.AB0RT_ERR. После этого возбуждаются события «abort» и «loadend».