find()

finds the item that corresponds to the specified rule

find(rule: object | (item: object, index: number, array: object[]) => any): object;

Parameters:

• rule: object | function - the search criteria:
  • if set as an object, the parameter contains the following attributes:
    • by: string | function - the search criterion (either the key of the item attribute or a search function)
    • match: string - the value of the item attribute
  • if set as a function, the search will be applied by the rule specified in the function. The function takes three parameters:
    • item: object - the object of an item
    • index: number - the index of an item
    • array: object[] - an array of items the method was called upon

Returns:

The object of the matching item.

Example

// searching for an item by the function
const item = component.data.find(function (item) {
    if (item.text === "Manager" || item.text === "Marketer") {
        return true
    }
});

// searching for an item by the attribute key
const item = component.data.find({ by: "text", match: "Manager" });

Related sample: Data. Find