2

GeolocationPositionError インターフェイス (DOM)

仕様書

文脈

[5] 文書環境晒されます。 >>4

[6] コンストラクターはありません。 >>4

[7] getCurrentPositionwatchPosition で作成されます。

メンバー

[8] GeolocationPositionError インターフェイスメンバー

[10] 作成後に状態を変更することはできません。

[9] GeolocationPositionError オブジェクトの状態
code
message

エラーの種別

[11] エラーの種別は code で表されます。 unsigned short 型の3つの定数のいずれかに設定されます。

[12] エラーの説明が message に設定されます。 こちらは機械可読ではない人間 (開発者) 向けの文です。 実装依存で、 仕様書で具体的には決められていません。

c
code>>4
code
code>>4
message
message の例 (Chrome)
desc
説明
c
1
code
PERMISSION_DENIED
message
User denied Geolocation
desc
位置情報の取得が許可されていないための失敗を表します。
c
1
code
PERMISSION_DENIED
message
Only secure origins are allowed (see: https://goo.gl/Y0ZkNV).
desc
非保安文脈ゆえの失敗を表します。
c
2
code
POSITION_UNAVAILABLE
desc
位置情報を決定できなかったことを表します。
c
3
code
TIMEOUT
message
Timeout expired
desc
timeout 超過による失敗を表します。

くわしい発生条件は watchPosition

歴史

[2] 当初は PositionError と呼ばれていました。

[1] Geolocation API Specification ( ( 版)) http://www.w3.org/TR/geolocation-API/#position_error_interface

[3] DOMExceptionLSException など場面ごとに異なる例外オブジェクトを使う W3C DOM 時代の古い慣習に基づいた設計となっています。 今新しく作られた API ならこのような設計にはならなかったはずです。

メモ