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

$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

$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

$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 Webdriver.

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

$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

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

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

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

back()

Volte um passo no histórico do browser.

Valor de retorno: nulo

forward()

Avance um passo no histórico do browser.

Valor de retorno: nulo

refresh()

Atualize a página atual.

Valor de retorno: nulo

to(string: url)

Carregue uma nova página da web na janela atual do browser. $browser.navigate().to() é equivalente a $browser.get().

Valor de retorno: nulo

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