31 lines
1.2 KiB
TypeScript
31 lines
1.2 KiB
TypeScript
import { computed, toValue } from 'vue';
|
|
import type { ComputedRef, MaybeRefOrGetter } from 'vue';
|
|
|
|
export type UseArraySomeReturn = ComputedRef<boolean>;
|
|
|
|
/**
|
|
* @name useArraySome
|
|
* @category Array
|
|
* @description Reactive `Array.prototype.some`. The source array and its items may be reactive.
|
|
*
|
|
* @param {MaybeRefOrGetter<MaybeRefOrGetter<T>[]>} list The source array (items can be reactive)
|
|
* @param {(element: T, index: number, array: MaybeRefOrGetter<T>[]) => unknown} fn Predicate to test each element
|
|
* @returns {UseArraySomeReturn} A computed boolean that is `true` if `fn` returns a truthy value for any element, otherwise `false`
|
|
*
|
|
* @example
|
|
* const list = ref([1, 2, 3, 4]);
|
|
* const hasEven = useArraySome(list, n => n % 2 === 0); // true
|
|
*
|
|
* @example
|
|
* const items = [ref(1), ref(3), ref(5)];
|
|
* const hasEven = useArraySome(items, n => n % 2 === 0); // false
|
|
*
|
|
* @since 0.0.14
|
|
*/
|
|
export function useArraySome<T>(
|
|
list: MaybeRefOrGetter<Array<MaybeRefOrGetter<T>>>,
|
|
fn: (element: T, index: number, array: Array<MaybeRefOrGetter<T>>) => unknown,
|
|
): UseArraySomeReturn {
|
|
return computed(() => toValue(list).some((element, index, array) => fn(toValue(element), index, array)));
|
|
}
|