• EnglishEspañol日本語한국어Português
  • EntrarComeçar agora

Esta tradução de máquina é fornecida para sua comodidade.

Caso haja alguma divergência entre a versão em inglês e a traduzida, a versão em inglês prevalece. Acesse esta página para mais informações.

Criar um problema

Referência do browser com script do Sintético (monitor versões 0.5.0 e 0.6.0)

Este documento descreve as funções do browser com script disponíveis para o monitor Sintético versões 0.5.0 ou 0.6.0. Se você estiver usando uma versão mais recente do monitor, consulte a versão do monitor Chrome 100 e a documentação mais recente. Se você estiver usando versões mais antigas do monitor, consulte a versão 0.4.0 do monitor e a documentação inferior.

Para obter mais informações sobre versões de monitor e diferenças de tempo de execução, consulte Ambientes de tempo de execução.

Importante

A partir de 26 de agosto de 2024, você não poderá mais criar novos monitores usando tempos de execução legados em locais públicos ou privados.

No dia 22 de outubro de 2024, encerraremos a vida útil das versões conteinerizadas minion privado (chamadas por minuto) e legado runtime do Synthetics. Para localização pública, use a interface de atualização de tempo de execução para atualizar seu monitor para os tempos de execução mais recentes. Para localização privada, revise nossas etapas de migração recomendadas para evitar a degradação monitor .

O tempo de execução do browser Chrome 100+ oferece suporte compatível com versões anteriores para 0.5.0 e 0.6.0 sintaxe de tempo de execução do browser.

Para alguns exemplos de uso comum, consulte Introdução ao script com monitor do browser.

API Selenium Webdriver

Ao utilizar as variáveis $driver e $browser, seu navegador com script obtém acesso ao Selenium Webdriver API 3.6.0 para monitor versão 0.6.x e Selenium Webdriver API 3.5.0 para monitor versão 0.5.x.

Em particular:

  • $driver fornece todas as exportações do módulo selenium-webdriver (por exemplo, ActionSequence, Button, By, WebElement, etc.).
  • $browser é uma instância de monitoramento sintético de selenium-webdriver.WebDriver(). Ele expõe as principais API básicas do WebDriver como get() e findElement(), bem como algumas API personalizadas do Sintético.

Funções de nível superior: crie seu script

O New Relic chama funções de nível superior diretamente da sua instância $browser . Eles fornecem uma ampla gama de funcionalidades que abrangem muitas ações básicas programáveis.

Função

Descrição

$browser.actions()

Cria uma nova sequência de ações usando este driver. Para obter uma lista de ações disponíveis, consulte ActionSequence.

Valor de retorno: nulo

$browser.addHeader(headerKey: string, headerValue: string)

Adiciona o cabeçalho headerKey com valor headerValue ao tempo de execução.

Valor de retorno: nulo

$browser.addHeaders(headers: ?)

Adiciona um mapa de cabeçalhos ao tempo de execução.

Valor de retorno: nulo

$browser.deleteHeader(header: string)

Exclui um cabeçalho específico do tempo de execução.

Valor de retorno: nulo

$browser.deleteHeaders(header: [string])

Exclui todos os cabeçalhos do argumento do tempo de execução.

Valor de retorno: nulo

$browser.addHostnameToBlacklist(hostname: string)

Adiciona um nome do host à sua lista de negações. Permite o uso de curingas.

Valor de retorno: nulo

$browser.addHostnamesToBlacklist(hostnameArr: [string])

Adiciona todos os nomes do host em uma matriz de argumentos à sua lista de negação. Permite o uso de curingas.

Valor de retorno: nulo

$browser.addHostnameToWhitelist(hostname: string)

Adiciona um nome do host bloqueado por padrão no monitoramento sintético à sua lista de permissões.

Valor de retorno: nulo

$browser.addHostnamesToWhitelist(hostnameArr: [string])

Adiciona todos os nomes do host no argumento à sua lista de permissões.

Valor de retorno: nulo

$browser.deleteHostnameFromBlacklist(hostname: string)

Remove um nome do host para esta instância do browser da sua lista de negações.

Valor de retorno: nulo

$browser.deleteHostnamesFromBlacklist(hostnameArr: [string])

Remove todos os nomes do host no argumento da sua lista de negações.

Valor de retorno: nulo

$browser.deleteHostnameFromWhitelist(hostnameArr: [string])

Remove um nome do host para esta instância do browser da sua lista de permissões.

Valor de retorno: nulo

$browser.deleteHostnamesFromWhitelist(hostnameArr: [string])

Remove todos os nomes do host no argumento da sua lista de permissões para esta instância do browser.

Valor de retorno: nulo

$browser.executeAsyncScript(script: ?, var_args: ?)

Agenda um comando para executar JavaScript assíncrono no contexto do quadro ou janela atualmente selecionado.

Valor de retorno: promessa

$browser.executeScript(script: ?, var_args: ?)

Agenda um comando para executar JavaScript no contexto do quadro ou janela atualmente selecionado.

Valor de retorno: promessa

$browser.findElement(locator: $driver.Locator)

Agende um comando para localizar um elemento na página. Se não for encontrado, o monitoramento sintético retornará um erro.

Valor de retorno: WebElementPromise

$browser.findElements(locator: $driver.Locator)

Agende um comando para pesquisar vários elementos na página.

Valor de retorno: promessa

$browser.waitForAndFindElement(locator: $driver.Locator [, timeout: number)

Agende um comando para esperar e encontrar um elemento na página e outro comando para esperar que ele fique visível. Se não for encontrado, o monitoramento sintético retornará um erro.

O valor do tempo limite é opcional. É aplicado separadamente para ambas as tarefas de localização do elemento e espera pela sua visibilidade. Isso significa que, na pior das hipóteses, esse método pode levar até o dobro do valor de tempo limite fornecido. O valor de tempo limite padrão é 1000 ms (1 segundo).

Valor de retorno: WebElementPromise

$browser.get(url: string)

Carrega uma página web em um browser Sintético.

Valor de retorno: promessa

$browser.getAllWindowHandles()

Agenda um comando para recuperar a lista atual de identificadores de janela disponíveis.

Valor de retorno: promessa

$browser.getCapabilities()

Uma promessa que será resolvida com as capacidades da instância.

Valor de retorno: promessa

$browser.getCurrentUrl()

Agenda um comando para recuperar a URL da página atual.

Valor de retorno: promessa

$browser.getHeaders()

Retorna um mapa dos cabeçalhos atualmente configurados.

Valor de retorno: mapa

$browser.getPageSource()

Agenda um comando para recuperar a origem da página atual. A origem da página retornada é uma representação do DOM subjacente. Não espere que ele seja formatado ou escapado da mesma forma que a resposta enviada do servidor web.

Valor de retorno: promessa

$browser.getSession()

Uma promessa para a sessão deste cliente.

Valor de retorno: promessa

$browser.getTitle()

Agenda um comando para recuperar o título da página atual.

Valor de retorno: promessa

$browser.getWindowHandle()

Agenda um comando para recuperar o identificador da janela atual.

Valor de retorno: promessa

$browser.manage()

A interface de opções para esta instância. Você pode gerenciar cookies, tempos limite e outras opções de janela.

Valor de retorno: nulo

$browser.navigate()

A interface de navegação (histórico das funções do browser) para esta instância.

Valor de retorno: nulo

$browser.schedule(command: ?, description: string)

Agenda um comando para ser executado pelo CommandExecutor deste driver.

Valor de retorno: promessa

$browser.sleep()

Agenda um comando para fazer o driver dormir por um determinado período de tempo.

Valor de retorno: promessa

$browser.switchTo()

A interface do localizador de destino para esta instância.

Valor de retorno: nulo

$browser.takeScreenshot()

Agenda um comando para fazer uma captura de tela.

Valor de retorno: promessa

$browser.wait(fn: $driver.Condition, timeout: number, opt_message: string)

Agenda um comando para aguardar que uma condição seja mantida, conforme definido pela função fornecida.

Valor de retorno: WebElement

$browser.waitForPendingRequests(timeout: number)

Faz com que o script aguarde o retorno das solicitações iniciadas, até o tempo limite. Útil para rastrear recursos sem bloqueio.

Valor de retorno: promessa

Lista de negações: uso de curinga

Se você quiser adicionar domínio à lista de negações da instância do seu browser, os curingas deverão corresponder à sintaxe do URL a ser bloqueado.

Uma lista de negações .com geral deve conter estas funções:

Função

Ação de bloqueio

$browser.addHostnameToBlacklist('*.com');

a.com

$browser.addHostnameToBlacklist('*.*.com');

a.b.com

$browser.addHostnameToBlacklist('*.*.*.com');

a.b.c.com

$browser.addHostnameToBlacklist('www.*.com');

www.a.com

$browser.addHostnameToBlacklist('www.*.*.com');

www.a.b.com

$browser.addHostnameToBlacklist('www.*.*.*.com');

www.a.b.c.com

Opções: Gerenciar a instância do browser

Essas funções gerenciam opções para a instância do seu browser, como cookies, tempos limite e tamanho da janela. Acesse essas opções por meio da função $browser.manage() .

Função

Descrição

$browser.manage().addCookie(spec: object)

Agenda um comando para adicionar um cookie.

spec é um objeto de registro que descreve um cookie do browser. Para obter mais informações, consulte a documentação do Selenium.

Valor de retorno: promessa

$browser.manage().deleteAllCookies()

Agenda um comando para excluir todos os cookies visíveis na página atual.

Valor de retorno: promessa

$browser.manage().deleteCookie(name: string)

Agenda um comando para excluir o cookie com o nome fornecido. Este comando é autônomo se não houver nenhum cookie com o nome fornecido visível na página atual.

Valor de retorno: promessa

$browser.manage().getCookie(name: string)

Agenda um comando para recuperar o cookie com o nome fornecido. Retorna nulo se esse cookie não existir. O cookie será retornado como um objeto JSON conforme descrito pelo protocolo de ligação Webdriver .

Valor de retorno: promessa

$browser.manage().getCookies()

Agenda um comando para recuperar todos os cookies visíveis na página atual. New Relic Syntheticcs retorna cada cookie como um objeto JSON conforme descrito pelo protocolo de ligação Webdriver .

Valor de retorno: promessa

$browser.manage().timeouts().implicitlyWait(ms: number)

Especifica quanto tempo o driver deverá esperar ao procurar um elemento se ele não estiver presente imediatamente. Definir o tempo limite de espera como 0 desativa a espera implícita.

Tenha cuidado ao aumentar o tempo limite de espera, pois isso aumentará o tempo de execução do teste, especialmente com estratégias de localização mais lentas, como XPath. O padrão é 10 segundos.

Valor de retorno: promessa

$browser.manage().timeouts().pageLoadTimeout(ms: number)

Define o tempo de espera para a conclusão do carregamento da página antes de retornar um erro. Se o tempo limite for negativo, o carregamento da página poderá durar até 180 segundos. O padrão é 60 segundos.

Valor de retorno: promessa

$browser.manage().timeouts().setScriptTimeout(ms: number)

Define o tempo de espera, em milissegundos, para que um script assíncrono termine a execução antes de retornar um erro. O padrão é 30 segundos.

Valor de retorno: promessa

$browser.manage().window().getPosition()

Recupera a posição atual da janela, em relação ao canto superior esquerdo da tela.

Valor de retorno: promessa

$browser.manage().window().getSize()

Recupera o tamanho atual da janela.

Valor de retorno: promessa

$browser.manage().window().maximize()

Maximiza a janela atual.

Valor de retorno: promessa

$browser.manage().window().setPosition(x: number, y: number)

Reposiciona a janela atual.

Valor de retorno: promessa

$browser.manage().window().setSize(width: number, height: number)

Redimensiona a janela atual.

Valor de retorno: promessa

Localizador: Localizar elemento da página

Localizador são uma coleção de funções de fábrica para criar locator instância. localizador encontra elementos DOM, que podem ser passados para funções como $browser.findElement. Ligue para eles através de $driver.By.

Função

Descrição

$driver.By.className(className: string)

Localiza um elemento que possui um nome de classe específico. O localizador retornado é equivalente a procurar elementos com o seletor CSS .class.

Valor de retorno: localizador

$driver.By.css(cssName: string)

Localiza um elemento usando um seletor CSS.

Valor de retorno: localizador

$driver.By.id(id: string)

Localiza um elemento pelo seu ID.

Valor de retorno: localizador

$driver.By.linkText(linkText: string)

Localiza elementos de link cujo texto visível corresponde à string fornecida.

Valor de retorno: localizador

$driver.By.js(js: string)

Localiza um elemento avaliando uma expressão JavaScript.

Valor de retorno: localizador

$driver.By.name(name: string)

Localiza elementos cujo atributo name possui o valor fornecido.

Valor de retorno: localizador

$driver.By.partialLinkText(partialLinkText: string)

Localiza elementos de link cujo getText visível contém a substring fornecida.

Valor de retorno: localizador

$driver.By.tagName(tagName: string)

Localiza elementos com um determinado nome de tag. O localizador retornado é equivalente ao uso da função DOM getElementsByTagName .

Valor de retorno: localizador

$driver.By.xpath(xpath: string)

Localiza elementos que correspondem a um seletor XPath.

Valor de retorno: localizador

WebElement: Interaja com o elemento da página

Quando uma função como $browser.findElement ou $browser.waitForAndFindElement retorna uma referência WebElement, essas funções podem ser usadas para interagir com esse elemento. Por exemplo, você pode clicar em botões, enviar texto para entradas do formulário e obter um atributo de elementos para testar.

Função

Descrição

click()

Clica neste elemento.

Valor de retorno: auto-referência

sendKeys(var_args: ?)

Agenda um comando para digitar uma sequência no elemento DOM representado por esta instância.

Valor de retorno: WebElement

getTagName()

Agenda um comando para consultar o nome da tag/nó deste elemento.

Valor de retorno: WebElement

getCssValue(name: string)

Agenda um comando para consultar o estilo computacional do elemento representado por esta instância. Se o elemento herdar o estilo nomeado de seu pai, o pai será consultado quanto ao seu valor. Sempre que possível, os valores das cores serão convertidos em sua representação hexadecimal (por exemplo, #00ff00 em vez de rgb(0, 255, 0)).

Valor de retorno: promessa

getAttribute(name: string)

Agenda um comando para consultar o valor de um determinado atributo do elemento.

Valor de retorno: promessa

getText(name: string)

Obtenha o innerText visível (não oculto pelo CSS) deste elemento, incluindo subelementos, sem nenhum espaço em branco à esquerda ou à direita.

Valor de retorno: promessa

getSize()

Agenda um comando para calcular o tamanho da caixa delimitadora deste elemento, em pixels.

Valor de retorno: promessa

getLocation()

Agenda um comando para calcular a localização deste elemento, no espaço da página.

Valor de retorno: promessa

isEnabled()

Agenda um comando para consultar se o elemento DOM representado por esta instância está habilitado, conforme ditado pelo atributo desabilitado.

Valor de retorno: promessa

isSelected()

Agenda um comando para consultar se este elemento está selecionado.

Valor de retorno: promessa

submit()

Programa um comando para enviar o formulário que contém este elemento (ou este elemento se for um elemento FORM ). Este comando não é operacional se o elemento não estiver contido em um formulário.

Valor de retorno: promessa

clear()

Agenda um comando para limpar o valor deste elemento.

Valor de retorno: promessa

isDisplayed()

Agenda um comando para testar se este elemento está sendo exibido no momento.

Valor de retorno: promessa

ActionSequence: vincular várias ações

As sequências de ação podem criar interações complexas do usuário com o seu site.

  • Para criar uma nova sequência de ações, use $browser.actions().
  • Para vincular diversas ações em uma sequência, inclua perform() após cada uma. Isso executa e finaliza sequências individuais, incluindo sequências de ação única.

A tabela a seguir contém uma lista de ações disponíveis. Para obter mais informações, consulte a documentação doWebdriver ActionSequence no GitHub.

Função

Descrição

click(opt_elementOrButton: ?, opt_button: ?)

Clica em um botão do mouse. Se um elemento for fornecido, o mouse será primeiro movido para o centro desse elemento. Isso é equivalente a WebElement.click().

Valor de retorno: sequência de ações

doubleClick(opt_elementOrButton: ?, opt_button: ?)

Clique duas vezes em um botão do mouse. Se um elemento for fornecido, o mouse será primeiro movido para o centro desse elemento.

Valor de retorno: sequência de ações

dragAndDrop(element: ?, location: ?)

Função de conveniência para realizar uma manobra de arrastar e soltar. O elemento alvo pode ser movido para a localização de outro elemento ou por um deslocamento (em pixels). A localização é um objeto com duas propriedades x e y: {x: x_offset, y: y_offset}.

Valor de retorno: sequência de ações

keyDown(key: ?)

Executa um pressionamento de tecla modificadora. Deve ser um de ALT, CONTROL, SHIFT, COMMAND ou META. A tecla modificadora não é liberada até que keyUp() ou sendKeys() seja chamado. O pressionamento da tecla será destino no elemento atualmente em foco.

Valor de retorno: sequência de ações

keyUp(key: ?)

Executa uma liberação de tecla modificadora. O lançamento é destino no elemento atualmente em foco.

Valor de retorno: sequência de ações

mouseDown(opt_elementOrButton: ?, opt_button: ?)

Pressiona um botão do mouse. O botão do mouse não será liberado até que mouseUp seja chamado, independentemente de a chamada ser feita nesta sequência ou em outra. O comportamento para eventos fora de ordem (como chamar mouseDown() ou click() quando o botão já está pressionado) é indefinido.

Valor de retorno: sequência de ações

mouseUp(opt_elementOrButton: ?, opt_button: ?)

Libera um botão do mouse. O comportamento é indefinido para chamar esta função sem uma chamada anterior para mouseDown().

Valor de retorno: sequência de ações

mouseMove(location: ?, offset: ?)

Move o mouse. A localização para a qual mover pode ser especificada em termos da localização atual do mouse, um deslocamento relativo ao canto superior esquerdo de um elemento ou um elemento (nesse caso, o meio do elemento é usado).

Valor de retorno: sequência de ações

perform()

Executa esta sequência de ação.

Valor de retorno: promessa

sendKeys(args: ?)

Simula a digitação de várias teclas. Cada tecla modificadora encontrada na sequência não será liberada até que seja encontrada novamente. Todos os eventos principais serão destino no elemento atualmente em foco. Para obter uma lista completa de chaves não alfanuméricas suportadas, consulte a documentação da chave enumWebdriver no GitHub.

Valor de retorno: sequência de ações

Promessas: vincular ações em sequências

Você também pode executar funções diretamente nas promessas. O monitoramento sintético é um ambiente nativo do Node.js e usa promessas padrão do Node.js.

Essas funções avaliam o status das promessas, cancelam-nas e muito mais. Em particular, você pode criar sequências de ações com a função then() e suas irmãs, finally() e catch(). Para obter mais informações, consulte Sequenciar ações.

Função

Descrição

isPending()

Se o valor desta promessa ainda está sendo computado.

Valor de retorno: booleano

then(opt_callback: fn(T: ?), opt_errback: fn())

Registra ouvintes para quando esta instância for resolvida. Esta é a função básica usada para vincular ações síncronas em seu script.

Valor de retorno: promessa

finally(callback: fn())

Registra um ouvinte para invocar quando esta promessa for resolvida, independentemente de o valor da promessa ter sido computado com sucesso.

Valor de retorno: promessa

catch(callback: fn())

Registra um ouvinte para quando esta promessa for rejeitada.

Valor de retorno: promessa

Navegar: percorrer o histórico do browser

A função $browser.navigate() expõe diversas funções que permitem retroceder e avançar no histórico do browser, atualizar sua página e navegar para novas páginas.

Função

Descrição

Condições: Faça uma pausa e aguarde as condições

Dica

Você pode aprender mais sobre esperas no Selenium aqui.

Usado com $browser.wait, until pausa a execução do script até que a condição seja atendida. Para obter mais informações, consulte a documentação Webdriver until do Selenium.

A seguir estão as funções disponíveis para $driver.until.Condition:

Função

Descrição

ableToSwitchToFrame(frame: ?)

Cria uma condição que aguardará até que o driver de entrada consiga alternar para o quadro designado. O quadro de destino pode ser especificado como:

  • Um índice numérico em window.frames para o quadro atual

  • Um webdriver.WebElement, que deve fazer referência a um elemento FRAME ou IFRAME na página atual

  • Um localizador que pode ser usado para localizar primeiro um FRAME ou IFRAME na página atual antes de tentar mudar para ele

    Após a resolução bem-sucedida desta condição, o driver permanecerá focado no novo quadro.

    Valor de retorno: condição

alertIsPresent()

Cria uma condição que aguarda a abertura de um alerta. Após sucesso, a promessa retornada será cumprida com o identificador do alerta aberto.

Valor de retorno: condição

elementIsDisabled(element: $driver.WebElement)

Cria uma condição que aguardará que determinado elemento seja desabilitado.

Valor de retorno: condição

elementIsEnabled(element: $driver.WebElement)

Cria uma condição que aguardará a habilitação de um determinado elemento.

Valor de retorno: condição

elementIsNotVisible(element: $driver.WebElement)

Cria uma condição que aguardará que determinado elemento esteja no DOM, mas não visível para o usuário.

Valor de retorno: condição

elementIsVisible(element: $driver.WebElement)

Cria uma condição que aguardará até que determinado elemento se torne visível.

Valor de retorno: condição

elementIsSelected(element: $driver.WebElement)

Cria uma condição que aguardará a seleção de determinado elemento.

Valor de retorno: condição

elementLocated(element: $driver.Locator)

Cria uma condição que fará um loop até que um elemento seja encontrado com o localizador fornecido.

Valor de retorno: condição

elementsLocated(element: $driver.Locator)

Cria uma condição que fará um loop até que pelo menos um elemento seja encontrado com o localizador fornecido.

Valor de retorno: condição

n

elementTextContains(element: $driver.WebElement, substr: string)

Cria uma condição que aguardará que o texto visível do elemento fornecido contenha a substring especificada.

Valor de retorno: condição

elementTextIs(element: $driver.WebElement, text: string)

Maiúsculas e minúsculas. Cria uma condição que aguardará que o texto visível do elemento fornecido corresponda exatamente ao texto fornecido.

Valor de retorno: condição

n

elementTextMatches(element: $driver.WebElement, regex: string)

Cria uma condição que aguardará que o texto visível do elemento fornecido corresponda a uma expressão regular.

Valor de retorno: condição

stalenessOf(element: $driver.WebElement)

Cria uma condição que aguardará que o elemento determinado fique obsoleto. Um elemento é considerado obsoleto quando é removido do DOM ou quando uma nova página é carregada.

Valor de retorno: condição

titleContains(substr: string)

Cria uma condição que aguardará que o título da página atual contenha a substring fornecida.

Valor de retorno: condição

titleIs(title: string)

Cria uma condição que aguardará que o título da página atual corresponda ao valor fornecido.

Valor de retorno: condição

titleMatches(regex: string)

Cria uma condição que aguardará que o título da página atual corresponda à expressão regular fornecida.

Valor de retorno: condição

Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.