Inject Js Script

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.

• ContinueOnError - Specifies if the automation should continue even when the activity throws an error. This field only supports Boolean values (True, False). The default value is False. As a result, if the field is blank and an error is thrown, the execution of the project stops. If the value is set to True, the execution of the project continues regardless of any error.

  Observação:

  If this activity is included in Try Catch and the value of the ContinueOnError property is True, no error is caught when the project is executed.

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