O ChromeDriver oferece suporte ao registro de desempenho, em que você pode receber eventos dos domínios "Timeline", "Network" e "Page", bem como dados de rastreamento para categorias de rastreamento especificadas.
Ativar registros de desempenho
O registro de desempenho NÃO está ativado por padrão. Portanto, ao criar uma nova sessão, é necessário ativá-la.
DesiredCapabilities cap = DesiredCapabilities.chrome(); LoggingPreferences logPrefs = new LoggingPreferences(); logPrefs.enable(LogType.PERFORMANCE, Level.ALL); cap.setCapability(CapabilityType.LOGGING_PREFS, logPrefs); RemoteWebDriver driver = new RemoteWebDriver(new URL("http://127.0.0.1:9515"), cap); Quando ativado, o registro de performance coleta eventos de linha do tempo, rede e página. Para ativar o rastreamento ou personalizar o registro de desempenho, continue lendo.
Confira um exemplo completo de geração de registros de desempenho com opções padrão, escrito por Michael Klepikov.
O Angular Benchpress também usa a geração de registros de desempenho.
Rastreamento e geração de registros personalizada
Se você precisar personalizar o registro de desempenho, para ativar o rastreamento, por exemplo, use o capability perfLoggingPrefs (via ChromeOptions). O rastreamento pode ser ativado especificando uma ou mais categorias de rastreamento do Chrome. Leia mais informações sobre o Rastreamento do Chrome.
Quando o rastreamento está ativado, o domínio da Linha do tempo é desativado implicitamente. Ainda é necessário ativar o registro de desempenho com o recurso loggingPrefs.
DesiredCapabilities cap = DesiredCapabilities.chrome(); LoggingPreferences logPrefs = new LoggingPreferences(); logPrefs.enable(LogType.PERFORMANCE, Level.ALL); cap.setCapability(CapabilityType.LOGGING_PREFS, logPrefs); Map<String, Object> perfLogPrefs = new HashMap<String, Object>(); perfLogPrefs.put("traceCategories", "browser,devtools.timeline,devtools"); // comma-separated trace categories ChromeOptions options = new ChromeOptions(); options.setExperimentalOption("perfLoggingPrefs", perfLogPrefs); caps.setCapability(ChromeOptions.CAPABILITY, options); RemoteWebDriver driver = new RemoteWebDriver(new URL("http://127.0.0.1:9515"), cap); Também é possível usar perfLoggingPrefs para ativar ou desativar os domínios de rede e página individualmente. Por exemplo, é possível ativar explicitamente o domínio de rede durante o rastreamento:
... Map<String, Object> perfLogPrefs = new HashMap<String, Object>(); perfLogPrefs.put("traceCategories", "browser,devtools.timeline,devtools"); perfLogPrefs.put("enableNetwork", true); ChromeOptions options = new ChromeOptions(); options.setExperimentalOption("perfLoggingPrefs", perfLogPrefs); caps.setCapability(ChromeOptions.CAPABILITY, options); ... Se o rastreamento estiver ativado, o ChromeDriver vai iniciar um rastreamento em todo o navegador quando o Chrome for iniciado e continuará rastreando até que o Chrome seja fechado. Quando um trace está em execução, o Chrome armazena em buffer os eventos de trace na memória até que o trace seja interrompido.
Quando o buffer de rastreamento está cheio, os eventos de rastreamento não são mais gravados. Para evitar um buffer cheio (e, portanto, dados de rastreamento perdidos), o ChromeDriver interrompe periodicamente o traço atual, coleta os eventos em buffer e reinicia o rastreamento em determinados pontos durante um teste.
A coleta de eventos de rastreamento pode aumentar a sobrecarga de um teste. Por isso, o ChromeDriver só coleciona eventos de rastreamento nos pontos adequados durante um teste. Os eventos de rastreamento são coletados apenas em eventos de navegação de página e quando qualquer registro do ChromeDriver (como o registro de desempenho) é solicitado.
Sempre há a possibilidade de o buffer encher, então o ChromeDriver monitora o uso do buffer para versões do Chrome com suporte (r263512 e mais recentes). Se o buffer for preenchido, o ChromeDriver vai registrar um aviso e adicionar uma entrada ao registro de desempenho.
Coletar entradas de registro
No teste, é possível receber entradas de registro de desempenho. Leia a documentação de geração de registros do WebDriver para mais informações.
for (LogEntry entry : driver.manage().logs().get(LogType.PERFORMANCE)) { System.out.println(entry.toString()); } Cada entrada é uma string JSON com a seguinte estrutura:
{ "webview": <originating WebView ID>, "message": { "method": "...", "params": { ... }} // DevTools message. } O valor do método é o método do evento das Ferramentas do desenvolvedor. Por exemplo, os eventos da linha do tempo têm um método Timeline.eventRecorded para todas as versões do protocolo até a versão 1.1 (a mais recente no momento em que este artigo foi escrito).
Entradas de registro de rastreamento
O rastreamento não faz parte do protocolo publicado do DevTools a partir da versão 1.1. Confira os detalhes aqui.
Todos os eventos de rastreamento têm um valor de visualização da Web "navegador", já que os eventos são coletados em todo o navegador.
Há dois métodos de evento de rastreamento possíveis:
tracing.dataCollected: os parâmetros são um único evento de rastreamento na forma de um dicionário.tracing.bufferUsage: os parâmetros contêm uma única chave de erro, com uma mensagem que indica que o buffer de rastreamento do DevTools foi preenchido durante o teste.
Confira um exemplo de evento de rastreamento:
{ "webview":"browser", "message":{ "method":"Tracing.dataCollected", "params":{ "args":{"layerTreeId":1}, "cat":"cc,devtools", "name":"DrawFrame", "ph":"i", "pid":11405, "s":"t", "tid":11405, "ts":3846117219.0, "tts":1134680 } } }