Todas las herramientas

ui_type

Pantalla, ventanas e interfaz · macOS · Windows

Efecto: ejecución. 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

Escribe texto en el control enfocado (o enfoca element_ref primero y luego escribe). Envía eventos clave reales para que se activen los controladores/validación. El resultado está VERIFICADO AL VOLVER A LEER el control, no por la escritura posterior: `{typed, verified:true}` significa que su valor realmente cambió; input_not_applied es un error explícito que significa que los eventos se publicaron y el valor NO cambió (no se escribió nada; generalmente la ventana no está al frente); `verified:false` + `verification:'unavailable'` significa que el destino no publica ningún valor legible, por lo que no se pudo confirmar la entrega y debes volver a leerlo. Requiere permiso de accesibilidad.

Entradas obligatorias

Los nombres se conservan exactamente como los exige la herramienta. Las definiciones técnicas canónicas, en inglés, están en el esquema expandible de abajo.

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": {
    "element_ref": {
      "description": "Optional; focus this element first.",
      "type": "string"
    },
    "text": {
      "description": "The text to type.",
      "type": "string"
    }
  },
  "required": [
    "text"
  ],
  "type": "object"
}

Ejemplo documental

Ejemplo de documentación para ui_type. 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.

{
  "text": "Can we review the launch checklist on Tuesday?"
}

Windows

Propósito

Escribe texto en el control enfocado (o enfoca element_ref primero y luego escribe). Envía eventos clave reales para que se activen los controladores/validación.

Entradas obligatorias

Los nombres se conservan exactamente como los exige la herramienta. Las definiciones técnicas canónicas, en inglés, están en el esquema expandible de abajo.

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": {
    "element_ref": {
      "description": "Optional; focus this element first.",
      "type": "string"
    },
    "text": {
      "description": "The text to type.",
      "type": "string"
    }
  },
  "required": [
    "text"
  ],
  "type": "object"
}

Ejemplo documental

Ejemplo de documentación para ui_type. 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.

{
  "text": "Can we review the launch checklist on Tuesday?"
}