417.txt

* 仕様書

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

* 文脈

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

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

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

* メンバー

[FIG(short list)[ [8] [CODE[GeolocationPositionError]] [[インターフェイスメンバー]]
- [CODE[PERMISSION_DENIED]]
- [CODE[POSITION_UNAVAILABLE]]
- [CODE[TIMEOUT]]
- [CODE[code][code (GeolocationPositionError)]]
- [CODE[message][message (GeolocationPositionError)]]
]FIG]

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

[FIG(list members)[ [9] [CODE[GeolocationPositionError]] [[オブジェクト]]の状態
: [F[[CODE[code][code (GeolocationPositionError)]]]] :
: [F[[CODE[message][message (GeolocationPositionError)]]]] :

]FIG]

* エラーの種別

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

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

[FIG(table)[

:c: 
[CODE[code][code (GeolocationPositionError)]]
値 [SRC[>>4]]
:code: 
[CODE[code][code (GeolocationPositionError)]]
名 [SRC[>>4]]
:message:
[CODE[message][message (GeolocationPositionError)]] 
の例
([[Chrome]])
:desc:
説明

:c: [DFN[[N[1]]]]
:code: [DFN[[CODE[PERMISSION_DENIED]]]]
:message: [CODE[User denied Geolocation]]
:desc:
[[位置情報]]の取得が[[許可][Permission]]されていないための失敗を表します。

:c: [N[1]]
:code: [CODE[PERMISSION_DENIED]]
:message:
[CODE[Only secure origins are allowed (see: https://goo.gl/Y0ZkNV).]]
:desc:
[[非保安文脈]]ゆえの失敗を表します。


:c: [DFN[[N[2]]]]
:code: [DFN[[CODE[POSITION_UNAVAILABLE]]]]
:desc:
[[位置情報]]を決定できなかったことを表します。

:c: [DFN[[N[3]]]]
:code: [DFN[[CODE[TIMEOUT]]]]
:message: [CODE[Timeout expired]]
:desc:
[CODE[timeout][PositionOptions]]
超過による失敗を表します。

]FIG]

[SEE[ くわしい発生条件は [[watchPosition]] ]]

* 歴史

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

[1] [CITE@en[Geolocation API Specification]]
( ([TIME[2013-10-22 23:10:42 +09:00]] 版))
<http://www.w3.org/TR/geolocation-API/#position_error_interface>

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

* メモ