find

This block is part of the array group and was last modified in core v14.0.1.

Type Selection Required

This block requires you to select the data type you want to work with. You must manually select the type using the type selector modal. To access the modal, click the white button on the block.

find v14.0.1

The first element in the array that satisfies the provided testing function.

In pins 1
  • Array required
    array

    The input array to be processed.

Out pins 2
  • object
    object
  • Iterator
    execute_function

    The function to be applied to each element in the array.

Runs the iterator callback per item (index, value) and outputs the FIRST item whose callback returns strict boolean true; truthy non-boolean returns do NOT match. The item itself is emitted on object, not the callback's return. Outputs null when nothing matches, the array is empty or missing, or no callback function is wired; a callback error skips that item.

A typical wiring for find: the function out pin wires to an execute block.

Studio canvas example for the find block: typical wiring for find.

Version history

Introduced in v14.0.1.


Back to array Return to the main group to view all sub-groups Back to array Return to the group to view all blocks within this group