Visão geral

Um script é uma sequência de instruções em uma pequena linguagem semelhante a C. Ela tem variáveis, if/else, um loop for, operadores aritméticos, de comparação, lógicos e bit a bit, e chamadas a funções internas: as funções que o mecanismo oferece, como WindowMaximize ou KeyboardPressKeyCombo. Não é possível definir funções próprias, e não há arrays nem objetos. Todo valor é um único escalar.

O script de uma ação é escrito para um de dois mecanismos, e ambos são compilados para o mesmo bytecode:

• Script: a linguagem em texto que esta referência documenta.
• Passos: uma lista TOML de passos, usada pelo editor de passos da interface de configuração e pelas macros gravadas. Consulte O mecanismo Passos.

Um script é compilado antes de ser executado. Um erro de sintaxe, uma função interna desconhecida ou um número errado de argumentos impede que ele seja executado, e você recebe um único erro com a linha e a coluna. Depois de compilado, ele é executado de cima para baixo em uma thread própria.

observação

Experimente no console de diagnóstico. Abra-o pelo item Mostrar console do menu da bandeja. A guia Script do console executa um script imediatamente, envia a saída de UtilityPrint para essa guia e completa nomes de funções internas enquanto você digita. Todos os exemplos desta referência podem ser colados nela.