Execução de código
Introdução
O Engine DevTools disponibiliza a opção de execução de códigos Javascript ou SQL de maneira direta
a partir do arquivo sendo editado, com exibição de resultados e informações da execução sendo
exibidos no painel inferior, na aba Engine Results. Para executar um código, basta utilizar o
botão verde com o símbolo de play no canto superior direito do editor. Outras opções são o
atalho Ctrl+E R ou a opção “Run on Engine” no menu de contexto do editor.
A execução dará preferência para caso haja uma seleção ativa no arquivo sendo editado. Neste caso, apenas o trecho selecionado será executado. A opção no menu de contexto também é alterada de “Run on Engine” para “Run Selection on Engine”. Caso não haja seleção ativa, o conteúdo por completo do arquivo é executado.
Os resultados são exibidos na aba Engine Results. Clicar em uma execução listada na árvore automaticamente abre o arquivo que foi executado.
Ao reexecutar um arquivo completo, o conteúdo corrente será utilizado. Ao reexecutar uma seleção, o exato código que foi executado anteriormente será utilizado. Quando uma execução de seleção é aberta, seu arquivo original é exibido com a seleção correspondente ativa (caso aquele trecho do código não tenha sido modificado).
Executar em nova instância
Ao executar um código, a extensão sempre tentará reutilizar a instância em Engine Results já
aberta para aquele arquivo. Caso o desenvolvedor queira que a execução seja aberta em uma nova
instância, poderá usar uma das opções Run on Engine (New) ou Run Selection on Engine (New)
no menu de contexto do editor, ou o atalho Ctrl+E Shift+R.
Executar linha corrente
É possível executar apenas a linha de código na qual o cursor está posicionado. Para isso,
utilize uma das seguintes opções do menu, “Run Current Line on Engine” (Ctrl+E L) ou
“Run Current Line on Engine (New)” (Ctrl+E Shift+L). O primeiro comando tentará utilizar a
instância corrente, enquanto o segundo forçará a abertura do resultado da execução em uma nova
instância.
Javascript Runtime
É possível alterar o javascript runtime a ser utilizado no servidor na execução de scripts.
Para isso, basta rodar o
comando
Engine DevTools: Change Javascript Runtime, selecionar a base de dados desejada (caso esteja
conectado a mais de uma) e escolher entre as opções ‘ije’, ‘v8’ ou ‘server default’.
Esta funcionalidade também pode ser acessada no menu de contexto da base de dados desejada,
na view do Engine DevTools.
Variáveis de ambiente
Ao utilizar valores recorrentes ou dados sensíveis dentro de um script que será executado, recomenda-se a utilização de variáveis de ambiente. Acesse o menu “Variáveis” para mais informações de como criá-las e utilizá-las em um script.