Возбуждается примерно 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», броузер будет предварительно заполнять элементы формы значениями, сохраненными при предыдущем посещении страницы.
readonly HTMLFormControlsCollection elements
Объект, подобный массиву, содержащий элементы формы.
string enctype
Определяет способ кодирования значений элементов формы при отправке. Допустимыми значениями являются:
• «application/x-www-form-urlencoded» (по умолчанию)
• «multipart/form-data»
• «text/plain»
readonly long length
Количество элементов формы, представляемых свойством
elements
. Формы действуют, как если бы они сами были объектами, подобными массивам, содержащими элементы форм, поэтому для формы f и целого числа n выражение f[n] будет эквивалентно выражению
f.elements[n].
string method
HTTP-метод отправки формы по URL-адресу в свойстве
action
. Может иметь значение «get» или «post».
string name
Имя формы, определяемое HTML-атрибутом
name
. Значение этого свойства можно использовать в качестве имени свойства объекта документа, значением которого будет данный объект