Todas las herramientas

ui_read_tree

Pantalla, ventanas e interfaz · macOS · Windows

Efecto: lectura. Estado: disponibilidad controlada.

«Disponibilidad controlada» significa que la herramienta figura en los artefactos publicados y puede depender de versión, plataforma, permisos, cuenta o configuración. Esta referencia no promete que esté activa en todas las instalaciones. Que una herramienta figure para macOS no implica que esté disponible en Windows, ni al revés.

macOS

Propósito

Devuelve un árbol de accesibilidad COMPACTO de los elementos interactivos + etiquetados de una aplicación nativa en ejecución (botones, enlaces, campos de texto, casillas de verificación, menús...): el equivalente nativo del modo a11y de web_read. Úselo para DESCUBRIR sobre qué actuar en una aplicación desconocida cuando aún no conoce la función/etiqueta de un elemento (ui_find_element necesita una por adelantado). Cada nodo interactivo lleva un `ref` que puede pasar directamente a ui_click. Pase app_bundle_id de una aplicación en ejecución (por ejemplo, com.apple.finder; consulte list_windows); el árbol se poda en nodos portadores de señales y está delimitado por max_depth (predeterminado 12) y un presupuesto de nodo, por lo que las ventanas muy grandes devuelven parciales. La barra de menú de macOS de la aplicación se omite de forma predeterminada (son cientos de nodos de elementos de menú); pase include_menu_bar=true si necesita actuar específicamente sobre los elementos de la barra de menú.

Entradas obligatorias

El esquema de esta plataforma no declara entradas obligatorias. Aun así, pueden existir selectores opcionales o requisitos de ejecución.

Permisos y confirmación

El esquema no declara un parámetro explícito de confirmación. Esto no autoriza a actuar sin permiso: revisa el efecto y obtén autorización antes de una llamada real.

Esquema técnico canónico en inglés — macOS
{
  "properties": {
    "app_bundle_id": {
      "description": "Bundle id of a RUNNING app (e.g. com.apple.finder)",
      "type": "string"
    },
    "include_menu_bar": {
      "description": "Include the app's macOS menu bar (hundreds of menu-item nodes). Default false.",
      "type": "boolean"
    },
    "max_depth": {
      "description": "Max tree depth to descend (default 12, max 20)",
      "type": "integer"
    },
    "window_id": {
      "description": "Alternative to app_bundle_id: a window id from list_windows (targets that window's app)",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}

Ejemplo documental

Ejemplo de documentación para ui_read_tree. No ejecutes este ejemplo. Los argumentos mostrados pertenecen a un conjunto de datos ficticio; resuelve identificadores reales y obtén autorización antes de una llamada real.

{}

Windows

Propósito

Devuelve un árbol de automatización de interfaz de usuario COMPACTO de los elementos interactivos + etiquetados de una aplicación de Windows en ejecución (botones, enlaces, ediciones, casillas de verificación, menús...): el equivalente nativo del modo a11y de web_read. Úselo para DESCUBRIR sobre qué actuar en una aplicación desconocida cuando aún no conoce la función/etiqueta de un elemento (ui_find_element necesita una por adelantado). Cada nodo interactivo lleva un `ref` que puede pasar directamente a ui_click. Pase `app` (el nombre del proceso de una aplicación en ejecución, por ejemplo, bloc de notas). El árbol se poda en nodos portadores de señales y está delimitado por max_depth (predeterminado 12) y un presupuesto de nodo, por lo que las ventanas muy grandes devuelven parciales.

Entradas obligatorias

El esquema de esta plataforma no declara entradas obligatorias. Aun así, pueden existir selectores opcionales o requisitos de ejecución.

Permisos y confirmación

El esquema no declara un parámetro explícito de confirmación. Esto no autoriza a actuar sin permiso: revisa el efecto y obtén autorización antes de una llamada real.

Esquema técnico canónico en inglés — Windows
{
  "properties": {
    "app": {
      "description": "Process name of a RUNNING app (e.g. notepad).",
      "type": "string"
    },
    "max_depth": {
      "description": "Max tree depth to descend (default 12, max 20).",
      "type": "integer"
    }
  },
  "required": [],
  "type": "object"
}

Ejemplo documental

Ejemplo de documentación para ui_read_tree. No ejecutes este ejemplo. Los argumentos mostrados pertenecen a un conjunto de datos ficticio; resuelve identificadores reales y obtén autorización antes de una llamada real.

{}