Geolocation: clearWatch() method

فهرست فصل‌ها دانلود آرشیوناشر

MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونه‌کد

{{securecontext_header}}{{ APIref("Geolocation API") }}

The **clearWatch()** method of the {{domxref("Geolocation")}} interface is used to unregister location/error monitoring handlers previously installed using {{domxref("Geolocation.watchPosition()")}}.

Syntax

js-nolint
clearWatch(id)

Parameters

  • id
  • : The ID number returned by the {{domxref("Geolocation.watchPosition()")}} method when

installing the handler you wish to remove.

Return value

None ({{jsxref("undefined")}}).

Examples

js
let id;
let target;
let options;

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

  if (target.latitude === crd.latitude && target.longitude === crd.longitude) {
    console.log("Congratulations, you've reached the target!");
    navigator.geolocation.clearWatch(id);
  }
}

function error(err) {
  console.error(`ERROR(${err.code}): ${err.message}`);
}

target = {
  latitude: 0,
  longitude: 0,
};

options = {
  enableHighAccuracy: false,
  timeout: 5000,
  maximumAge: 0,
};

id = navigator.geolocation.watchPosition(success, error, options);

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also

  • Using geolocation
  • {{domxref("Geolocation")}}
  • {{domxref("Geolocation.watchPosition()")}}
  • {{domxref("Geolocation.getCurrentPosition()")}}