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

Флэнаган Дэвид
Шрифт:

onprogress

Возбуждается примерно 20 раз в секунду, пока выполняется чтение данных из объекта

File
или
Blob
. Объект
ProgressEvent
позволяет узнать количество прочитанных байтов, а свойство
result
объекта
FileReader
может содержать представление этих байтов.

FileReaderSync

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

Объект

FileReaderSync
является синхронной версией объекта
FileReader
, доступной только в фоновых потоках выполнения, представленных объектами
Worker
. Синхронный интерфейс проще в использовании, чем асинхронный: достаточно просто создать объект вызовом конструктора
FileReaderSync
и затем вызвать один из его методов чтения, который либо вернет содержимое объекта
File
или
Blob
, либо возбудит объект
FileError
.

Конструктор

new FileReaderSync

Новый объект

FileReaderSync
создается с помощью конструктора
FileReaderSync
, который не требует аргументов.

Методы

Следующие методы возбуждают объект

FileError
, если операция чтения потерпит неудачу по каким-либо причинам.

ArrayBuffer readAsArrayBuffer(Blob blob)

Читает байты из объекта

blob
и возвращает их в виде объекта
ArrayBuffer
.

string readAsBinaryString(Blob blob)

Читает байты из объекта

blob
, преобразует их в двоичную строку (
String.fromChar-Code
) и возвращает ее.

string readAsDataURL(Blob blob)

Читает байты из объекта

blob
, преобразует их с учетом свойства
type
объекта
blob
в URL-адрес data:// и возвращает его.

string readAsText(Blob blob, [string encoding])

Читает байты данных из объекта

blob
, декодирует их с использованием кодировки
encoding
(или с использованием кодировки UTF-8 или UTF-16, если аргумент
encoding
не указан) и возвращает полученную строку.

Form

тег <form> в HTML-документе (Node, Element)

Объект

Form
представляет элемент
<form>
в HTML-документе. Свойство
elements
– это объект
HTMLCollection
, который дает удобный доступ ко всем элементам в форме. Методы
submit
и
reset
позволяют программным способом отправлять данные формы или сбрасывать все элементы формы в значения, предлагаемые по умолчанию. Каждая форма в документе представлена элементом массива
document.forms[].
Элементы формы (кнопки, поля ввода, переключатели и т. д.) собраны в объекте
Form.elements
, подобном массиву. К именованным элементам форм можно обращаться непосредственно по имени - имя элемента выступает в качестве имени свойства объекта
Form
. Другими словами, обратиться к элементу
Input
со значением «phone» в свойстве
name
в форме f можно посредством JavaScript-выражения
f.phone
.

Подробнее об HTML-формах рассказывается в разделе 15.9. Кроме того, дополнительную информацию об элементах форм можно найти в справочных статьях

FormControl, FieldSet, Input, Label, Select
и
TextArea
.

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

Свойства

Большинство свойств, перечисленных ниже, просто соответствуют HTML-атрибутам с теми же именами,

string acceptCharset

Список из одного или более допустимых кодировок символов, которые могут использоваться для кодирования данных формы при отправке.

string action

URL-адрес, по которому должна быть отправлена форма.

string autocomplete

Строка «оn» или «off». Если содержит строку «оn», броузер будет предварительно заполнять элементы формы значениями, сохраненными при предыдущем посещении страницы.