此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

Geolocation.clearWatch()

基线 广泛可用

自 2015年7月 起,此特性已在主流浏览器中得到支持,可在大多数设备和浏览器版本中正常使用。

Geolocation.clearWatch() 这个方法用于注销之前使用 Geolocation.watchPosition() 注册的位置监听器或错误监听器。

语法

navigator.geolocation.clearWatch(id);

参数

id

希望移除的监听器所对应的 Geolocation.watchPosition() 返回的 ID 值。

示例

js
var id, target, option;

function success(pos) {
  var crd = pos.coords;

  if (target.latitude === crd.latitude && target.longitude === crd.longitude) {
    console.log("Congratulation, you reach 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);

规范

规范
Geolocation
# clearwatch-method

浏览器兼容性

参见