Skip to main content

findAll

Searches this entire subtree (this node's children, its children's children, etc). Returns all nodes for which callback returns true.

Signature

findAll(callback?: (node: SceneNode) => boolean): SceneNode[]

Parameters

callback

A function that evaluates whether to return the provided node. If this argument is omitted, findAll returns all nodes in the subtree.

Remarks

Nodes are included in back-to-front order. Parents always appear before their children, and children appear in same relative order before their children, and children appear in same relative order as in the children array.

This traversal method is known as "pre-order traversal".

Note that the node this method is called on is not included.

Example: find all nodes whose name is "Color":

const colors = figma.currentPage.findAll(n => n.name === "Color")
caution

⚠ Large documents in Figma can have tens of thousands of nodes. Be careful using this function as it could be very slow. Please refer to our recommendations for how to optimize document traversals.