some

INFO

出于兼容性原因，此函数仅在 es-toolkit/compat 中提供。它可能具有替代的原生 JavaScript API，或者尚未完全优化。

从 es-toolkit/compat 导入时，它的行为与 lodash 完全一致，并提供相同的功能，详情请见 这里。

检查数组或对象中是否有元素满足给定的条件。

您可以通过以下几种方式指定条件：

• 谓词函数：如果提供一个谓词函数，该函数将应用于每一项。返回 true 的第一个项将被选中。
• 部分对象：如果提供一个部分对象，该函数将返回第一个匹配部分对象属性的项。
• 属性-值对：如果提供一个属性-值对，该函数将返回第一个匹配该属性和值的项。
• 属性名称：如果提供一个属性名称，该函数将返回第一个指定属性具有真值的项。

如果没有提供条件，该函数会检查数组或对象中是否有任何值为真的元素。

签名

function some<T>(arr: T[]): boolean;
function some<T>(arr: T[], predicate: (item: T, index: number, arr: any) => unknown): boolean;
function some<T>(arr: T[], predicate: [keyof T, unknown]): boolean;
function some<T>(arr: T[], predicate: string): boolean;
function some<T>(arr: T[], predicate: Partial<T>): boolean;

function some<T extends Record<string, unknown>>(object: T): boolean;
function some<T extends Record<string, unknown>>(
  object: T,
  predicate: (value: T[keyof T], key: keyof T, object: T) => unknown
): boolean;
function some<T extends Record<string, unknown>>(object: T, predicate: Partial<T[keyof T]>): boolean;
function some<T extends Record<string, unknown>>(object: T, predicate: [keyof T[keyof T], unknown]): boolean;
function some<T extends Record<string, unknown>>(object: T, predicate: string): boolean;

参数

• arr (T[]) 或 object (T): 要迭代的数组或对象。

arr 可以是 ArrayLike<T>、null 或 undefined

为了确保与 lodash 的完全兼容性，every 函数会按照以下方式处理 arr：

• 如果 arr 是 ArrayLike<T>，它将使用 Array.from(...) 转换为数组。
• 如果 arr 是 null 或 undefined，它将被视为一个空数组。

object 可以是 null 或 undefined

为了确保与 lodash 的完全兼容性，every 函数会按照以下方式处理 object：

• 如果 object 是 null 或 undefined，它将被转换为一个空对象。

• predicate:

  • 对于数组的 some 重载：

    • 谓词函数 ((item: T, index: number, arr: T[]) => unknown): 一个函数，接受项、其索引和数组，如果项符合条件则返回真值。
    • 部分对象 (Partial<T>): 指定要匹配的属性的部分对象。
    • 属性-值对 ([keyof T, unknown]): 一个数组，第一个元素是属性键，第二个元素是要匹配的值。
    • 属性名称 (string): 要检查其真值的属性名称。

  • 对于对象的some重载：

    • 谓词函数 ((value: T[keyof T], key: keyof T, object: T) => unknown): 一个函数，接受值、其键和对象，如果值符合条件则返回真值。
    • 部分值 (Partial<T[keyof T]>): 要与对象的值匹配的部分值。
    • 属性-值对 ([keyof T[keyof T], unknown]): 一个数组，第一个元素是属性键，第二个元素是要匹配的值。
    • 属性名称 (string): 要检查其真值的属性名称。

返回值

(boolean): 如果任何元素通过了谓词检查，则返回true，否则返回false。

示例

数组

import { some } from 'es-toolkit/compat';

// 使用谓词函数
let items = [1, 2, 3, 4, 5];
let result = some(items, item => item > 3);
console.log(result); // true

// 使用部分对象
items = [
  { id: 1, name: 'Alice' },
  { id: 2, name: 'Bob' },
];
result = some(items, { name: 'Bob' });
console.log(result); // true

// 使用属性-值对
items = [
  { id: 1, name: 'Alice' },
  { id: 2, name: 'Bob' },
];
result = some(items, ['name', 'Bob']);
console.log(result); // true

// 使用属性名称
items = [
  { id: 1, name: 'Alice' },
  { id: 2, name: 'Bob' },
];
result = some(items, 'name');
console.log(result); // true

对象

import { some } from 'es-toolkit/compat';

// 使用谓词函数
let obj = { a: 1, b: 2, c: 3 };
let result = some(object, value => value > 2);
console.log(result); // true

// 使用部分对象
obj = { a: { id: 1, name: 'Alice' }, b: { id: 2, name: 'Bob' } };
result = some(obj, { name: 'Bob' });
console.log(result); // true

// 使用属性-值对
obj = { alice: { id: 1, name: 'Alice' }, bob: { id: 2, name: 'Bob' } };
result = some(obj, ['name', 'Bob']);
console.log(result); // true

// 使用属性名称
obj = { a: { id: 1, name: 'Alice' }, b: { id: 2, name: 'Bob' } };
result = some(obj, 'name');
console.log(result); // true