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 года.
| Возможность | Компьютеры | Мобильные | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
isTrusted | 46 Версия 46 выпущена в 2015 г. Примечание MDN (англ.) Starting with Chrome 53 and Opera 40, untrusted events do not invoke the default action. | 12 | 1.5 | 33 Версия 33 выпущена в 2015 г. Примечание MDN (англ.) Starting with Chrome 53 and Opera 40, untrusted events do not invoke the default action. | 10 | 46 Версия 46 выпущена в 2015 г. Примечание MDN (англ.) Starting with Chrome Android 53 and Opera 40, untrusted events do not invoke the default action. | 4 | 33 Версия 33 выпущена в 2015 г. Примечание MDN (англ.) Starting with Chrome 53 and Opera 40, untrusted events do not invoke the default action. | 10 | 5.0 Версия 5.0 выпущена в 2016 г. Примечание MDN (англ.) Starting with Samsung Browser 6.0 and Opera 40, untrusted events do not invoke the default action. | 46 Версия 46 выпущена в 2015 г. Примечание MDN (англ.) Starting with version 53, untrusted events do not invoke the default action. | 10 |
поддерживаетсяс ограниченияминет поддержкинет данных≤31 — не позднее версии 31
JavaScript синтаксис
event.isTrusted;
Спецификация
Пример использования
Ручное и программное событие click
Нажмите , сравните два программных события в консоли, затем нажмите кнопку вручную: значение isTrusted изменится.
index.html
<button type="button">Нажмите вручную</button>
<p>Сравните два программных события в консоли с ручным нажатием.</p>
main.js
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().
// Теперь нажмите кнопку мышью или клавиатурой: браузер создаст доверенное событие.
Нажмите , чтобы запустить пример.