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 lateralmente. 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.

Run JS

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.

Aba de execução

Na aba de execução são exibidos o resultado e as informações da execução. Também é possível nela abortar a execução corrente (botão vermelho ou Ctrl+E Shift+B), executar novamente (botão verde ou Ctrl+E R), ou abrir o arquivo que foi executado (botão “Go to File”). 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.

Executar em nova aba

Ao executar um código, a extensão sempre tentará reutilizar a aba de execução já aberta para aquele arquivo. Caso o desenvolvedor queira que a execução seja aberta em uma nova aba, poderá usar uma das opções Run on Engine (New Tab) ou Run Selection on Engine (New Tab) 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 Tab)” (Ctrl+E Shift+L). O primeiro comando tentará utilizar uma aba de execução corrente, enquanto o segundo forçará a abertura do resultado da execução em uma nova aba.

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.

Configurando a coluna de exibição

Por padrão a aba de execução será aberta em uma coluna ao lado do editor ativo. É possível configurar este comportamento nas configurações do VS Code, em “User Settings > Extensions > Engine DevTools”. As opções são beside (coluna ao lado) e active (coluna ativa).

Também é possível alterar essa configuração diretamente pelo comando Engine DevTools: Change Code Runner Column Config.