Sensor

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

安全なコンテキスト用: この機能は一部またはすべての対応しているブラウザーにおいて、安全なコンテキスト (HTTPS) でのみ利用できます。

Sensorセンサー API 群のインターフェイスで、ほかのすべてのセンサーインターフェイスのベースクラスです。このインターフェイスを直接使うことはできません。ですが、このインターフェイスは継承するインターフェイスがアクセスするプロパティ・イベントハンドラー・メソッドを提供します。

この機能はサーバーで設定された 権限ポリシー によりブロックされる可能性があります。

EventTarget Sensor

最初に生成されたとき、Sensor オブジェクトは測定を行わない idle 状態です。start() メソッドが呼ばれると、データを取得する準備をします。準備ができると activate イベントが送られ、センサーは activated 状態になります。その後は、新しいデータを取得するたびに reading イベントを送ります。

エラーが発生したときは、error イベントを送り、測定を停止し、Sensor オブジェクトは idle 状態に戻ります。新しいデータを取得するには、もう一度 start() メソッドを呼ぶ必要があります。

Sensor をベースとするインターフェイス

以下が Sensor インターフェイスをベースとするインターフェイスの一覧です。

インスタンスプロパティ

Sensor.activated 読取専用

センサーが作動中かどうかを表す boolean 値を返します。

Sensor.hasReading 読取専用

センサーが測定値を持っているかを表す boolean 値を返します。

Sensor.timestamp 読取専用

センサーの最新の測定値のタイムスタンプを返します。

インスタンスメソッド

Sensor.start()

Sensor をベースとするセンサーを 1 個動作開始させます。

Sensor.stop()

Sensor をベースとするセンサーを 1 個動作停止させます。

イベント

activate

センサーの動作が開始したとき発火します。

error

センサーで例外が発生したとき発火します。

reading

センサーで新しい測定値が得られたとき発火します。

仕様書

Specification
Generic Sensor API
# the-sensor-interface

ブラウザーの互換性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Sensor
activate event
activated
error event
hasReading
reading event
start
stop
timestamp

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
See implementation notes.