Skip to content

useArrayFindIndex

Category
Export Size
138 B
Last Changed
6 days ago

Reactive Array.findIndex

Usage

Use with array of multiple refs

ts
import { 
useArrayFindIndex
} from '@vueuse/core'
const
item1
=
ref
(0)
const
item2
=
ref
(2)
const
item3
=
ref
(4)
const
item4
=
ref
(6)
const
item5
=
ref
(8)
const
list
= [
item1
,
item2
,
item3
,
item4
,
item5
]
const
result
=
useArrayFindIndex
(
list
,
i
=>
i
% 2 === 0)
// result.value: 0
item1
.
value
= 1
// result.value: 1

Use with reactive array

ts
import { 
useArrayFindIndex
} from '@vueuse/core'
const
list
=
ref
([0, 2, 4, 6, 8])
const
result
=
useArrayFindIndex
(
list
,
i
=>
i
% 2 === 0)
// result.value: 0
list
.
value
.
unshift
(-1)
// result.value: 1

Type Declarations

ts
export type 
UseArrayFindIndexReturn
=
ComputedRef
<number>
/** * Reactive `Array.findIndex` * * @see https://vueuse.org/useArrayFindIndex * @param list - the array was called upon. * @param fn - a function to test each element. * * @returns the index of the first element in the array that passes the test. Otherwise, "-1". * * @__NO_SIDE_EFFECTS__ */ export declare function
useArrayFindIndex
<
T
>(
list
:
MaybeRefOrGetter
<
MaybeRefOrGetter
<
T
>[]>,
fn
: (
element
:
T
,
index
: number,
array
:
MaybeRefOrGetter
<
T
>[]) => unknown,
):
UseArrayFindIndexReturn

Source

SourceDocs

Contributors

Anthony Fu
Anthony Fu
SerKo
Levi (Nguyễn Lương Huy)
Robin
IlyaL

Changelog

v13.6.0 on
d32f8 - refactor: add @__NO_SIDE_EFFECTS__ annotations to all pure functions (#4907)
v13.1.0 on
c1d6e - feat(shared): ensure return types exists (#4659)
v12.8.0 on
7432f - feat(types): deprecate MaybeRef and MaybeRefOrGetter in favor of Vue's native (#4636)
v12.3.0 on
59f75 - feat(toValue): deprecate toValue from @vueuse/shared in favor of Vue's native
v12.0.0-beta.1 on
0a9ed - feat!: drop Vue 2 support, optimize bundles and clean up (#4349)
v10.0.0-beta.4 on
4d757 - feat(types)!: rename MaybeComputedRef to MaybeRefOrGetter
0a72b - feat(toValue): rename resolveUnref to toValue

Released under the MIT License.

Build faster with AI
New Masterclass to help you leverage AI in your Vue workflow
Get Early Access