aboutsummaryrefslogtreecommitdiff
path: root/files/zh-tw/web/api/geolocationpositionerror/index.html
blob: db19df9f397758e1d98ff323ec623a1193d6a46c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
---
title: PositionError
slug: Web/API/GeolocationPositionError
translation_of: Web/API/GeolocationPositionError
---
<div>{{APIRef("Geolocation API")}}</div>

<p><strong><code>PositionError</code></strong> 介面表示使用定位設備時發生錯誤的原因。</p>

<h2 id="屬性">屬性</h2>

<p><em><code>PositionError</code> 介面沒有繼承任何屬性</em></p>

<dl>
 <dt>{{domxref("PositionError.code")}} {{readonlyInline}}</dt>
 <dd>回傳一個無符號整數<code>(unsigned short</code>)來表示錯誤碼。以下列出可能的值:
 <table class="standard-table">
  <tbody>
   <tr>
    <th scope="col"></th>
    <th scope="col">相對應的常數</th>
    <th scope="col">描述</th>
   </tr>
   <tr>
    <td><code>1</code></td>
    <td><code>PERMISSION_DENIED</code></td>
    <td>取得地理資訊失敗,因為此頁面沒有獲取地理位置信息的權限。</td>
   </tr>
   <tr>
    <td><code>2</code></td>
    <td><code>POSITION_UNAVAILABLE</code></td>
    <td>取得地理資訊失敗,因為至少有一個地理位置信息內的資訊回傳了錯誤。</td>
   </tr>
   <tr>
    <td><code>3</code></td>
    <td><code>TIMEOUT</code></td>
    <td>取得地理資訊超過時限,利用{{domxref("PositionOptions.timeout")}} 來定義取得地理資訊的時限。</td>
   </tr>
  </tbody>
 </table>
 </dd>
 <dt>{{domxref("PositionError.message")}} {{readonlyInline}}</dt>
 <dd>回傳一個可讀的 {{domxref("DOMString")}} 來描述錯誤的詳細訊息。注意規格中指出此訊息是用來除錯而非直接顯示在使用者介面。</dd>
</dl>

<h2 id="方法">方法</h2>

<p><em><em><code>PositionError</code> 介面沒有實作也沒有繼承任何方法</em></em></p>

<h2 id="規格">規格</h2>

<table class="standard-table">
 <thead>
  <tr>
   <th scope="col">Specification</th>
   <th scope="col">Status</th>
   <th scope="col">Comment</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td>{{SpecName('Geolocation', '#positionerror', 'PositionError')}}</td>
   <td>{{Spec2('Geolocation')}}</td>
   <td>Initial specification.</td>
  </tr>
 </tbody>
</table>

<h2 id="瀏覽器的相容性">瀏覽器的相容性</h2>

{{Compat("api.GeolocationPositionError")}}

<h2 id="請參考">請參考</h2>

<ul>
 <li><a href="/en-US/docs/WebAPI/Using_geolocation">Using geolocation</a></li>
 <li>{{domxref("Geolocation")}} 介面使用此物件。</li>
</ul>