useIntervalFn

Category

Animation

Export Size

367 B

Last Changed

4 months ago

Wrapper for setInterval with controls

Demo

sourceplayground (beta)

Yo!

interval:

Usage

import { useIntervalFn } from '@vueuse/core'

const { pause, resume, isActive } = useIntervalFn(() => {
  /* your function */
}, 1000)

Type Declarations

export interface UseIntervalFnOptions {
  /**
   * Start the timer immediately
   *
   * @default true
   */
  immediate?: boolean
  /**
   * Execute the callback immediately after calling `resume`
   *
   * @default false
   */
  immediateCallback?: boolean
}
export type UseIntervalFnReturn = Pausable
/**
 * Wrapper for `setInterval` with controls
 *
 * @see https://vueuse.org/useIntervalFn
 * @param cb
 * @param interval
 * @param options
 */
export declare function useIntervalFn(
  cb: Fn,
  interval?: MaybeRefOrGetter<number>,
  options?: UseIntervalFnOptions,
): UseIntervalFnReturn

Source

Source • Demo • Docs

Contributors

Anthony Fu

Anthony Fu

Robin

Jelf

SerKo

Vida Xie

IlyaL

OrbisK

Lapor Chen

Börge Kiss

Dan Rose

sun0day

Enzo Innocenzi

wwj

Matvey Melishev

meteorlxy

Aurélio A. Heckert

xuxuhahaha

Hogne Vevle

Daiki Ojima

Changelog

v13.1.0 on 4/8/2025

c1d6e - feat(shared): ensure return types exists (#4659)

v12.8.0 on 3/5/2025

7432f - feat(types): deprecate MaybeRef and MaybeRefOrGetter in favor of Vue's native (#4636)

v12.3.0 on 1/2/2025

59f75 - feat(toValue): deprecate toValue from @vueuse/shared in favor of Vue's native

v12.0.0-beta.1 on 11/21/2024

0a9ed - feat!: drop Vue 2 support, optimize bundles and clean up (#4349)

v11.2.0 on 10/30/2024

59f8c - fix: prevent timer being set after pause is called in cb (#4258)