Référence du navigateur scripté de Synthétique (versions de moniteur 0.5.0 et 0.6.0)

$browser.actions()

Crée une nouvelle séquence d'action à l'aide de ce pilote. Pour une liste des actions disponibles, voir ActionSequence.

Valeur de retour : void

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

Ajoute l'en-tête headerKey avec la valeur headerValue à l'exécution.

Valeur de retour : void

$browser.addHeaders(headers: ?)

Ajoute une carte d’en-têtes à l’exécution.

Valeur de retour : void

$browser.deleteHeader(header: string)

Supprime un en-tête spécifique de l'exécution.

Valeur de retour : void

$browser.deleteHeaders(header: [string])

Supprime tous les en-têtes de l'argument lors de l'exécution.

Valeur de retour : void

$browser.addHostnameToBlacklist(hostname: string)

Ajoute un nom d’hôte à votre liste de refus. Permet d'utiliser des caractères génériques.

Valeur de retour : void

$browser.addHostnamesToBlacklist(hostnameArr: [string])

Ajoute tous les noms d'hôte dans un éventail d'arguments à votre liste de refus. Permet d'utiliser des caractères génériques.

Valeur de retour : void

$browser.addHostnameToWhitelist(hostname: string)

Ajoute un nom d'hôte bloqué par défaut dans monitoring Synthétique à votre liste de domaines autorisés.

Valeur de retour : void

$browser.addHostnamesToWhitelist(hostnameArr: [string])

Ajoute tous les noms d'hôte dans l'argument à votre liste de domaines autorisés.

Valeur de retour : void

$browser.deleteHostnameFromBlacklist(hostname: string)

Supprime un nom d’hôte pour cette instance de navigateur de votre liste de refus.

Valeur de retour : void

$browser.deleteHostnamesFromBlacklist(hostnameArr: [string])

Supprime tous les noms d'hôte dans l'argument de votre liste de refus.

Valeur de retour : void

$browser.deleteHostnameFromWhitelist(hostnameArr: [string])

Supprime un nom d'hôte pour cette instance de navigateur de votre liste de domaines autorisés.

Valeur de retour : void

$browser.deleteHostnamesFromWhitelist(hostnameArr: [string])

Supprime tous les noms d'hôte dans l'argument de votre liste de domaines autorisés pour cette instance de navigateur.

Valeur de retour : void

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

Planifie une commande pour exécuter du JavaScript asynchrone dans le contexte du cadre ou de la fenêtre actuellement sélectionné.

Valeur de retour : promesse

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

Planifie une commande pour exécuter JavaScript dans le contexte du cadre ou de la fenêtre actuellement sélectionné.

Valeur de retour : promesse

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

Planifiez une commande pour rechercher un élément sur la page. Si non trouvé, Synthétique monitoring renvoie une erreur.

Valeur de retour : WebElementPromise

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

Planifiez une commande pour rechercher plusieurs éléments sur la page.

Valeur de retour : promesse

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

Planifiez une commande pour attendre et rechercher un élément sur la page, et une autre commande pour attendre qu'il soit visible. Si non trouvé, Synthétique monitoring renvoie une erreur.

La valeur du délai d'expiration est facultative. Elle s'applique séparément aux deux tâches de recherche de l'élément et d'attente de sa visibilité. Cela signifie que dans le pire des cas, cette méthode peut prendre jusqu'à deux fois la valeur de délai d'expiration fournie. La valeur de délai d'expiration par défaut est de 1 000 ms (1 seconde).

Valeur de retour : WebElementPromise

$browser.get(url: string)

Charge une page Web dans un navigateur Synthétique.

Valeur de retour : promesse

$browser.getAllWindowHandles()

Planifie une commande pour récupérer la liste actuelle des poignées de fenêtre disponibles.

Valeur de retour : promesse

$browser.getCapabilities()

Une promesse qui se résoudra avec les capacités de l'instance.

Valeur de retour : promesse

$browser.getCurrentUrl()

Planifie une commande pour récupérer l'URL de la page actuelle.

Valeur de retour : promesse

$browser.getHeaders()

Renvoie une carte des en-têtes actuellement configurés.

Valeur de retour : carte

$browser.getPageSource()

Planifie une commande pour récupérer la source de la page actuelle. La source de la page renvoyée est une représentation du DOM sous-jacent. Ne vous attendez pas à ce qu'il soit formaté ou échappé de la même manière que la réponse envoyée depuis le serveur Web.

Valeur de retour : promesse

$browser.getSession()

Une promesse pour la séance de ce client.

Valeur de retour : promesse

$browser.getTitle()

Planifie une commande pour récupérer le titre de la page actuelle.

Valeur de retour : promesse

$browser.getWindowHandle()

Planifie une commande pour récupérer le handle de fenêtre actuel.

Valeur de retour : promesse

$browser.manage()

L'interface d'options pour cette instance. Vous pouvez gérer les cookies, les délais d'expiration et d'autres options de fenêtre.

Valeur de retour : void

$browser.navigate()

L'interface de navigation (historique des fonctions du navigateur) pour cette instance.

Valeur de retour : void

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

Planifie une commande à exécuter par CommandExecutor de ce pilote.

Valeur de retour : promesse

$browser.sleep()

Planifie une commande pour mettre le pilote en veille pendant la durée donnée.

Valeur de retour : promesse

$browser.switchTo()

L'interface cible localisateur pour cette instance.

Valeur de retour : void

$browser.takeScreenshot()

Planifie une commande pour effectuer une capture d'écran.

Valeur de retour : promesse

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

Planifie une commande pour attendre qu'une condition soit remplie, telle que définie par votre fonction fournie.

Valeur de retour : WebElement

$browser.waitForPendingRequests(timeout: number)

Force le script à attendre que requests qui ont été initiées soient renvoyées, jusqu'au délai d'expiration. Utile pour suivre les ressources non bloquantes.

Valeur de retour : promesse

$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)

Planifie une commande pour ajouter un cookie.

spec est un objet d'enregistrement décrivant un cookie de navigateur. Pour plus d'informations, consultez la documentation Webdriver.

Valeur de retour : promesse

$browser.manage().deleteAllCookies()

Planifie une commande pour supprimer tous les cookies visibles sur la page actuelle.

Valeur de retour : promesse

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

Planifie une commande pour supprimer le cookie avec le nom donné. Cette commande est un no-op s'il n'y a pas de cookie avec le nom donné visible sur la page actuelle.

Valeur de retour : promesse

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

Planifie une commande pour récupérer le cookie avec le nom donné. Renvoie null s'il n'existe pas de tel cookie. Le cookie sera renvoyé sous forme d'objet JSON comme décrit par le protocole Webdriver.

Valeur de retour : promesse

$browser.manage().getCookies()

Planifie une commande pour récupérer tous les cookies visibles sur la page actuelle. New Relic Syntheticcs renvoie chaque cookie sous forme d'objet JSON comme décrit par le protocole Webdriver.

Valeur de retour : promesse

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

Spécifie la durée pendant laquelle le pilote doit attendre lors de la recherche d'un élément s'il n'est pas immédiatement présent. La définition du délai d’attente sur 0 désactive l’attente implicite.

Soyez prudent lorsque vous augmentez le délai d'attente, car cela augmentera les temps d'exécution des tests, en particulier avec des stratégies de localisation plus lentes comme XPath. La valeur par défaut est de 10 secondes.

Valeur de retour : promesse

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

Définit la durée d'attente pour que le chargement d'une page soit terminé avant de renvoyer une erreur. Si le délai d'attente est négatif, le chargement des pages peut durer jusqu'à 180 secondes. La valeur par défaut est de 60 secondes.

Valeur de retour : promesse

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

Définit la durée d'attente, en millisecondes, pour qu'un script asynchrone termine son exécution avant de renvoyer une erreur. La valeur par défaut est de 30 secondes.

Valeur de retour : promesse

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

Récupère la position actuelle de la fenêtre, par rapport au coin supérieur gauche de l'écran.

Valeur de retour : promesse

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

Récupère la taille actuelle de la fenêtre.

Valeur de retour : promesse

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

Maximise la fenêtre actuelle.

Valeur de retour : promesse

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

Repositionne la fenêtre actuelle.

Valeur de retour : promesse

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

Redimensionne la fenêtre actuelle.

Valeur de retour : promesse

$driver.By.className(className: string)

Localise un élément qui a un nom de classe spécifique. Le localisateur renvoyé équivaut à la recherche d'éléments avec le sélecteur CSS .class.

Valeur de retour : localisateur

$driver.By.css(cssName: string)

Localise un élément à l'aide d'un sélecteur CSS.

Valeur de retour : localisateur

$driver.By.id(id: string)

Localise un élément par son ID.

Valeur de retour : localisateur

$driver.By.linkText(linkText: string)

Localise les éléments de lien dont le texte visible correspond à la chaîne donnée.

Valeur de retour : localisateur

$driver.By.js(js: string)

Localise un élément en évaluant une expression JavaScript.

Valeur de retour : localisateur

$driver.By.name(name: string)

Localise les éléments dont l'attribut name a la valeur donnée.

Valeur de retour : localisateur

$driver.By.partialLinkText(partialLinkText: string)

Localise les éléments de lien dont getText visible contient la sous-chaîne donnée.

Valeur de retour : localisateur

$driver.By.tagName(tagName: string)

Localise les éléments avec un nom tag donné. Le localisateur renvoyé équivaut à utiliser la fonction DOM getElementsByTagName .

Valeur de retour : localisateur

$driver.By.xpath(xpath: string)

Localise les éléments correspondant à un sélecteur XPath.

Valeur de retour : localisateur

click()

Clique sur cet élément.

Valeur de retour : auto-référence

sendKeys(var_args: ?)

Planifie une commande pour taper une séquence sur l'élément DOM représenté par cette instance.

Valeur de retour : WebElement

getTagName()

Planifie une commande pour interroger le nom tag/ nœud de cet élément.

Valeur de retour : WebElement

getCssValue(name: string)

Planifie une commande pour interroger le style calculer de l'élément représenté par cette instance. Si l'élément hérite du style nommé de son parent, le parent sera interrogé pour sa valeur. Dans la mesure du possible, les valeurs de couleur seront converties en leur représentation hexadécimale (par exemple, #00ff00 au lieu de rgb(0, 255, 0)).

Valeur de retour : promesse

getAttribute(name: string)

Planifie une commande pour interroger la valeur de l'attribut donné de l'élément.

Valeur de retour : promesse

getText(name: string)

Récupère le innerText visible (non masqué par CSS) de cet élément, y compris les sous-éléments, sans aucun espace blanc de début ou de fin.

Valeur de retour : promesse

getSize()

Planifie une commande pour calculer la taille de la boîte englobante de cet élément, en pixels.

Valeur de retour : promesse

getLocation()

Planifie une commande pour calculer l'emplacement de cet élément, dans l'espace de la page.

Valeur de retour : promesse

isEnabled()

Planifie une commande pour demander si l'élément DOM représenté par cette instance est activé, comme indiqué par l'attribut désactivé.

Valeur de retour : promesse

isSelected()

Planifie une commande pour demander si cet élément est sélectionné.

Valeur de retour : promesse

submit()

Planifie une commande pour soumettre le formulaire contenant cet élément (ou cet élément s'il s'agit d'un élément FORM ). Cette commande est nulle si l'élément n'est pas contenu dans un formulaire.

Valeur de retour : promesse

clear()

Planifie une commande pour effacer la valeur de cet élément.

Valeur de retour : promesse

isDisplayed()

Planifie une commande pour tester si cet élément est actuellement affiché.

Valeur de retour : promesse

click(opt_elementOrButton: ?, opt_button: ?)

Clique sur un bouton de la souris. Si un élément est fourni, la souris sera d'abord déplacée au centre de cet élément. Ceci est équivalent à WebElement.click().

Valeur de retour : actionsequence

doubleClick(opt_elementOrButton: ?, opt_button: ?)

Double-clique sur un bouton de la souris. Si un élément est fourni, la souris sera d'abord déplacée au centre de cet élément.

Valeur de retour : actionsequence

dragAndDrop(element: ?, location: ?)

Fonction pratique pour effectuer une manœuvre de glisser-déposer. L'élément cible peut être déplacé vers l'emplacement d'un autre élément, ou par un décalage (en pixels). L'emplacement est un objet avec deux propriétés x et y: {x: x_offset, y: y_offset}.

Valeur de retour : actionsequence

keyDown(key: ?)

Effectue une pression sur une touche de modification. Doit être l’un des suivants : ALT, CONTROL, SHIFT, COMMAND ou META. La touche de modification n'est pas désactivée tant que keyUp() ou sendKeys() n'est pas appelé. La touche enfoncée sera ciblée sur l'élément actuellement focalisé.

Valeur de retour : actionsequence

keyUp(key: ?)

Effectue une sortie de touche de modification. La sortie vise l'élément actuellement focalisé.

Valeur de retour : actionsequence

mouseDown(opt_elementOrButton: ?, opt_button: ?)

Appuie sur un bouton de la souris. Le bouton de la souris ne sera pas désactivé tant que mouseUp ne sera pas appelé, que cet appel soit effectué dans cette séquence ou dans une autre. Le comportement d'un événement hors service (comme l'appel mouseDown() ou click() lorsque le bouton est déjà maintenu enfoncé) n'est pas défini.

Valeur de retour : actionsequence

mouseUp(opt_elementOrButton: ?, opt_button: ?)

sortir un bouton de la souris. Le comportement n'est pas défini pour l'appel de cette fonction sans un appel préalable à mouseDown().

Valeur de retour : actionsequence

mouseMove(location: ?, offset: ?)

Déplace la souris. L'emplacement vers lequel se déplacer peut être spécifié en termes de position actuelle de la souris, d'un décalage par rapport au coin supérieur gauche d'un élément ou d'un élément (auquel cas le milieu de l'élément est utilisé).

Valeur de retour : actionsequence

perform()

Exécute cette séquence d'actions.

Valeur de retour : promesse

sendKeys(args: ?)

Simule la saisie de plusieurs touches. Chaque touche de modification rencontrée dans la séquence ne sera pas désactivée jusqu'à ce qu'elle soit rencontrée à nouveau. Tous les événements clés seront ciblés sur l'élément actuellement focalisé. Pour obtenir la liste complète des clés non alphanumériques prises en charge, consultez la documentation de la clé d'énumération Webdriver sur GitHub.

Valeur de retour : actionsequence

isPending()

La valeur de cette promesse est-elle encore en cours de calcul ?

Valeur de retour : booléen

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

Enregistre les auditeurs lorsque cette instance est résolue. Il s'agit de la fonction de base utilisée pour lier des actions synchrones dans votre script.

Valeur de retour : promesse

finally(callback: fn())

Enregistre un écouteur à invoquer lorsque cette promesse est résolue, que la valeur de la promesse ait été calculée avec succès ou non.

Valeur de retour : promesse

catch(callback: fn())

Enregistre un auditeur pour le cas où cette promesse est rejetée.

Valeur de retour : promesse

back()

Revenir en arrière d'une étape dans l'historique du navigateur.

Valeur de retour : void

forward()

Avancer d'une étape dans l'historique du navigateur.

Valeur de retour : void

refresh()

Rafraîchir la page actuelle.

Valeur de retour : void

to(string: url)

Charger une nouvelle page Web dans la fenêtre actuelle du navigateur. $browser.navigate().to() est équivalent à $browser.get().

Valeur de retour : void

ableToSwitchToFrame(frame: ?)

Crée une condition qui attendra que le pilote d'entrée puisse basculer vers le cadre désigné. Le cadre cible peut être spécifié comme :

• Un index numérique dans window.frames pour la trame actuelle

• Un webdriver.WebElement, qui doit référencer un élément FRAME ou IFRAME sur la page actuelle

• Un localisateur qui peut être utilisé pour localiser d'abord un FRAME ou IFRAME sur la page actuelle avant de tenter d'y accéder

  Une fois cette condition résolue avec succès, le conducteur pourra se concentrer sur le nouveau cadre.

  Valeur de retour : condition

alertIsPresent()

Crée une condition qui attend qu'une alerte soit ouverte. En cas de succès, la promesse renvoyée sera remplie avec le handle de l'alerte ouverte.

Valeur de retour : condition

elementIsDisabled(element: $driver.WebElement)

Crée une condition qui attendra que l'élément donné soit désactivé.

Valeur de retour : condition

elementIsEnabled(element: $driver.WebElement)

Crée une condition qui attendra que l'élément donné soit activé.

Valeur de retour : condition

elementIsNotVisible(element: $driver.WebElement)

Crée une condition qui attendra que l'élément donné soit dans le DOM, mais non visible pour l'utilisateur.

Valeur de retour : condition

elementIsVisible(element: $driver.WebElement)

Crée une condition qui attendra que l'élément donné devienne visible.

Valeur de retour : condition

elementIsSelected(element: $driver.WebElement)

Crée une condition qui attendra que l'élément donné soit sélectionné.

Valeur de retour : condition

elementLocated(element: $driver.Locator)

Crée une condition qui bouclera jusqu'à ce qu'un élément soit trouvé avec le localisateur donné.

Valeur de retour : condition

elementsLocated(element: $driver.Locator)

Crée une condition qui bouclera jusqu'à ce qu'au moins un élément soit trouvé avec le localisateur donné.

Valeur de retour : condition

n

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

Crée une condition qui attendra que le texte visible de l'élément donné contienne la sous-chaîne donnée.

Valeur de retour : condition

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

Sensible aux majuscules et minuscules. Crée une condition qui attendra que le texte visible de l'élément donné corresponde exactement au texte donné.

Valeur de retour : condition

n

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

Crée une condition qui attendra que le texte visible de l'élément donné corresponde à une expression régulière.

Valeur de retour : condition

stalenessOf(element: $driver.WebElement)

Crée une condition qui attendra que l'élément donné devienne obsolète. Un élément est considéré comme obsolète une fois qu'il est supprimé du DOM ou qu'une nouvelle page a été chargée.

Valeur de retour : condition

titleContains(substr: string)

Crée une condition qui attendra que le titre de la page actuelle contienne la sous-chaîne donnée.

Valeur de retour : condition

titleIs(title: string)

Crée une condition qui attendra que le titre de la page actuelle corresponde à la valeur donnée.

Valeur de retour : condition

titleMatches(regex: string)

Crée une condition qui attendra que le titre de la page actuelle corresponde aux expressions régulières données.

Valeur de retour : condition