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

, описывающий ошибку.

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

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

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

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

Методы

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

значение DONE, свойству – значение null и свойству – объект со свойством , установленным в значение FileError.AB0RT_ERR. После этого возбуждаются события «abort» и «loadend».

• Асинхронно читает данные из объекта

и сохраняет их в свойстве в виде объекта .

Асинхронно читает байты данных из объекта

, преобразует их в двоичную строку и сохраняет ее в свойстве . Каждый «символ» в двоичной строке представлен кодом символа в диапазоне от 0 до 255. Извлекать эти значения байтов можно с помощью метода Следует отметить, что двоичные строки являются не самым эффективным представлением двоичных данных: вместо них следует использовать объекты , когда это возможно.

Асинхронно читает байты данных из объекта

, преобразует их (учитывая тип объекта ) в URL-адрес data:// и присваивает полученную строку свойству .

Асинхронно читает байты данных из объекта

, декодирует их с использованием кодировки encoding в текстовую строку Юникода и затем присваивает полученную строку свойству . Если аргумент encoding не указан, используется кодировка UTF-8 (текст в кодировке UTF-16 определяется и декодируется автоматически, если он начинается с маркера Byte Order Mark).

Обработчики событий

Подобно всем асинхронным прикладным интерфейсам, в своей работе объект

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

События объекта

возбуждаются в самом объекте . Они не всплывают, и для них не предусматриваются действия по умолчанию. Обработчикам событий в объекте всегда передается объект . Успешная операция чтения начинается с события «loadstart», за которым следует ноль или более событий «progress», событие «load» и событие «loadend». Неудачная операция чтения начинается с события «loadstart», за которым следует ноль или более событий «progress», событие «error» или «abort» и событие «loadend».

Вызывается, если операция чтения была прервана методом

Вызывается, если возникла какая-либо ошибка. Свойство error объекта

будет ссылаться на объект , который имеет свойство code с кодом ошибки.

Вызывается в случае успешного завершения операции чтения объекта

или . Свойство объекта хранит содержимое объекта или в виде, зависящем от использовавшегося метода чтения.

Каждый вызов метода чтения объекта

в конечном итоге возбуждает событие «load», «error» или «abort». Кроме того, после каждого из этих событий объект возбуждает событие «loadend» для программ, в которых было бы желательно обрабатывать единственное событие вместо трех.

Вызывается после вызова метода чтения, но перед тем как будут прочитаны какие-либо данные.