Automatize aplicativos da Web que usam o padrão Shadow DOM

Certos aplicativos modernos da Web usam o padrão Shadow DOM para fornecer encapsulamento de estilo e comportamento para controles reutilizáveis, de modo que os estilos e scripts desses controles não interfiram com o restante da página. Ele restringe o acesso direto a objetos Shadow DOM através do DOM normal.

O Gravador oferece suporte a automações baseadas em objetos de aplicativos modernos, garantindo uma automação contínua e minimizando o risco de falhas na automação.

Para dar suporte a essas automações, você pode usar as seguintes propriedades:
  • Caminho do shadow-root: Use a propriedade caminho do shadow-root para identificar e acessar os elementos dentro do shadow DOM. Esta propriedade permite que o Gravador localize e automatize com precisão os elementos que estão encapsulados e não são diretamente acessíveis através do DOM padrão. É representado como uma lista de matriz JSON de todos os elementos de shadow root no formato string, definindo o limite dentro do qual o Gravador buscará o elemento alvo. Variáveis podem ser usadas, mas caracteres curinga (*) não são suportados. Esta é a propriedade padrão para elementos que estão dentro do Shadow DOM.
    Nota: Certifique-se de selecionar a propriedade caminho do shadow-root para automatizar elementos de shadow root. Ao automatizar elementos de shadow root dentro de uma página da Web, o Gravador primeiro buscará o elemento específico por ID e depois por seletor CSS.

    Propriedades para automatizar elementos de shadow root

  • Seletor CSS: os seletores CSS são usados para identificar e interagir com elementos em uma página da Web de maneira semelhante a um DOMXPath. Use a propriedade Seletor CSS para selecionar elementos no DOM usando a sintaxe de seletor CSS, como classe, id ou nome de tag. Os seletores CSS são usados para direcionar elementos com base em seus atributos. Se o seu elemento estiver dentro do shadow DOM, então os seletores CSS devem ser usados em conjunto com a propriedade Caminho do shadow-root. Variáveis podem ser usadas, mas caracteres curinga (*) não são suportados.
    Nota: Esta propriedade está disponível para todos os elementos HTML.
    Importante: Os seletores CSS funcionarão de forma correta mesmo que você não esteja usando a versão mais recente do pacote Gravador (3.3.1-20241001-095119), desde que a versão da extensão do Google Chrome seja 3.3.0.0 ou posterior. No entanto, se a versão da extensão do Google Chrome for anterior a 3.3.0.0, certifique-se de desmarcar a propriedade do seletor CSS para que suas automações sejam executadas com sucesso.
Você pode capturar e automatizar os seguintes elementos dentro do Shadow DOM:
  • Caixa de texto
  • Caixa de combinação
  • Caixa de seleção
  • Botão
  • Botão de rádio
  • Link
  • Rótulo
  • Exibição de lista
  • Tabela

Capacidade de suporte

  • A capacidade é compatível com os navegadores Google Chrome e Microsoft Edge.
  • Quadros e IFrames (mesmo domínio e domínio cruzado) são compatíveis.
  • Compatível com as condições Objeto existe e Objeto não existe nos seguintes ações: Se, Loop > Enquanto ação, e Esperar > Esperar pela condição ação.
  • Compatível com todos os controles HTML existentes e suas ações correspondentes .
  • Suporta VMware Horizon, Citrix XenApp e XenApp (CR) para XenApp (aplicativo de negócios).

Comportamento conhecido

  • A automatização de elementos de shadow root usando a propriedade DOMXPath não é suportada.
  • Os elementos dentro de um elemento shadow root encerrado não podem ser acessados.
  • A busca de elementos por todos os algoritmos não é suportada.
  • A automatização de elementos de shadow root dentro de iframes aninhados de domínios cruzados não é suportada.
  • Ao usar a ação Obter propriedade, a propriedade Caminho do shadow-root não exibirá nenhum valor.