Function waitForSelector

src/commands/interaction/runtime/selector-read.ts:459–478

(
  runtime: AgentDeviceRuntime,
  options: WaitCommandOptions,
  selectorExpression: string,
  timeoutMs: number | null | undefined,
)

}

async function waitForSelector(
  runtime: AgentDeviceRuntime,
  options: WaitCommandOptions,
  selectorExpression: string,
  timeoutMs: number | null | undefined,
): Promise<WaitCommandResult> {
  const timeout = timeoutMs ?? DEFAULT_TIMEOUT_MS;
  const start = now(runtime);
  const chain = parseSelectorChain(selectorExpression);
  while (now(runtime) - start < timeout) {
    const capture = await captureSelectorSnapshot(runtime, options, { updateSession: true });
    const match = findSelectorChainMatch(capture.snapshot.nodes, chain, {
      platform: runtime.backend.platform,
    });
    if (match)
      return { kind: 'selector', selector: match.selector.raw, waitedMs: now(runtime) - start };
    await sleep(runtime, POLL_INTERVAL_MS);
  }
  throw new AppError('COMMAND_FAILED', `wait timed out for selector: ${selectorExpression}`);
}

async function waitForText(
  runtime: AgentDeviceRuntime,