Referência de funções de módulo do Mecanismo de Teste (versão prévia)

Esta tabela fornece uma visão geral dos vários módulos disponíveis no Mecanismo de Teste do Power Apps e suas funções especializadas.

Função	Description	Link do módulo
ConsentDialogFunction	Verifica páginas personalizadas de um aplicativo controlado por modelos em busca de diálogos de consentimento e as manipula automaticamente durante a execução do teste.	testengine.module.mda
PauseFunction	Pausa o teste atual e permite que o usuário interaja com o navegador e inspecione o estado quando o modo sem cabeça é falso. Útil para testes de depuração.	testengine.module.pause
PlaywrightActionFunction	Executa ações do Dramaturgo para a página atual, permitindo a manipulação direta de elementos DOM usando seletores CSS e XPath.	testengine.module.playwrightaction
PlaywrightActionValueFunction	Executa ações do Dramaturgo que exigem parâmetros de valor extra, como preencher campos de formulário ou selecionar opções suspensas.	testengine.module.playwrightaction
PlaywrightScriptFunction	Permite a execução de scripts C# personalizados que interagem com APIs do Dramaturgo, fornecendo flexibilidade máxima para cenários de automação complexos.	testengine.module.playwrightscript
CheckConnectionExistsFunction	Verifica se existe uma conexão específica no Power Platform usando o provedor do portal do Power Apps.	testengine.module.powerapps.portal
CreateConnectionFunction	Cria conexões do Power Platform durante a execução do teste. Observação: essa abordagem deve ser considerada um backup, pois as conexões devem ser criadas com entidades de serviço sempre que possível.	testengine.module.powerapps.portal
ExportConnectionsFunction	Exporta informações de conexão para um arquivo JSON para fins de documentação ou reutilização. Compatível com o provedor do portal do PowerApps.	testengine.module.powerapps.portal
GetConnectionsFunction	Consulta e recupera informações de conexão disponíveis do Power Platform. Compatível com o provedor do portal do PowerApps.	testengine.module.powerapps.portal
UpdateConnectionReferencesFunction	Atualiza as referências de conexão do Power Platform. Deve ser usado como uma abordagem de backup, pois as conexões devem ser gerenciadas por entidades de serviço.	testengine.module.powerapps.portal
SampleFunction	Uma função de exemplo simples que demonstra como implementar um ReflectionFunction básico. Útil como um modelo inicial para o desenvolvimento de novas funções.	testengine.module.sample
SimulateConnectorFunction	Habilita a simulação de respostas do conector, permitindo que os testes são executados sem dependências reais do serviço externo.	testengine.module.simulation
SimulateDataverseFunction	Fornece recursos para simular respostas do Dataverse, habilitando o teste sem dependências reais do Dataverse.	testengine.module.simulation
VisualCompareFunction	Executa a comparação visual entre capturas de tela usando OpenCV, permitindo a verificação baseada em imagem de elementos da interface do usuário.	testengine.module.visualcompare

Como usar essas funções

Essas funções estão disponíveis por meio do namespace do Power Fx Preview quando os módulos correspondentes estão habilitados. Para habilitar um módulo nas configurações de teste, adicione o seguinte à configuração do YAML:

testSettings:
  extensionModules:
    enable: true
    allowPowerFxNamespaces:
      - Preview

Por exemplo, para usar a função PlaywrightAction em seu teste:

Preview.PlaywrightAction("//button[@id='submit']", "click")

Processo de contribuição

Se você quiser desenvolver mais módulos e funções para o Mecanismo de Teste, consulte a documentação do Ciclo de Vida do Recurso para obter informações sobre a progressão de recursos de contribuições de software livre para disponibilidade geral.