Event.isTrusted - ユーザー操作により発生したか?
isTrustedは、Eventのプロパティです。イベントがユーザーの操作により発生したか否かを返します。例えばclickイベントが、ユーザーがクリック操作をして発生した場合はtrue、EventTarget.dispatchEvent()など、スクリプトで発生させた場合はfalseを返します。
概要
- 名前
- isTrusted
- 所属
- Event
- IDL
[Unforgeable] readonly attribute boolean isTrusted;
- 仕様書
- https://dom.spec.whatwg.org/#dom-event-istrusted
説明
ユーザーの操作によってイベントが発生した場合はtrue、違うならfalseを返す。
デモ
Event.isTrustedのデモです。ボタンをクリックすると、イベントが発生します。ユーザーがクリック操作で起こしたイベントなのでtrueを返します。コメントアウトを外して、HTMLElement.click()で擬似的にイベントを発生させた場合はfalseを返します。
<!-- このコードは編集できます。 -->
<!DOCTYPE html>
<html>
<head>
<style>
div#result {
white-space: pre-wrap ;
}
</style>
</head>
<body>
<button id="hoge">実行</button>
<hr>
<div id="result"></div>
<script>
/** try it! **/
var element = document.getElementById( "hoge" ) ;
var resultElement = document.getElementById( "result" ) ;
element.addEventListener( "click", function ( event ) {
var value = event.isTrusted ;
console.log( value ) ;
resultElement.textContent = value ;
} ) ;
// element.click() ; // コメントアウトを外してみよう!
/** try it! **/
</script>
</body>
</html>
サポート状況
Chrome | Firefox | Safari | Edge | IE | Opera | iOS Safari | Android |
---|---|---|---|---|---|---|---|
● 46+ | ● | ● 10+ | ● | ● 9+ | ● 33+ | ● 10.0+ | × |
関連記事
- Event.target
- targetは、Eventのプロパティです。イベントの発信源となったオブジェクトを返します。伝播で発生しているイベント内において、元のオブジェクトを確認するのに有用です。
- EventTarget.dispatchEvent()
- dispatchEvent()は、EventTargetのメソッドです。ターゲットに対して、任意のイベントを発生させます。
- 指定文字を置換、削除する
- 文字列の中の指定した部分を置換したり削除します。
- Event.CAPTURING_PHASE
- CAPTURING_PHASEは、Eventの定数です。1を返します。この値は、イベントフェイズがキャプチャリングフェイズであることを表します。