recursal/MDN huggingface dataset:
Coordinates
===========

**Secure context:** This feature is available only in secure contexts (en-US) (HTTPS), in some or all supporting browsers.

Интерфейс **`Coordinates`** отображает позицию устройства и его высоту над уровнем моря с расчётным уровнем точности.

Свойства
--------

*Интерфейс `Coordinates` не наследует никаких свойств*.

`Coordinates.latitude` (en-US) Только для чтения  Secure context

Возвращает `дробное` число, означающее широту, выраженную в градусах.

`Coordinates.longitude` (en-US) Только для чтения  Secure context

Возвращает `дробное` число, означающее долготу, выраженную в градусах.

`Coordinates.altitude` (en-US) Только для чтения  Secure context

Возвращает `дробное` число, означающее высоту над уровнем моря, выраженную в метрах. Возвращает `null`, если устройство не может предоставить эти данные.

`Coordinates.accuracy` (en-US) Только для чтения  Secure context

Возвращает `дробное` число, означающее точность свойств `latitude` и `longitude`, выраженную в метрах.

`Coordinates.altitudeAccuracy` (en-US) Только для чтения  Secure context

Возвращает `дробное` число, означающее точность свойства `altitude`, выраженную в метрах. Может быть `null`.

`Coordinates.heading` (en-US) Только для чтения  Secure context

Возвращает `дробное` число, означающее в каком направлении движется устройство. Это значение, выраженное в градусах, показывает насколько отклонено устройство относительно севера. `0` градусов показывает ровно на север и далее направление определяется по часовой стрелке (то есть, `90` градусов означает восток, а `270` градусов означает запад). Если `speed` равно `0`, то `heading` будет `NaN` (en-US). Если устройство не может предоставить `heading`, то его значение будет `null`.

`Coordinates.speed` (en-US) Только для чтения  Secure context

Возвращает `дробное` число, означающее скорость движения устройства, выраженное в метрах в секунду. Это значение может быть `null`.

Методы
------

**Интерфейс `Coordinates` не наследует никаких методов*.*\*\*

Спецификации
------------

| Specification |
| --- |
| Geolocation API # coordinates\_interface |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Смотрите также
--------------

* Using geolocation (en-US)
* The `Geolocation` interface that uses it.
MediaElementAudioSourceNode
===========================

Интерфейс `MediaElementAudioSourceNode` представляет собой аудио узел `AudioNode`, созданный из HTML5 `<audio>` или `<video>` элемента. Он является источником звука.

`MediaElementSourceNode` не имеет входов, а только один выход, и может быть создан методом `AudioContext.createMediaElementSource`. Количество каналов в выходном сигнале равно числу каналов аудио, на которое ссылается `HTMLMediaElement` используемый для создания узла, или 1, если `HTMLMediaElement` не имеет аудио.

|  |  |
| --- | --- |
| Количество входов | `0` |
| Количество выходов | `1` |
| Количество каналов | 
 зависит от содержимого медиа элемента
 `HTMLMediaElement`, переданному методу
 `AudioContext.createMediaElementSource` при
 создании узла.
  |

Свойства
--------

*Наследует свойства родителя,* *`AudioNode`*.

Методы
------

*Наследует методы родителя,* *`AudioNode`*.

Спецификация
------------

| Specification |
| --- |
| Web Audio API # MediaElementAudioSourceNode |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Смотрите также
--------------

* Using the Web Audio API (en-US)
Comment
=======

Интерфейс **`Comment`** представляет собой текстовые записи в разметке; хотя, в основном, они не отображаются, такие комментарии доступны для чтения в исходном коде. Комментарии представляются в HTML и XML как контент, заключённый между '`<!--`' и '`-->`'. В XML, последовательность символов '`--`' может не использоваться в комментариях.

EventTarget

Node

CharacterData

CommentСвойства
--------

*У этого интерфейса нет конкретных свойств, но он наследует свойства родителя `CharacterData`, и частично `Node`.*

Конструктор
-----------

`Comment()` (en-US) 
Экспериментальная возможность

Возвращает объект `Comment` с параметрами в качестве его текстового содержимого.

Методы
------

*У этого интерфейса нет конкретных методов, но он наследует методы родителя `CharacterData`, и частично `Node`.*

Спецификации
------------

| Specification |
| --- |
| DOM Standard # interface-comment |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Смотрите также
--------------

* The DOM interfaces index
Server-sent events
==================

По традиции, web-страница должна отправить запрос на сервер, чтобы получить новые данные; это то, как страница получает данные с сервера. Server-sent events дают возможность серверу отправлять новые данные web-странице в любое время, отсылая сообщения web-странице. Такие входящие сообщения могут расцениваться как *Events (en-US) + data* внутри web-страницы.

Понятия и применение
--------------------

Чтобы изучить, как использовать server-sent events, обратитесь к статье Using server-sent events.

Interfaces
----------

`EventSource`

Defines all the features that handle connecting to a server, receiving events/data, errors, closing a connection, etc.

Examples
--------

* Simple SSE demo using PHP
Specification
-------------

| Specification |
| --- |
| HTML Standard # server-sent-events |

Совместимость с браузерами
--------------------------

{{Compat}}See also
--------

### Tools

* EventSource polyfill for Node.js
* Remy Sharp's EventSource polyfill
* Yaffle's EventSource polyfill
* Rick Waldron's jquery plugin
* intercooler.js declarative SSE support
### Related Topics

* AJAX
* JavaScript
* WebSockets
### Other resources

* A Twitter like application powered by server-sent events and its code on Github.
* HTML5 and Server-sent events
* Server-sent events using Asp.Net
Глобальная функция clearTimeout()
=================================

Глобальный метод **`clearTimeout()`** отменяет таймаут, ранее установленный вызовом `setTimeout()`.

Синтаксис
---------
```

scope.clearTimeout(timeoutID)
```

### Параметры

`timeoutID`

Идентификатор таймаута, который вы хотите отменить. Этот идентификатор был возвращён соответствующим вызовом `setTimeout()`.

It's worth noting that the pool of IDs used by `setTimeout()` and `setInterval()` are shared, which means you can technically use `clearTimeout()` and `clearInterval()` (en-US) interchangeably. However, for clarity, you should avoid doing so.

Пример использования
--------------------

Запустите приведённый ниже скрипт в контакте веб-страницы и кликните один раз. Вы увидите всплывающее сообщение через 1 секунду. Если вы щёлкните страницу несколько раз за одну секунду, предупреждение появится только один раз.


```js
var alarm = {
  remind: function (aMessage) {
    alert(aMessage);
    this.timeoutID = undefined;
  },

  setup: function () {
    if (typeof this.timeoutID === "number") {
      this.cancel();
    }

    this.timeoutID = window.setTimeout(
      function (msg) {
        this.remind(msg);
      }.bind(this),
      1000,
      "Wake up!",
    );
  },

  cancel: function () {
    window.clearTimeout(this.timeoutID);
  },
};
window.onclick = function () {
  alarm.setup();
};
```

Примечания
----------

Передача недействительного ID `clearTimeout()` ни к чему не приведёт. Исключение не создается.

Спецификации
------------

| Specification |
| --- |
| HTML Standard # dom-cleartimeout-dev |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Смотрите также
--------------

* `setTimeout()`
* `setInterval()`
* `clearInterval()` (en-US)
* `Window.requestAnimationFrame()`
DOMImplementation
=================

Интерфейс **`DOMImplementation`** представляет собой объект, предоставляющий методы, которые не зависят от какого-либо конкретного документа. Такой объект возвращается свойством `Document.implementation` (en-US).

Свойства
--------

*Этот интерфейс не имеет определённого свойства и не наследует его.*

Методы
------

*Нет унаследованного метода.*

`DOMImplementation.createDocument()` (en-US)

Создаёт и возвращает `XMLDocument`.

`DOMImplementation.createDocumentType()` (en-US)

Создаёт и возвращает `DocumentType` (en-US).

`DOMImplementation.createHTMLDocument()`

Создаёт и возвращает HTML `Document`.

`DOMImplementation.hasFeature()` (en-US)

Возвращает `Boolean` (en-US), указывающий, поддерживается ли данная функция или нет. Эта функция ненадёжна и сохраняется только для целей совместимости: за исключением запросов, связанных с SVG, она всегда возвращает true. Старые браузеры очень непоследовательны в своём поведении.

Спецификации
------------

| Specification |
| --- |
| DOM Standard # interface-domimplementation |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Смотрите также
--------------

* The DOM interfaces index.
Gyroscope
=========

**`Gyroscope`** интерфейс Sensor API даёт возможность считать позицию устройства по всем трём осям.

Для использования того сенсора пользователю нужно предоставить доступ устройства к `'gyroscope'` через `Permissions` (en-US) API.

If a feature policy blocks use of a feature it is because your code is inconsistent with the policies set on your server. This is not something that would ever be shown to a user. See `Feature-Policy` (en-US) for implementation instructions.

Конструктор
-----------

`Gyroscope.Gyroscope()` (en-US)

Создание нового `Gyroscope` объекта.

Свойства
--------

`Gyroscope.x` (en-US) Только для чтения 

Возвращает угловое отклонение устройства по оси X.

`Gyroscope.y` (en-US) Только для чтения 

Возвращает угловое отклонение устройства по оси Y.

`Gyroscope.z` (en-US) Только для чтения 

Возвращает угловое отклонение устройства по оси Z.

Примеры
-------

Гироскоп обычно использует `Sensor.onreading` (en-US) событие для вызова колбэк-функции. В примере ниже функция вызывается 6 раз в секунду.


```js
let gyroscope = new Gyroscope({ frequency: 60 });

gyroscope.addEventListener("reading", (e) => {
  console.log("Angular velocity along the X-axis " + gyroscope.x);
  console.log("Angular velocity along the Y-axis " + gyroscope.y);
  console.log("Angular velocity along the Z-axis " + gyroscope.z);
});
gyroscope.start();
```

Спецификации
------------

| Specification |
| --- |
| Gyroscope # gyroscope-interface |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.
Document.origin
===============

**Экспериментальная возможность:** **Это экспериментальная технология**  
Так как спецификация этой технологии ещё не стабилизировалась, смотрите таблицу совместимости по поводу использования в различных браузерах. Также заметьте, что синтаксис и поведение экспериментальной технологии может измениться в будущих версиях браузеров, вслед за изменениями спецификации.

**Document.origin —** это свойство, доступное только для чтения, которое возвращает **origin** документа. В большинстве случаев это свойство эквивалентно `document.defaultView.location.origin.`

Примеры
-------


```js
var origin = document.origin;
// На этой странице вернёт:'https://developer.mozilla.org'

var origin = document.origin;
// Для "about:blank" вернёт:'null'

var origin = document.origin;
// Для "data:text/html,<b>foo</b>" вернёт:'null'
```

Спецификация
------------

| Specification |
| --- |
| HTML Standard # dom-origin-dev |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Смотрите также
--------------

* Свойство `URLUtils.origin`.
Geolocation
===========

Интерфейс **`Geolocation`** представляет возможность программно получит местоположение устройства. Он даёт доступ веб-содержимому к позиции пользователя. Это также помогает сайтам и приложениям предоставлять результаты, основываясь полученных данных.

Объект с этим интерфейсом получается с помощью свойства `NavigatorGeolocation.geolocation` (en-US) и реализуется объектом `Navigator`.

**Примечание:** По некоторым причинам, связанным с безопасностью, когда веб-страница пытается получить доступ к местоположению, пользователь будет уведомлен, а также будет запрошено разрешение. Имейте в виду, что у каждого браузера есть свои политики и методы для запроса этого разрешения.

Свойства
--------

*Интерфейс `Geolocation` ни реализует, ни наследует никаких свойств.*

Методы
------

**Интерфейс `Geolocation` не наследует никаких методов**.

`Geolocation.getCurrentPosition()` Secure context

Определяет местоположение устройства и возвращает объект `Position` (en-US) с данными.

`Geolocation.watchPosition()` (en-US) Secure context

Возвращает `long` значение, предоставляет вновь созданную колбэк-функцию, вызываемую при изменении местоположения устройства.

`Geolocation.clearWatch()` (en-US) Secure context

Удаляет обработчик, созданный с помощью `watchPosition()`.

Спецификации
------------

| Specification |
| --- |
| Geolocation API # geolocation\_interface |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Смотрите также
--------------

* Использование геолокации
VRFrameData
===========

**Устарело:** Эта возможность была удалена из веб-стандартов. Хотя некоторые браузеры по-прежнему могут поддерживать её, она находится в процессе удаления. Не используйте её ни в старых, ни в новых проектах. Страницы или веб-приложения, использующие её, могут в любой момент сломаться.

**Не стандартно:** Эта возможность не является стандартной и стандартизировать её пока никто не собирается. Не используйте её на сайтах, смотрящих во внешний мир: она будет работать не у всех пользователей. Также могут присутствовать большие несовместимости между реализациями и её поведение может в будущем измениться.

Интерфейс **`VRFrameData`** из WebVR API предоставляет всю необходимую информацию для отображения одного кадра VR-сцены, создаётся с помощью `VRDisplay.getFrameData()` (en-US).

**Примечание:** Это свойство было частью старого WebVR API, который был заменён на WebXR Device API.

Конструктор
-----------

`VRFrameData()` (en-US) 
Устарело

Non-standard

Создаёт экземпляр объекта `VRFrameData`.

Свойства экземпляра
-------------------

`VRFrameData.leftProjectionMatrix` (en-US) 
Устарело
 Только для чтения  
Non-standard

Массив `Float32Array` (en-US), представляющий матрицу 4x4, которая описывает проекцию отображения для левого глаза.

`VRFrameData.leftViewMatrix` (en-US) 
Устарело
 Только для чтения  
Non-standard

Массив `Float32Array` (en-US), представляющий матрицу 4x4, которая описывает преобразование отображения для левого глаза.

`VRFrameData.pose` (en-US) 
Устарело
 Только для чтения  
Non-standard

Объект `VRPose` (en-US) с данными о положении устройства `VRDisplay` (en-US) в текущий момент времени `VRFrameData.timestamp` (en-US).

`VRFrameData.rightProjectionMatrix` (en-US) 
Устарело
 Только для чтения  
Non-standard

Массив `Float32Array` (en-US), представляющий матрицу 4x4, которая описывает проекцию отображения для правого глаза

`VRFrameData.rightViewMatrix` (en-US) 
Устарело
 Только для чтения  
Non-standard

Массив `Float32Array` (en-US), представляющий матрицу 4x4, которая описывает преобразование отображения для правого глаза.

`VRFrameData.timestamp` (en-US) 
Устарело
 Только для чтения  
Non-standard

Постоянно увеличивающееся значение отметки времени, представляющее время, когда произошло обновление кадра.

Примеры
-------

Смотрите примеры использования в `VRDisplay.getFrameData()` (en-US).

Спецификации
------------

Это свойство было частью старого WebVR API, который был заменён на WebXR Device API. Больше не планируется сделать его стандартом.

Пока все браузеры не реализуют новые WebXR API (en-US), рекомендуется использовать такие фреймворки как A-Frame, Babylon.js, Three.js или полифил для разработки приложений WebXR, которые будут работать во всех браузерах.

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Смотрите также
--------------

* WebVR API
Crypto
======

Интерфейс **`Crypto`** представляет базовые криптографические функции, доступные в общеупотребительном контексте. Он позволяет получить доступ к криптографически сильному генератору случайных чисел и к криптографическим примитивам.

Объект с этим интерфейсом доступен в Web-контексте через свойство `Window.crypto`.

Свойства
--------

*Этот интерфейс реализует свойства, объявленные в `RandomSource` (en-US).*

`Crypto.subtle` (en-US) 
Экспериментальная возможность
Только для чтения 

Возвращает объект `SubtleCrypto`, предоставляющий доступ к часто используемым криптографическим примитивам, таким как хэширование, цифровые подписи, шифрование и расшифрованные.

Методы
------

*Этот интерфейс реализует методы, объявленные в `RandomSource` (en-US).*

`RandomSource.getRandomValues()`

Заполняет переданные `TypedArray` случайными в криптографическом смысле значениями.

Спецификации
------------

| Specification |
| --- |
| Web Cryptography API # crypto-interface |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Смотрите также
--------------

* Components.utils.importGlobalProperties
CSSValue
========

Интерфейс **`CSSValue`** возвращает текущее вычисленное значение CSS-свойства.

Свойства
--------

`CSSValue.cssText` (en-US)

`DOMString` возвращает текущее значение.

`CSSValue.cssValueType` (en-US) Только для чтения 

An `unsigned short` representing a code defining the type of the value. Возможные значения:

| Константа | Описание |
| --- | --- |
| `CSS_CUSTOM` | The value is a custom value. |
| `CSS_INHERIT` | Значение унаследовано и `cssText` содержит `"inherit"`. |
| `CSS_PRIMITIVE_VALUE` | The value is a primitive value and an instance of the `CSSPrimitiveValue` (en-US) interface can be obtained by using binding-specific casting methods on this instance of the `CSSValue` interface. |
| `CSS_VALUE_LIST` | The value is a `CSSValue` list and an instance of the `CSSValueList` (en-US) interface can be obtained by using binding-specific casting methods on this instance of the `CSSValue` interface. |

Specifications
--------------

#### No specification found

No specification data found for `api.CSSValue`.  
Check for problems with this page or contribute a missing `spec_url` to mdn/browser-compat-data. Also make sure the specification is included in w3c/browser-specs.

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

See also
--------

* `CSSPrimitiveValue` (en-US)
* `CSSValueList` (en-US)
ImageData
=========

Интерфейс **`ImageData`** представляет лежащие в основе пиксельные данные области элемента `<canvas>`. Он создан используя конструктор `ImageData()` (en-US) или метод создания объекта `CanvasRenderingContext2D` ассоциированного с canvas: `createImageData()` (en-US) и `getImageData()`. Он также может быть использован для установки части canvas используя метод `putImageData()`.

Конструкторы
------------

`ImageData()` (en-US) 
Экспериментальная возможность

Создаёт ImageData из указанного `Uint8ClampedArray` и из размера изображения которого он содержит. Если массив не указан, то он создаёт изображение чёрного прямоугольника. Обратите внимание, что такой довольно распространённый путь создания подобного объекта в воркерах как `createImageData()` (en-US) там не доступен.

Свойства
--------

`ImageData.data` (en-US) Только для чтения 

Возвращает `Uint8ClampedArray` представляющий собой одномерный массив, содержащий данные цветовой модели RGBA, с целыми значениями от 0 до 255 (включительно).

`ImageData.height` (en-US) Только для чтения 

Фактическая высота в пикселях объекта `ImageData`.

`ImageData.width` (en-US) Только для чтения 

Фактическая ширина в пикселях объекта `ImageData`.

Спецификации
------------

| Specification |
| --- |
| HTML Standard # imagedata |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Смотрите также
--------------

* `CanvasRenderingContext2D`
* The `<canvas>` element and its associated interface, `HTMLCanvasElement`.
HTMLAudioElement
================

**`HTMLAudioElement`** позволяет получить доступ к элементу `<audio>` и имеет DOM-элемент `HTMLMediaElement`.

Свойства
--------

*Не имеет своих свойств; наследует свойства от родителя `HTMLMediaElement` и от `HTMLElement`.*

Методы
------

*Наследует методы от родителя `HTMLMediaElement` и от `HTMLElement`.*

### Конструктор

#### Синтаксис
```

mySound = new Audio([URLString]);
```


#### Описание

Конструктор audio элемента. Свойство `preload` по умолчанию задано как `auto`, а `src` равно значению аргумента *URLString.* Перед воспроизведением, браузер асинхронно загружает объект в кеш и впоследствии берёт данные оттуда.

Параметры

`URLString` (expected type: `DOMString`; optional)

'src' для 'audio' тега. (URL , с которого должен получать mp3 файл)

### Регулярные методы

| Name & Arguments | Return | Description |
| --- | --- | --- |
| `mozCurrentSampleOffset()` 
Non-standard
 | `unsigned long long` | `Отображает текущую нагрузку аудиострима, который был создан методом mozWriteAudio()`. Эта цифра отражает количество сэмплов с момента начала стрима |
| `mozSetup(in PRUint32 channels, in PRUint32 rate)` 
Non-standard
 | `void` | Создаёт аудиострима для записи. Вы можете указать такие параметры, как количество каналов (`1` for mono or `2` for stereo), так и частота сэмпла (`44100` for 44.1kHz, for example). |
| `mozWriteAudio(in jsval data)` 
Non-standard
 | `unsigned long` | Запускает аудио стрим на текущую частоту. Возвращает количество байтов, которые записаны в стрим |

Спецификации
------------

| Specification |
| --- |
| HTML Standard # htmlaudioelement |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Смотрите также
--------------

* HTML element implementing this interface: `<audio>`.
Window.performance
==================

The Web Performance API allows web pages access to certain functions for measuring the performance of web pages and web applications, including the Navigation Timing (en-US) API and high-resolution time data.

Methods
-------

`performance.mark()` (en-US)

Maps a `DOMHighResTimeStamp` to a specified name representing the amount of milliseconds elapsed since a reference instant.

`performance.now()`

Возвращает `DOMHighResTimeStamp` представляющий количество миллисекунд прошедшее с момента отсчёта.

`measure()`

This method stores the `DOMHighResTimeStamp` duration between two marks along with the associated name (a "measure").

**`getEntriesByType()`**

…

**`getEntriesByType()`**

…

**`getEntriesByName()`**

…

`clearMarks()`

If the markName argument is not specified, this method removes all marks and their associated DOMHighResTimeStamp time values.

If the markName argument is specified, this method removes all DOMHighResTimeStamp time values for the given mark name.

If the markName argument is specified but the specified markName does not exist, this method will do nothing.

Properties
----------

`performance.timing` (en-US)

Is a `PerformanceTiming` (en-US) object containing latency-related performance information.

`performance.navigation` (en-US)

Is a `PerformanceNavigation` (en-US) object representing the type of navigation that occurs in the given browsing context, like the amount of redirections needed to fetch the resource.

performance.memory

A non-standard extension added in Chrome.