Depuração do JavaScript

JavaScript Debugger no Acrobat Professional

O JavaScript Debugger no Acrobat Professional permite testar os scripts do JavaScript. O Debugger inclui o JavaScript Console, onde você pode testar partes do código JavaScript na guia Visualizar PDF. O JavaScript Console oferece uma interface interativa e conveniente para testar partes do código JavaScript, bem como métodos e propriedades de objetos. Devido a essa essência interativa, o JavaScript Console age como um editor que oferece suporte à execução de linhas únicas ou de blocos de código.

Para ativar o JavaScript Debugger para o Designer e executar o código pelo JavaScript Console, ative o JavaScript e o JavaScript Debugger no Acrobat Professional.

Para ativar o JavaScript Debugger para o Designer

1. Inicie o Designer.

2. Inicie o Acrobat Professional.

3. No Acrobat Professional, selecione Editar > Preferências.

4. Selecione JavaScript na lista à esquerda.

5. Selecione a opção Iniciar Acrobat JavaScript se ela ainda não estiver marcada.

6. Em JavaScript Debugger, selecione Ativar o JavaScript Debugger depois da reinicialização do Acrobat.

7. Selecione Ativar console interativo. Essa opção permite avaliar o código gravado no JavaScript Console.

8. Selecione Mostrar erros e mensagens do console. Essa opção garante a exibição de informações úteis por parte do Java Script Console sempre que ocorrerem erros.

9. Clique em OK para fechar a caixa de diálogo Preferências.

10. Saia do Acrobat Professional.

11. No Designer, clique na guia Visualizar PDF.

12. Pressione Ctrl+J para abrir o JavaScript Debugger.

Para evitar que o JavaScript Debugger desapareça no Designer

Se o JavaScript Debugger do Acrobat estiver ativo e desaparecer quando você clicar em componentes na interface do Designer, interrompa o processo do Acrobat.exe no Gerenciador de tarefas do Microsoft Windows. O processo Acrobat.exe continua em execução depois do encerramento do Acrobat para possibilitar que o aplicativo Acrobat seja exibido mais rápido se for reiniciado. Parar o processo encerra a associação entre o JavaScript Debugger e a sessão do Acrobat Professional e, portanto, será possível utilizar o JavaScript Debugger no Designer.

1. No Gerenciador de tarefas do Windows, clique na guia Processos.

2. Na coluna Nome da imagem, clique com o botão direito do mouse em Acrobat.exe e selecione Finalizar processo.

Como avaliar o código usando o JavaScript Console

Há três maneiras de avaliar linhas únicas e múltiplas de código usando o JavaScript Console do Acrobat.

Para avaliar uma parte de uma linha do código

 Realce a parte na janela do console e pressione a tecla Enter no teclado numérico ou Ctrl+Enter no teclado comum.

Para avaliar uma única linha do código

 Coloque o cursor na linha apropriada na janela do console e pressione a tecla Enter no teclado numérico ou Ctrl+Enter no teclado comum.

Para avaliar várias linhas do código

 Realce essas linhas na janela do console e pressione a tecla Enter no teclado numérico ou Ctrl+Enter no teclado comum.

Para excluir o conteúdo que aparece no JavaScript Console

 Clique em Limpar na janela do console.

O resultado do script JavaScript avaliado mais recentemente é exibido na janela do console.

Depois da avaliação de cada script JavaScript, a janela do console indicará undefined, que é o valor de retorno dessa declaração. Observe que o resultado de uma declaração não apresenta o mesmo valor de uma expressão dentro dessa declaração. O valor de retorno undefined não significa que o valor de script é indefinido, mas sim que o valor de retorno da declaração JavaScript é indefinido.

Fornecimento de retorno da depuração para o JavaScript Console

Se você estiver criando scripts usando JavaScript, poderá gerar mensagens para o JavaScript Console pelo Acrobat em tempo de execução usando o método console.println incluído com o Modelo de objeto JavaScript do Acrobat. Quando iniciado, o método console.print1n exibe um valor de string no JavaScript Console. O valor da string pode ser uma mensagem de texto criada para depuração ou o valor da string de campos ou expressões.

Por exemplo, considere um design de formulário simples que contém um único campo numérico (NumericField1) e um botão (Button1). Nesse caso, o script JavaScript a seguir gera uma mensagem exibindo algum texto e o valor exibido no momento no campo numérico. Ao adicionar o cálculo ou o script ao evento click do objeto de botão, é possível exibir interativamente o valor do campo numérico em uma nova caixa de diálogo clicando no botão.

    console.println("The value is: " + NumericField1.rawValue);

Para obter mais informações sobre o método console.println e o Modelo de objeto JavaScript da Acrobat, consulte Developing Acrobat Applications Using JavaScript (Desenvolvimento de aplicativos Acrobat usando JavaScript) (somente em inglês).

Para obter mais informações sobre o JavaScript Console e o JavaScript Debugger, consulte Developing Acrobat Applications Using JavaScript (Desenvolvimento de aplicativos Acrobat usando JavaScript) (somente em inglês).

Fornecimento de retorno da depuração usando o método alert

Se quiser retornar uma caixa de mensagem durante um evento calculate, poderá tirar proveito do método alert do Modelo de objetos JavaScript do Acrobat. Por exemplo, o script a seguir retorna o valor de um campo de texto:

    var oField = xfa.resolveNode("TextField1").rawValue; app.alert(oField);

Para obter mais informações sobre o método alert e o Modelo de objeto JavaScript da Acrobat, consulte Developing Acrobat Applications Using JavaScript (Desenvolvimento de aplicativos Acrobat usando JavaScript) (somente em inglês).