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

<b>оnореп</b>
Вызывается при открытии соединения. Обработчику передается простой объект
<b>Event</b>
.

EventTarget

объект, способный принимать события

Объекты, для которых генерируются события, и объекты, которые находятся на пути всплывающих событий, должны предоставлять возможность определять обработчики этих событий. Такие объекты обычно определяют свойства обработчиков событий, имена которых начинаются с префикса «оn» и, как правило, определяют методы, описываемые ниже. Регистрация обработчиков событий - поразительно сложная тема. За подробностями обращайтесь к разделу 17.2 и обратите внимание, что ІE версии 8 и ниже использует другие методы, чем все остальные броузеры; эти методы будут описаны в специальном разделе ниже.

Методы

<b>void addEventListener(string type,function listener,[boolean useCapture])</b>

Регистрирует функцию

<b>listener</b>
в качестве обработчика событий типа type. Аргумент type - строка с именем без префикса «оn». Аргумент useCapture должен иметь значение true, если регистрируется перехватывающий обработчик (раздел 17.2.3) в предке элемента, являющегося истинной целью события. Обратите внимание, что некоторые броузеры все еще требуют передачи этой функции третьего аргумента, поэтому при регистрации обычного, неперехватывающего, обработчика в третьем аргументе следует передавать false,

<b>boolean dispatchEvent(Event event)</b>

Отправляет данному элементу искусственное событие event. Чтобы отправить событие, необходимо создать новый объект

<b>Event</b>
вызовом метода
<b>document.createEvent()</b>
с именем события (таким как «Events», в случае простого события). Затем инициализировать его методом инициализации созданного объекта
<b>Event</b>
: для простых событий - вызовом метода
<b>initEvent()</b>
(см.
<b>Event</b>
). После этого отправить инициализированное событие, передав его рассматриваемому методу. В современных броузерах каждый объект
<b>Event</b>
имеет свойство
<b>isTrusted</b>
. Для искуственных событий, посылаемых программно, это свойство будет иметь значение false. Различные типы объектов событий определяют собственные методы инициализации. Эти методы редко используются на практике, имеют длинные списки аргументов и не описываются в этой книге. Если вам потребуется создать, инициализировать и послать искуственное событие, более сложное, чем простой объект
<b>Event</b>
, поищите описание соответствующего метода инициализации в электронной документации.

<b>void removeEventListener(string type, function listener, [boolean useCapture])</b>

Удаляет зарегистрированный обработчик

<b>listener</b>
события. Принимает те же аргументы, что и метод
<b>addEventListener().</b>

Методы Internet Explorer

IE версии 8 и ниже не поддерживает методы

<b>addEventListener()</b>
и
<b>removeEventListener().</b>
Вместо них он реализует два более простых метода, которые описываются ниже. (Некоторые важные отличия перечислены в разделе 17.2.4.)

<b>void attachEvent(string type, function listener)</b>

Регистрирует функцию

<b>listener</b>
как обработчик событий типа type. Обратите внимание, что этот метод требует, чтобы имя в аргументе type включало префикс «оn».

<b>void detachEvent(string type, function listener)</b>

Этот метод действует как обратный методу

<b>attachEvent().</b>

FieldSet

элемент <fieldset> в HTML-формах (Node, Element, FormControl)

Объект

<b>FieldSet</b>
представляет элемент
<b>&lt;fieldset&gt;</b>
в HTML-формах
<b>&lt;form&gt;.</b>
Объекты
<b>FieldSet</b>
реализуют многие, но не все свойства и методы интерфейса
<b>FormControl</b>
.

Свойства

<b>boolean disabled</b>

Значение true, если объект

<b>FieldSet</b>
находится в неактивном состоянии. Деактивация элемента
<b>FieldSet</b>
деактивирует содержащиеся в нем элементы форм.

<b>readonly HTMLFormControlsCollection elements</b>

Объект, подобный массиву, содержащий все элементы форм, имеющиеся внутри тега

<b>&lt;fieldset&gt;.</b>

File

файл в локальной файловой системе (Blob)

Тип

<b>File</b>
является подтипом
<b>Blob</b>
. Объект
<b>File</b>
имеет имя и, возможно, дату последнего изменения. Он представляет файл в локальной файловой системе. Получить выбранный пользователем файл можно из массива
<b>files</b>
элемента
<b>&lt;input type=file&gt;</b>
или из массива
<b>files</b>
объекта DataTransfer, связанного с объектом
<b>Event</b>
, который получает обработчик события «drop».

Имеется также возможность получить объекты

<b>File</b>
, представляющие файлы в закрытой, изолированной файловой системе, как описано в разделе 22.7. Однако на момент написания этих строк прикладной интерфейс доступа к файловой системе оставался нестабильным, поэтому он не описывается в этом справочнике.

Содержимое файла можно выгрузить на сервер с помощью объекта

<b>FormData</b>
или передав объект
<b>File</b>
методу
<b>XMLHttpRequest.send(),</b>
однако непосредственно с объектом File можно выполнить не очень много операций. Чтобы прочитать содержимое файла, следует использовать объект
<b>FileReader</b>
(или любой объект
<b>Blob</b>
).

Свойства