1---
2category: Array
3---
4 
5# useArrayFind
6 
7Reactive `Array.find`.
8 
9## Usage
10 
11```ts
12import { useArrayFind } from '@vueuse/core'
13 
14const list = [ref(1), ref(-1), ref(2)]
15const positive = useArrayFind(list, val => val > 0)
16// positive.value: 1
17```
18 
19### Use with reactive array
20 
21```ts
22import { useArrayFind } from '@vueuse/core'
23 
24const list = reactive([-1, -2])
25const positive = useArrayFind(list, val => val > 0)
26// positive.value: undefined
27list.push(1)
28// positive.value: 1
29```
30 
31## Type Declarations
32 
33```ts
34export type UseArrayFindReturn<T = any> = ComputedRef<T | undefined>
35/**
36 * Reactive `Array.find`
37 *
38 * @see https://vueuse.org/useArrayFind
39 * @param list - the array was called upon.
40 * @param fn - a function to test each element.
41 *
42 * @returns the first element in the array that satisfies the provided testing function. Otherwise, undefined is returned.
43 *
44 * @__NO_SIDE_EFFECTS__
45 */
46export declare function useArrayFind<T>(
47  list: MaybeRefOrGetter<MaybeRefOrGetter<T>[]>,
48  fn: (element: T, index: number, array: MaybeRefOrGetter<T>[]) => boolean,
49): UseArrayFindReturn<T>
50```
51