在此页

• 句法
• 范例
• 规范
• 浏览器兼容性
• 另请参阅
• 相关话题

安全上下文
此特征只可用于 安全上下文 (HTTPS)，在某些或所有 支持浏览器 .

Geolocation 方法 watchPosition() method is used to register a handler function that will be called automatically each time the position of the device changes. You can also, optionally, specify an error handling callback function.

句法

navigator.geolocation.watchPosition(success[, error[, options]])
					

参数

success

A callback function that takes a GeolocationPosition object as an input parameter.

error 可选

An optional callback function that takes a GeolocationPositionError object as an input parameter.

选项 可选

An optional PositionOptions object that provides configuration options for the location watch.

返回值

An integer ID that identifies the registered handler. The ID can be passed to the Geolocation.clearWatch() to unregister the handler.

范例

var id, target, options;
function success(pos) {
  var crd = pos.coords;
  if (target.latitude === crd.latitude && target.longitude === crd.longitude) {
    console.log('Congratulations, you reached the target');
    navigator.geolocation.clearWatch(id);
  }
}
function error(err) {
  console.warn('ERROR(' + err.code + '): ' + err.message);
}
target = {
  latitude : 0,
  longitude: 0
};
options = {
  enableHighAccuracy: false,
  timeout: 5000,
  maximumAge: 0
};
id = navigator.geolocation.watchPosition(success, error, options);
					

规范

规范	状态	注释
地理位置 API The definition of 'watchPosition()' in that specification.	推荐	最初的规范。

浏览器兼容性

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据

	桌面						移动
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
watchPosition	Chrome 5	Edge 12	Firefox 3.5	IE 9	Opera 10.6	Safari 5	WebView Android ≤37	Chrome Android 18	Firefox Android 4	Opera Android 11	Safari iOS 5	Samsung Internet Android 1.0

图例

完整支持

完整支持

另请参阅

• Using the Geolocation API
• The interface it belongs to, Geolocation , and the way to access it — NavigatorGeolocation.geolocation .
• The opposite operation: Geolocation.clearWatch()
• A similar method: Geolocation.getCurrentPosition()

元数据

• 最后修改： Aug 3, 2020

相关话题

1. 地理位置 API
2. Geolocation
3. 方法

   1. clearWatch()
   2. getCurrentPosition()
   3. watchPosition()
4. Related pages for Geolocation API

   1. GeolocationCoordinates
   2. GeolocationPosition
   3. GeolocationPositionError
   4. Navigator.geolocation