Inject Js Script

Atividade Inject Js Script, que executa o código JavaScript no contexto da página da web correspondente a um ElementoDaUI.

UiPath.Core.Activities.InjectJsScript

Executa o código JavaScript no contexto da página da Web correspondente a um ElementoDaUI.

Propriedades

Entrada

• CódigoDoScript - O código JavaScript que você deseja executar.Você pode escrevê-lo aqui como uma string ou adicionar o caminho completo de um arquivo .js que contém o código a ser executado. Deve conter uma única função anônima, como nestes exemplos:

  function (element, input) {
    return "result";
  }
  

  async function (element, input) 
  {
    const asyncResult = await new Promise((resolvePromiseCb) => 
    {
      const timeoutMs = 100;
      setTimeout(() => 
      {
        resolvePromiseCb("async_result");
      }, 
      timeoutMs);
    });
    return asyncResult;
  }
  

  Onde element representa o elemento HTML correspondente ao nó de interface gráfica solicitado, e input representa a string de entrada fornecida pelo solicitante.

• ParâmetroDeEntrada - Dados de entrada para o código JavaScript, como uma string ou variável de string.

• Destino.Seletor - Propriedade de texto usada para localizar um determinado elemento de interface gráfica quando a atividade é executada. Em realidade, é um fragmento XML especificando atributos do elemento GUI procurado e de alguns de seus pais.

• Destino.TempoLimiteEmMs - Especifica o período (em milissegundos) que se deve aguardar para a execução da atividade antes de gerar o erro SelectorNotFoundException. O valor padrão é de 30.000 milissegundos (30 segundos).

• Target.WaitForReady - Antes de executar as ações, aguarda o destino ficar pronto. As seguintes opções estão disponíveis:

  • Nenhum — não espera por nada, exceto o elemento de interface gráfica do alvo existir antes de executar a ação. Por exemplo, você pode usar essa opção se quiser recuperar apenas o texto de uma página web ou clicar em um botão específico, sem precisar esperar todos os elementos da interface gráfica carregarem. Observe que isso pode ter consequências indesejadas se o botão depender de elementos ainda não carregados, como scripts.
  • Interativo/Completo - Espera que todos os elementos da interface gráfica no aplicativo de destino existam antes de executar, de fato, a ação.Para avaliar se um aplicativo está no estado Interativo ou Concluído, as seguintes tags são verificadas:
  • Aplicativos de área de trabalho — uma mensagem wm_null é enviada para verificar a existência das tags,<wnd> ,<ctrl> ,<java> ou. <uia>Se existirem, a atividade é executada.
  • Aplicativos web:
  1. Internet Explorer - A tag <webctrl> é usada para verificar se o estado Pronto do documento HTML está definido como Concluído. Além disso, o estado Ocupado deve ser definido como “Falso”.
  2. Outros - A tag <webctrl> é usada para verificar se o estado Pronto do documento HTML está Concluído.
  • Aplicativos SAP — primeiro a presença da tag <wnd> é verificada e, depois disso, uma API específica do SAP é usada para detectar se a sessão está ocupada ou não.

• Target.Element - Use a variável ElementoDaUI retornada por outra atividade. Essa propriedade não pode ser usada com a propriedade Seletor. Esse campo é compatível apenas com variáveis ElementoDaUI.

• Destino.RegiãoDeRecorte - Define o retângulo de clipagem, em pixels, em relação ao ElementoDaUi, conforme as seguintes direções: esquerda, superior, direita, inferior. Suporta números positivos e negativos.

Saída

• SaídaDoScript - String resultante retornada do código JavaScript.

Comum

• DisplayName - O nome de exibição da atividade.

• ContinuarComErro — especifica se a automação deve continuar mesmo quando a atividade gera um erro. Este campo só aceita valores booleanos (True, False). O valor padrão é False. Como resultado, se o campo estiver em branco e um erro for lançado, a execução do projeto será interrompida. Se o valor for definido como True, a execução do projeto prosseguirá mesmo com erros.

  Observação:

  Se esta atividade estiver incluída em Try Catch e o valor da propriedade Continuar com erro for Verdadeiro, nenhum erro será capturado quando o projeto for executado.

Diversos

• Privado - Se selecionado, os valores de variáveis e argumentos não são mais registrados no nível Verbose.

Opções

• Execution world - The JavaScript environment for the script execution.
  • Isolated - Allows access to the HTML elements, but prevents access to page variables and code. Use this option to ensure that the script execution does not conflict with the page.
  • Página - Permite acesso aos elementos HTML, variáveis de página e código. Use esta opção se você precisar acessar variáveis de página (por exemplo, jQuery $) ou para interagir com o código de página (por exemplo, window.alert). Usar essa opção é necessário para corrigir esse problema conhecido específico das extensões MV3.

Você pode alterar a propriedade Mundo de execução para todas as atividades Inject Js Script por meio das Configurações do projeto.

Observação:

The Execution world option is available starting with UiPath.UIAutomation.Activities version 22.12.

Exemplo de uso da atividade Inject JS Script

A atividade Inject JS Script é usada para abrir o navegador e processar os arquivos .js contidos nas páginas. As extensões do navegador devem estar instaladas e habilitadas.

Para exemplificar como utilizar esta atividade, criamos um exemplo que abre um navegador e exibe um alerta com o texto especificado pelo usuário.

É assim que um processo de automação pode ser construído:

1. Abra o Studio e crie um Processo.
   Observação:

   Certifique-se de colocar o arquivo .js na pasta do projeto. Para este exemplo, usamos o arquivo example.js.

2. Drag a Sequence to the Workflow Designer.

   • Crie as seguintes variáveis:

     Nome da variável	Tipo de Variável	Valor Padrão
     TextToWrite	GenericValue

3. Arraste uma atividade Input Dialog para dentro do contêiner Sequência.
   • In the Properties panel, add the name Ask for message in the DisplayName field.
   • Adicione a expressão "Please insert the text to be written on the web page." ao campo Rótulo.
   • Adicione a mensagem "Please insert text" ao campo Título.
   • Adicione a variável textToWrite no campo Resultado.
4. Coloque uma atividade Open Browser abaixo da atividade Input Dialog.
   • Adicione o endereço "https://www.google.com/" ao campo Url.
5. Arraste uma atividade Inject JS Script ao contêiner Corpo da atividade Open Browser.
   • No painel Propriedades, adicione o nome Show Alert no campo Nome de exibição.
   • Adicione a variável TextToWrite ao campo ParâmetroDeEntrada.
   • Adicione a expressão "Inject JS\example.js" ao campo CódigoDoScript.
6. Execute o processo. O robô abre uma nova página do navegador e fornece o alerta com o texto adicionado por você.

Baixe o exemplo