Skip to content

Colota - Android GPS Location tracker

1.1 KB
Raw Blame
/**
 * Copyright (C) 2026 Max Dietrich
 * Licensed under the GNU AGPLv3. See LICENSE in the project root for details.
 */

import { useRef, useEffect, useCallback, useMemo } from "react"

/**
 * Hook that manages a single timeout with automatic cleanup on unmount.
 * Replaces scattered timeout ref + cleanup patterns across screens.
 */
export function useTimeout() {
  const timeoutRef = useRef<ReturnType<typeof setTimeout> | null>(null)

  useEffect(() => {
    return () => {
      if (timeoutRef.current) clearTimeout(timeoutRef.current)
    }
  }, [])

  const set = useCallback((callback: () => void, delay: number) => {
    if (timeoutRef.current) clearTimeout(timeoutRef.current)
    timeoutRef.current = setTimeout(callback, delay)
  }, [])

  const clear = useCallback(() => {
    if (timeoutRef.current) {
      clearTimeout(timeoutRef.current)
      timeoutRef.current = null
    }
  }, [])

  // Stable identity: callers list this object in dependency arrays, and a fresh one per render
  // re-runs their effects forever.
  return useMemo(() => ({ set, clear }), [set, clear])
}