findOne
Searches this entire page (this node's children, its children's children, etc.). Returns the first node for which callback returns true.
If the manifest contains "documentAccess": "dynamic-page", you must first call figma.loadAllPagesAsync to access this function.
Supported on:
Signature
findOne(callback: (node: PageNode | SceneNode) => boolean): PageNode | SceneNode | null
Parameters
callback
A function that evaluates whether to return the provided node.
Remarks
This function returns null if no matching node is found. The traversal order is the same as in findAll.
Note that the root node itself is not included.
Example: find one node whose name is "Template":
await figma.loadAllPagesAsync() // call this once when the plugin runs
const template = figma.root.findOne(n => n.name === "Template")
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.