HTML and CSS Reference
In-Depth Information
</div>
</body>
</html>
2.5.8 Error-Callbacks
Die Implementierung eines Error-Handlers ist zwar optional, allerdings kann, wie Sie ja
schon anhand der Beispiele gesehen haben, so einiges schiefgehen. Zunächst einmal
braucht der Nutzer der Ortsbestimmung überhaupt nicht zuzustimmen. Und selbst
wenn er die Zusage gegeben hat, kann eine Bestimmung der aktuellen Position aus einer
Vielzahl technischer Gründe nicht möglich sein. Aus diesem Grund kann sowohl bei
watchPosition
also auch bei
getCurrentPosition
ein Error-Handler angegeben
werden. Ein Error-Handler verweist per Referenz auf eine JavaScript-Funktion. An die
Funktion wird im Fehlerfall ein
error
-Objekt übergeben. Das folgende Beispiel zeigt
eine solche Funktion:
function handleError(error)
{
var msgNode document.getElementById('message');
switch (error.code)
{
case error.TIMEOUT:
msgNode.innerHTML + 'timed out...'; //nochmal versuchen?
break;
case error.PERMISSION DENIED:
msgNode.innerHTML + 'user declined positioning';
break;
case error.POSITION UNAVAILABLE:
msgNode.innerHTML + 'position not available';
break;
}
}
Das an die Funktion übergebene
error
-Objekt enthält drei konstante Werte, die
Fehlerfälle. Anhand des Property-Codes kann festgestellt werden, welcher dieser Fälle
eingetreten ist.
Fehlerfall
Beschreibung
TIMEOUT
Die Position konnte nicht festgestellt werden, da der im
PositionOptions
-Objekt angegebene Timeout überschrit-
ten worden ist.
PERMISSION_DENIED
Der Benutzer hat der Positionsbestimmung nicht zugestimmt.
POSITION_UNAVAILABLE
Die Position kann derzeit nicht festgestellt werden. Bei-
spielsweise ist der Nutzer nicht online (keine Wifi-Netzwerke
in Reichweite, keine Internetverbindung), oder die GPS-Satel-
liten können nicht erreicht werden.
