AndroidNode

allNodes(): AndroidNode[]

const screen = await agent.actions.screenContent();
const allNodes = screen.allNodes();
console.log("Total nodes:", allNodes.length);

// Find all visible text
const textNodes = allNodes.filter(n => n.text && n.isVisibleToUser);

findById(id: string): AndroidNode[]

const buttons = screen.findById("com.example:id/submit_button");

findByIdOne(id: string): AndroidNode | null

const button = screen.findByIdOne("com.example:id/submit");
if (button) {
  await button.performAction(agent.constants.ACTION_CLICK);
}

findText(textOrRegex: string | RegExp): AndroidNode[]

const nodes = screen.findText("Submit");

const priceNodes = screen.findText(/\$\d+\.\d{2}/);

findTextOne(textOrRegex: string | RegExp): AndroidNode | null

const submit = screen.findTextOne("Submit");
if (submit) {
  const { left, top, right, bottom } = submit.boundsInScreen;
  await agent.actions.tap((left + right) / 2, (top + bottom) / 2);
}

find(predicate: (node: AndroidNode) => boolean): AndroidNode | null

// Find first clickable button with specific text
const btn = screen.find(node =>
  node.className === "android.widget.Button" &&
  node.clickable &&
  node.text === "Submit"
);

// Find first visible input field
const input = screen.find(node =>
  node.isEditable && node.isVisibleToUser
);

filter(predicate: (node: AndroidNode) => boolean): AndroidNode[]

// Find all buttons
const buttons = screen.filter(node =>
  node.className === "android.widget.Button"
);

// Find all clickable, visible nodes
const clickables = screen.filter(node =>
  node.clickable && node.isVisibleToUser
);

// Find nodes with text containing dollar amounts
const prices = screen.filter(node =>
  node.text?.includes("$")
);

findAdvanced(filterBuilder: (f: AndroidNodeFilter) => AndroidNodeFilter): AndroidNode | null

// Find the submit button
const submit = screen.findAdvanced(f => f.isButton().hasText("Submit"));

// Find first editable text field
const input = screen.findAdvanced(f => f.isEditText().isEditable());

// Find by view ID
const header = screen.findAdvanced(f => f.hasId("com.example:id/header"));

filterAdvanced(filterBuilder: (f: AndroidNodeFilter) => AndroidNodeFilter): AndroidNode[]

// Find all clickable buttons
const buttons = screen.filterAdvanced(f => f.isButton().isClickable());

// Find text nodes with specific text
const labels = screen.filterAdvanced(f => f.isText().hasText("Welcome"));

// Find nodes in a specific list
const listItems = screen.filterAdvanced(f =>
  f.anyParent(p => p.hasId("com.example:id/list"))
);

matches(filterBuilder: (f: AndroidNodeFilter) => AndroidNodeFilter): boolean

// Check if a node is a clickable button
if (node.matches(f => f.isButton().isClickable())) {
  await node.performAction(agent.constants.ACTION_CLICK);
}

// Filter children manually
const clickableChildren = node.children.filter(child =>
  child.matches(f => f.isClickable())
);

toJSON(): object

console.log(JSON.stringify(node.toJSON(), null, 2));

performAction(actionInt: number, data?: object, fieldsToIgnore?: string[]): Promise<{ actionPerformed: boolean }>

const button = screen.findTextOne("Submit");
if (button) {
  await button.performAction(agent.constants.ACTION_CLICK);
}

const input = screen.findAdvanced(f => f.isEditText());
if (input) {
  await input.performAction(agent.constants.ACTION_SET_TEXT, {
    [agent.constants.ACTION_ARGUMENT_SET_TEXT_CHARSEQUENCE]: "Hello World"
  });
}

const scrollView = screen.findAdvanced(f => f.isScrollable());
if (scrollView) {
  await scrollView.performAction(agent.constants.ACTION_SCROLL_FORWARD);
}

adbPerformAction(actionInt: number, data?: object, fieldsToIgnore?: string[]): Promise<{ actionPerformed: boolean }>

const button = screen.findTextOne("Submit");
if (button) {
  await button.adbPerformAction(agent.constants.ACTION_CLICK);
}

const input = screen.findAdvanced(f => f.isEditText());
if (input) {
  await input.adbPerformAction(agent.constants.ACTION_SET_TEXT, {
    [agent.constants.ACTION_ARGUMENT_SET_TEXT_CHARSEQUENCE]: "Hello World"
  });
}

randomClick(): void

const button = screen.findTextOne("Submit");
if (button) {
  button.randomClick();
}

const items = screen.filterAdvanced(f => f.isClickable().hasText(/Item \d+/));
for (const item of items) {
  item.randomClick();
  await sleep(500);
}

randomSwipe(direction: "up" | "down" | "left" | "right"): void

const listView = screen.findAdvanced(f => f.isScrollable());
if (listView) {
  listView.randomSwipe("up"); // Swipe up to scroll down
}

const carousel = screen.findAdvanced(f => f.hasId("carousel"));
if (carousel) {
  carousel.randomSwipe("left"); // Swipe left to see next item
}

randomClickAdb(): void

const button = screen.findTextOne("Submit");
if (button) {
  button.randomClickAdb();
}

randomSwipeAdb(direction: "up" | "down" | "left" | "right"): void

const listView = screen.findAdvanced(f => f.isScrollable());
if (listView) {
  listView.randomSwipeAdb("up"); // Swipe up to scroll down
}