PositionError

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

仕様書

[4] Geolocation API Specification, 2019-11-24 18:38:51 +09:00 https://w3c.github.io/geolocation-api/#position_error_interface

文脈

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

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

[7] getCurrentPosition や watchPosition で作成されます。

メンバー

[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 ( (2013-10-22 23:10:42 +09:00 版)) http://www.w3.org/TR/geolocation-API/#position_error_interface

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

メモ