From 592e87a22f6be559a7477a799c40605f5b779d55 Mon Sep 17 00:00:00 2001
From: egstartsev <egstartsev@ozon.ru>
Date: Sat, 29 Oct 2022 01:44:30 +0300
Subject: [PATCH] added pause and resume controls for geolocation watcher

---
 packages/core/useGeolocation/demo.vue |  8 +++---
 packages/core/useGeolocation/index.md |  4 ++-
 packages/core/useGeolocation/index.ts | 36 ++++++++++++++++++---------
 3 files changed, 31 insertions(+), 17 deletions(-)

diff --git a/packages/core/useGeolocation/demo.vue b/packages/core/useGeolocation/demo.vue
index 9a60b3bc2d4..556b132910b 100644
--- a/packages/core/useGeolocation/demo.vue
+++ b/packages/core/useGeolocation/demo.vue
@@ -1,7 +1,7 @@
 <script setup lang="ts">
 import { useGeolocation } from '@vueuse/core'
 
-const { coords, locatedAt, error, stop, start } = useGeolocation()
+const { coords, locatedAt, error, resume, pause } = useGeolocation()
 </script>
 
 <template>
@@ -25,10 +25,10 @@ const { coords, locatedAt, error, stop, start } = useGeolocation()
       2,
     )
   }}</pre>
-    <button @click="stop">
-      Stop watch
+    <button @click="pause">
+      Pause watch
     </button>
-    <button @click="start">
+    <button @click="resume">
       Start watch
     </button>
   </div>
diff --git a/packages/core/useGeolocation/index.md b/packages/core/useGeolocation/index.md
index 91273c0f767..7308dcefd85 100644
--- a/packages/core/useGeolocation/index.md
+++ b/packages/core/useGeolocation/index.md
@@ -11,7 +11,7 @@ Reactive [Geolocation API](https://developer.mozilla.org/en-US/docs/Web/API/Geol
 ```js
 import { useGeolocation } from '@vueuse/core'
 
-const { coords, locatedAt, error } = useGeolocation()
+const { coords, locatedAt, error, start, stop } = useGeolocation()
 ```
 
 | State     | Type                                                                          | Description                                                              |
@@ -19,6 +19,8 @@ const { coords, locatedAt, error } = useGeolocation()
 | coords    | [`Coordinates`](https://developer.mozilla.org/en-US/docs/Web/API/Coordinates) | information about the position retrieved like the latitude and longitude |
 | locatedAt | `Date`                                                                        | The time of the last geolocation call                                    |
 | error     | `string`                                                                      | An error message in case geolocation API fails.                          |
+| resume     | `function`                                                                      | Control function to resume updating geolocation |
+| pause      | `function`                                                                        | Control function to pause updating geolocation |
 
 ## Config
 
diff --git a/packages/core/useGeolocation/index.ts b/packages/core/useGeolocation/index.ts
index b747ea4c1ed..bd8696344f1 100644
--- a/packages/core/useGeolocation/index.ts
+++ b/packages/core/useGeolocation/index.ts
@@ -7,7 +7,9 @@ import type { ConfigurableNavigator } from '../_configurable'
 import { defaultNavigator } from '../_configurable'
 import { useSupported } from '../useSupported'
 
-export interface UseGeolocationOptions extends Partial<PositionOptions>, ConfigurableNavigator {}
+export interface UseGeolocationOptions extends Partial<PositionOptions>, ConfigurableNavigator {
+  immediate?: boolean
+}
 
 /**
  * Reactive Geolocation API.
@@ -45,21 +47,29 @@ export function useGeolocation(options: UseGeolocationOptions = {}) {
 
   let watcher: number
 
-  if (isSupported.value) {
-    watcher = navigator!.geolocation.watchPosition(
-      updatePosition,
-      err => error.value = err,
-      {
-        enableHighAccuracy,
-        maximumAge,
-        timeout,
-      },
-    )
+  function resume() {
+    if (isSupported.value) {
+      watcher = navigator!.geolocation.watchPosition(
+        updatePosition,
+        err => error.value = err,
+        {
+          enableHighAccuracy,
+          maximumAge,
+          timeout,
+        },
+      )
+    }
   }
 
-  tryOnScopeDispose(() => {
+  resume()
+
+  function pause() {
     if (watcher && navigator)
       navigator.geolocation.clearWatch(watcher)
+  }
+
+  tryOnScopeDispose(() => {
+    pause()
   })
 
   return {
@@ -67,6 +77,8 @@ export function useGeolocation(options: UseGeolocationOptions = {}) {
     coords,
     locatedAt,
     error,
+    resume,
+    pause,
   }
 }