JavaScript свойство Event.isTrusted

Определение и применение

Свойство Event.isTrusted показывает, создано ли событие браузером (true) или отправлено сценарием через dispatchEvent() (false). Это не проверка непосредственного действия человека: вызов focus() тоже может вызвать доверенное событие. Событие от HTMLElement.click() имеет isTrusted === false.

Логическое значение true соответствует тому, что это событие было создано и послано браузером, а false соответствует искусственному событию, которое было создано и отправлено сценарием на языке JavaScript.

Значение true не доказывает действие человека: браузер может создать доверенное событие в ответ на программный вызов, например focus(). Событие click, созданное методом HTMLElement.click(), имеет isTrusted === false.

Поддержка браузерами

Спецификация: dom.spec.whatwg

Поддерживается во всех основных браузерах с 2016 года.

Показать браузеры
Совместимостьapi.Event.isTrusted
ВозможностьКомпьютерыМобильные
ChromeEdgeFirefoxOperaSafariChrome AndroidFirefox for AndroidOpera AndroidSafari on iOSSamsung BrowserWebView AndroidWebView on iOS
isTrusted✓46✓12✓1.5✓33✓10✓46✓4✓33✓10✓5.0✓46✓10

поддерживаетсяс ограниченияминет поддержкинет данных≤31 — не позднее версии 31

JavaScript синтаксис

JavaScript
event.isTrusted;

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

DOM Standard.

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

Ручное и программное событие click

Нажмите ▶, сравните два программных события в консоли, затем нажмите кнопку вручную: значение isTrusted изменится.

index.html
HTML
<button type="button">Нажмите вручную</button>
<p>Сравните два программных события в консоли с ручным нажатием.</p>
main.js
JavaScript
const button = document.querySelector('button')
button.addEventListener('click', (event) => {
    console.log('click, isTrusted:', event.isTrusted)
})
button.click() // false: программный click().
button.dispatchEvent(new MouseEvent('click')) // false: dispatchEvent().
// Теперь нажмите кнопку мышью или клавиатурой: браузер создаст доверенное событие.