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

Методы

<b>boolean checkValidity()</b>

Возвращает true, если элемент формы содержит корректные данные (или если этот элемент не подвергается проверке). Иначе возбуждает событие «invalid» в данном элементе и возвращает false.

<b>void setCustomValidity(string error)</b>

Если в аргументе error передать непустую строку, этот метод пометит данный элемент формы как содержащий недопустимые данные и будет использовать аргумент error как локализованное сообщение, чтобы известить пользователя о причинах. Если передать в аргументе error пустую строку, все предыдущие строки error будут удалены, а объект будет помечен как содержащий допустимые данные.

Form Data

тело HTTP-запроса multipart/form-data

Тип

<b>FormData</b>
является частью спецификации «XMLHttpRequest Level 2» (XHR2), которая упрощает отправку данных в формате «multipart/form-data» в виде НТТР-за-просов PUT с помощью объекта
<b>XMLHttpRequest</b>
. Использование этого формата необходимо, например, когда в одном запросе требуется выгрузить несколько объектов
<b>File</b>
. Создайте объект
<b>FormData</b>
с помощью конструктора и затем добавьте в него пары имя/значение с помощью метода
<b>append().</b>
После того как будут добавлены все части, составляющие тело запроса, объект
<b>FormData</b>
можно передать методу
<b>send()</b>
объекта
<b>XMLHttpRequest</b>
.

Конструктор

<b>new FormData()</b>

Этот конструктор, не имеющий аргументов, возвращает пустой объект FormData.

Методы

<b>void append(string name, any value)</b>

Добавляет в объект

<b>FormData</b>
новую часть с именем 
<b>name</b>
и значением
<b>value</b>
. Аргумент
<b>value</b>
может быть строкой или объектом
<b>Blob</b>
(напомню, что
тип
File является подтипом
<b>Blob</b>
).

FormValidity

реализует проверку элемента формы

Свойство

<b>validity</b>
объекта
<b>FormControl</b>
ссылается на объект
<b>FormValidity</b>
, который является представлением признака корректности данных в этом элементе формы. Если свойство
<b>valid</b>
имеет значение false, элемент формы содержит недопустимые данные и по крайней мере одно из других свойств, определяющих природу ошибки (или ошибок), будет иметь значение true.

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

Свойства

<b>readonly boolean customError</b>

Сценарий вызвал метод

<b>FormControl.setCustomValidity()</b>
данного элемента.

<b>readonly boolean patternMismatch</b>

Введенные данные не соответствуют регулярному выражению.

<b>readonly boolean rangeOverflow</b>

Объем введенных данных слишком велик.

<b>readonly boolean rangeUnderflow</b>

Объем введенных данных слишком мал.

<b>readonly boolean stepMismatch</b>

Введенные данные не соответствуют указанному шагу.

<b>readonly boolean tooLong</b>

Объем введенных данных слишком велик.

<b>readonly boolean typeMismatch</b>

Введенные данные имеют неверный тип.

<b>readonly boolean valid</b>

Если это свойство имеет значение true, элемент формы содержит корректные данные и все другие свойства имеют значение false. Если это свойство имеет значение false, элемент формы содержит недопустимые данные и, по крайней мере, одно из других свойств имеет значение true.

<b>readonly boolean valueMissing</b>

Элемент формы пуст, хотя он должен быть заполнен.

Geocoordinates

географическое местонахождение

Объект этого типа является представлением точки на поверхности Земли.

Свойства

<b>readonly double accuracy</b>

Точность определения широты и долготы (свойства

<b>latitude</b>
и
<b>longitude</b>
) в метрах.

<b>readonly double altitude</b>

Высота над уровнем моря в метрах или null, если информация о высоте недоступна.

<b>readonly double altitudeAccuracy</b>

Точность определения высоты (свойство

<b>altitude</b>
) над уровнем моря в метрах. Если свойство
<b>altitude</b>
имеет значение null, свойство
<b>altitudeAccuracy</b>
также будет иметь значение null.

<b>readonly double heading</b>

Направление движения пользователя в градусах относительно направления на истинный север или null, если информация о направлении недоступна. Если информация о высоте доступна, но скорость (свойство speed) движения равна нулю, то свойство heading будет иметь значение NaN.

<b>readonly double latitude</b>

Широта местоположения пользователя в градусах с долями к северу от экватора.

<b>readonly double longitude</b>

Долгота местоположения пользователя в градусах с долями к востоку от Гринвичского меридиана.

<b>readonly double speed</b>

Скорость движения пользователя в метрах в секунду или null, если информация о скорости недоступна. Это свойство никогда не принимает отрицательные значения. См. также heading.

Geolocation

позволяет получить широту и долготу местоположения пользователя

Объект

<b>Geolocation</b>
определяет методы, позволяющие получить точные географические координаты местоположения пользователя. В броузерах, поддерживающих такую возможность, объект
<b>Geolocation</b>
можно получить через объекта
<b>Navigator</b>
, обратившись к свойству
<b>navigator.geolocation</b>
. Методы, описываемые ниже, опираются на использование некоторых других типов: местоположение определяется в форме объекта
<b>Geoposition</b>
, а ошибки - в форме объектов
<b>GeolocationError</b>
.