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

View in English Always switch to English

Geolocation.clearWatch()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨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);

规范

Specification
Geolocation
# clearwatch-method

浏览器兼容性

参见