recursal/MDN huggingface dataset:
Document.embeds
===============

The **`embeds`** read-only property of the `Document` interface returns a list of the embedded `<object>` (en-US) elements within the current document.

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

nodeList = document.embeds
```

### Значение

`HTMLCollection`.

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

| Specification |
| --- |
| HTML Standard # dom-document-embeds-dev |
Document.referrer
=================

Возвращает URI страницы, с которой был совершён переход на текущую.

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

var referrer = document.referrer;
```

### Значение

Вернёт пустую строку, если пользователь попал на страницу напрямую (не через ссылку, а, например, через закладку). Т.к. свойство возвращает строку, это не даёт вам доступ к DOM ссылающейся страницы.

Внутри элемента `<iframe>` (en-US), `Document.referrer` первоначально будет установлен в тоже значение, что и `href` объекта `Window.location` родительского окна.

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

* DOM Level 2: referrer
Совместимость с браузерами
--------------------------

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

Событие `readystatechange` срабатывает, когда изменяется атрибут документа `readyState` (en-US).

Основная информация
-------------------

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

HTML5

Интерфейс

Event

Всплывает

Нет

Отменяемое

Нет

Цель

Document

Действие по умолчанию

Нет

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

| Свойство | Тип | Описание |
| --- | --- | --- |
| `target` Только для чтения  | `EventTarget` | Цель события (Самая верхняя цель в дереве DOM). |
| `type` Только для чтения  | `DOMString` | Тип события. |
| `bubbles` Только для чтения  | `Boolean` | Всплывает ли событие. |
| `cancelable` Только для чтения  | `Boolean` | Возможно ли отменить событие. |

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


```js
document.readyState === "complete";
// true

// Альтернатива DOMContentLoaded
document.onreadystatechange = function () {
  if (document.readyState === "interactive") {
    initApplication();
  }
};
```

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

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

Связанные события
-----------------

* `DOMContentLoaded (en-US)`
* `readystatechange (en-US)`
* `load (en-US)`
* `beforeunload (en-US)`
* `unload (en-US)`
Document.URL
============

Возвращает строку URL документа HTML.

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

string = document.URL
```

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

### JavaScript
```

document.getElementById("url").textContent = document.URL;
```

### HTML


```html
<p id="urlText">
  URL:<br />
  <span id="url">URL goes here</span>
</p>
```

### Результат

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

| Specification |
| --- |
| DOM Standard # ref-for-dom-document-url① |

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

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

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

* `HTMLDocument`
Document.head
=============

Возвращает элемент `<head>` текущего документа. Если имеется более одного элемента `<head>`, будет возвращён первый из них.

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

var objRef = document.head;
```

### Значение

`HTMLHeadElement`.

Пример
------
```

<!doctype html>
<head id="my-document-head">
  <title>Example: using document.head</title>
</head>

<script>
  var theHead = document.head;

  console.log(theHead.id); // "my-document-head";

  console.log( theHead === document.querySelector("head") ); // true
</script>
```

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

`document.head` доступно только для чтения. Присвоить значение этому свойству нельзя. При попытке это сделать ошибка вызвана не будет, только если вы не используете Strict Mode. В данном случае будет вызвано `TypeError` .

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

| Specification |
| --- |
| HTML Standard # dom-document-head-dev |

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

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

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

* `document.body`
Document.compatMode
===================

Определяет когда документ отображается в Quirks mode или Стандартном режиме.

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

mode = document.compatMode
```

Значения
--------

* `"BackCompat"` если документ в quirks mode;
* `"CSS1Compat"` если документ в не-quirks (также известном как "standards") mode или лимитированный-quirks (известный как "almost standards") mode.

`mode`

Исчислимая величина, которая может быть:


**Примечание:** все эти режимы внесены в стандарт, поэтому старые названия "standards" и "almost standards" теперь бессмысленны и не используются.

Пример
------
```

if (document.compatMode == "BackCompat") {
  // в Quirks режиме
}
```

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

* DOM: Document.compatMode
Document.domain
===============

Свойство `domain` у `Document` интерфейса получает/устанавливает доменную часть источника происхождения (origin) текущего документа, используется в политике ограничения домена (same origin policy) (en-US).

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

var domainString = document.domain;
document.domain = string;
```

### Значение

Доменная часть источника происхождения (origin) текущего документа.

### Исключения

`SecurityError`

An attempt has been made to set `domain` under one of the following conditions:

* The document is inside a sandboxed `<iframe>` (en-US)
* The document has no browsing context
* The document's effective domain is `null`
* The given value is not equal to the document's effective domain (or it is not a registerable domain suffix of it)
* The `document-domain` (en-US) `Feature-Policy` (en-US) is enabled

Examples
--------

### Getting the domain

For the URI `http://developer.mozilla.org/ru/docs/Web`, this example sets `currentDomain` to the string "`developer.mozilla.org`".
```

var currentDomain = document.domain;
```

### Closing a window

If a document, such as `www.example.xxx/good.html`, has the domain of `"www.example.xxx"`, this example attempts to close the window.
```

var badDomain = "www.example.xxx";

if (document.domain == badDomain) {
  // Just an example: window.close() sometimes has no effect
  window.close();
}
```

Замечания
---------

Свойство возвращает `null` если домен документа не может быть идентифицирован, хотя теперь это изменилось с Firefox 62 - смотри обсуждение в Firefox bug 819475.

Mozilla позволит вам установить его в супердомен текущего значения, ограниченный его базовым доменом. Например, на developer.mozilla.org возможно установить его как "mozilla.org" но не как "mozilla.com" или "org".

Если это свойство успешно установлено, портовая часть источника так же устанавливается на нуль.

Mozilla отличает свойство `document.domain`, которое никогда не было установлено от явно установленного такого же домена как в URL документа, хотя свойство возвращает одинаковое значение в обоих случаях. Один документ разрешает доступ к другому, если они оба установили `document.domain` в одинаковое значение, указывая тем самым на их намерение сотрудничать или ни один из них не установил `document.domain`, а домены в URL-адресах одинаковые (реализация). Если бы не эта специальная политика, то каждый сайт будет подвержен XSS от своих поддоменов (для примера https://bugzilla.mozilla.org может быть атакован с помощью заведения багов (bug attachments) на https://bug\*.bugzilla.mozilla.org).

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

| Specification |
| --- |
| HTML Standard # relaxing-the-same-origin-restriction |

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

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

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

* Политика ограничения домена для JavaScriptHTML (en-US)
Document.dir
============

Свойство **`Document.dir`** является строкой `DOMString` показывает направление текста на странице (слева направо или справа налево).

**Возможные значения:**

* `'ltr'` - слева направо
* `'rtl'` - справа налево
Синтаксис
---------


```js
dirStr = document.dir;
document.dir = dirStr;
```

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

| Specification |
| --- |
| HTML Standard # dom-document-dir |

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

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

Связанные события
-----------------

* http://msdn.microsoft.com/en-us/library/ms533731.aspx
Document.contentType
====================

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

Возвращает MIME-тип при рендеринге страницы. Информация может поступать из заголовка HTTP или других ресурсов MIME.

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

contentType = document.contentType;
```


Свойство contentType доступно только для чтения.

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

Свойство не влияет на МЕТА теги.

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

Не является стандартом, поддерживается только Gecko. Для использования только в отладчике chrome (Extensions и XUL Mozilla Firefox).
Document.alinkColor
===================

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

Возвращает или задаёт цвет активной ссылки в теле документа. Ссылка активна в течение времени между событиями mousedown и mouseup.

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

color = document.alinkColor
document.alinkColor = color
```


Color - строка, содержащая имя цвета (например, `blue`, `dark blue` и т.д.) или шестнадцатеричное значение цвета(`#0000FF`)

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

Значение по умолчанию для этого свойства в Mozilla Firefox является красным (`#ee0000` в шестнадцатеричном формате).

`document.alinkColor` устарел в DOM Level 2 HTML. Одним из вариантов является CSS-селектор `:active`.

Другой альтернативой является document.body.aLink, хотя это устарело в HTML 4.01 в пользу альтернативы CSS.

Gecko поддерживает оба варианта `alinkColor`/`:active` and `:focus`. Internet Explorer 6 и 7 поддерживает `alinkColor` / `:active` только для HTML ссылок с якорем (<a>) и поведение у них такое же, как `:focus` в Gecko. В IE нет поддержки `:focus`.

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

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

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

Устаревшее свойство `bgColor` возвращает или устанавливает цвет фона текущего документа.

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

color = document.bgColor
document.bgColor =color
```

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

* `color` это строка представляющая цвет или в виде слова (например `red`) или шестнадцатеричного значения (т.е. "`#ff0000`").
Пример
------
```

document.bgColor = "darkblue";
```

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

В Firefox это поле по умолчанию содержит белый цвет (`#ffffff` в шестнадцатеричном виде).

`Поле document.bgColor` признано устаревшим в DOM Level 2 HTML. В качестве альтернативы рекомендуется использовать CSS стиль `background-color` который доступен через DOM как `document.body.style.backgroundColor`. Другой альтернативой доступа является `document.body.bgColor`, хотя этот вариант также признан устаревшим в HTML 4.01 и также рекомендуется использовать CSS.

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

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

В браузерах возвращает объект window (en-US), который связан с document текущей страницы или `null` если document не доступен.

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

var win = document.defaultView;
```


Это свойство доступно только для чтения.

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

| Specification |
| --- |
| HTML Standard # dom-document-defaultview-dev |

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

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

Метод **`Document.createAttribute()`** создаёт новый атрибут узла и возвращает его. Созданный объект узла реализует `Attr` интерфейс . DOM не указывает, какие атрибуты могут быть добавлены к определённому элементу таким способом.

**Примечание:** Строка, заданная в параметре, преобразуется в нижний регистр.

Syntax
------
```

attribute = document.createAttribute(name)
```

### Parameters

* `name` строка, содержащая имя атрибута.
### Return value

A `Attr` node.

### Exceptions

* `INVALID_CHARACTER_ERR` если параметр содержит недопустимые символы для атрибута XML.
Example
-------


```js
var node = document.getElementById("div1");
var a = document.createAttribute("my\_attrib");
a.value = "newVal";
node.setAttributeNode(a);
console.log(node.getAttribute("my\_attrib")); // "newVal"
```

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

| Specification |
| --- |
| DOM Standard # dom-document-createattribute |

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

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

See also
--------

* `Document.createElement()`
Document.getSelection()
=======================

Этот метод работает в точности так же, как `Window.getSelection()`; он возвращает объект `Selection` (en-US), в котором содержатся данные о тексте, выделенном в документе на данный момент.
Document.scripts
================

Возвращает список элементов `<script>` в документ. Возвращаемый объект является `HTMLCollection`.

Syntax
------
```

var scriptList = document.scripts;
```


Возвращаемый `scriptList` является `HTMLCollection`. Вы можете использовать его как массив для получения всех элементов в списке.

Example
-------

Этот пример показывает есть ли на странице элементы `<script>`.


```js
var scripts = document.scripts;

if (scripts.length) {
  alert("This page has scripts!");
}
```

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

| Specification |
| --- |
| HTML Standard # dom-document-scripts-dev |

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

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

Возвращает элемент `<script>`, который выполняется в данный момент.

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

var curScriptElement = document.currentScript;
```

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

Этот пример проверяет, выполняется ли текущий скрипт асинхронно:


```js
if (document.currentScript.async) {
  console.log("Executing asynchronously");
} else {
  console.log("Executing synchronously");
}
```


Посмотреть живые примеры

Notes
-----

Важно заметить, что элемент `<script>` не будет соответствовать текущему, если он выполняется внутри callback'a или event handler'a; он будет соответствовать элементу только при начальном выполнении скрипта.

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

| Specification |
| --- |
| HTML Standard # dom-document-currentscript-dev |

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

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

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

* `<script>`
* `element.onafterscriptexecute`
* `element.onbeforescriptexecute`
стримится
=========

Событие 'seeking' в случае, когда идёт подгрузка видео

General info
------------

Specification

HTML5 media

Interface

Event

Bubbles

No

Cancelable

No

Target

Element

Default Action

None.

Properties
----------

| Property | Type | Description |
| --- | --- | --- |
| `target` Только для чтения  | `EventTarget` | The event target (the topmost target in the DOM tree). |
| `type` Только для чтения  | `DOMString` | The type of event. |
| `bubbles` Только для чтения  | `Boolean` | Whether the event normally bubbles or not. |
| `cancelable` Только для чтения  | `Boolean` | Whether the event is cancellable or not. |

Related Events
--------------

* `playing (en-US)`
* `waiting (en-US)`
* `seeking (en-US)`
* `seeked (en-US)`
* `ended (en-US)`
* `loadedmetadata (en-US)`
* `loadeddata (en-US)`
* `canplay (en-US)`
* `canplaythrough (en-US)`
* `durationchange (en-US)`
* `timeupdate (en-US)`
* `play (en-US)`
* `pause (en-US)`
* `ratechange (en-US)`
* `volumechange (en-US)`
* `suspend (en-US)`
* `emptied (en-US)`
* `stalled (en-US)`
HTMLMediaElement: abort event
=============================

Событие **`abort`** запускается, когда ресурс не был полностью загружен, но не в результате ошибки.

|  |  |
| --- | --- |
| Всплываемость | No |
| Отменяемость | No |
| Интерфейс | `Event` |
| Свойство обработчика событий | `onabort` (en-US) |

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


```js
const video = document.querySelector("video");
const videoSrc = "https://path/to/video.webm";

video.addEventListener("abort", () => {
  console.log(`Abort loading: ${videoSrc}`);
});

const source = document.createElement("source");
source.setAttribute("src", videoSrc);
source.setAttribute("type", "video/webm");

video.appendChild(source);
```

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

| Specification |
| --- |
| HTML Standard # event-media-abort |
| HTML Standard # handler-onabort |

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

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

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

* `HTMLAudioElement`
* `HTMLVideoElement`
* `<audio>`
* `<video>`
HTMLMediaElement.duration
=========================

**`HTMLMediaElement.duration`** свойство возвращает длину медиа в секундах или ноль, если данные по медиа недоступны.

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


```js
var myDuration = audioOrVideo.duration;
```

### Значения

`Double`. Если медиа данные доступны, но длина неизвестна, то duration будет `NaN`. Если медиа загружается в фоновом режиме и не имеет заранее определённой длины, значение равно `Inf`.

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


```js
var obj = document.createElement("video");
console.log(obj.duration); // NaN
```

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

| Specification |
| --- |
| HTML Standard # dom-media-duration-dev |

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

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

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

* The interface defining it, `HTMLMediaElement`.
VRStageParameters: свойство sizeX
=================================

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

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

Доступное только для чтения свойство **`sizeX`** интерфейса `VRStageParameters` (en-US) возвращает ширину границ игровой зоны в метрах.

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

В целях безопасности границы определяются как прямоугольник на полу. Приложение не должно требовать от пользователя выходить за эти границы, однако пользователь может игнорировать границы, что будет приводит к выходу значений за границы этого прямоугольника. Центр прямоугольника находится в точке с координатами (0,0,0).

### Значение

Число типа float, представляющее ширину в метрах.

Examples
--------

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

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

Это свойство было частью старого 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
VRStageParameters: свойство sizeY
=================================

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

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

Доступное только для чтения свойство **`sizeY`** интерфейса `VRStageParameters` (en-US) возвращает глубину границ игровой зоны в метрах.

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

В целях безопасности границы определяются как прямоугольник на полу. Приложение не должно требовать от пользователя выходить за эти границы, однако пользователь может игнорировать границы, что будет приводит к выходу значений за границы этого прямоугольника. Центр прямоугольника находится в точке с координатами (0,0,0).

### Значение

Число типа float, представляющее глубину в метрах.

Examples
--------

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

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

Это свойство было частью старого 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
VRStageParameters: свойство sittingToStandingTransform
======================================================

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

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

Доступное только для чтения свойство **`sittingToStandingTransform`** интерфейса `VRStageParameters` (en-US) содержит матрицу преобразования `VRFrameData` из горизонтального вида в вертикальный.

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

Обычно это используется для передачи в WebGL-код для преобразования отображения из горизонтального вида в вертикальный.

### Значение

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

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

Смотрите примеры использования в `VRStageParameters` (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