Sur cette page

Commandes

Les commandes de l’éditeur d’étapes, regroupées par usage, avec le contenu de leurs champs Target et Value.

Dans l’éditeur d’étapes, survolez le champ Command pour afficher la description de la commande sélectionnée (en anglais dans l’application). Les types d’arguments sont décrits dans Arguments.

Note :

La liste des commandes propose aussi des commandes d’applications de bureau — open application, close application, click and type, click nearby region et git bash transaction — destinées aux tests GUI de Mugnsoft. Pulse les ignore en lecture locale et marque l’exécution comme ignorée (skipped). Elles ne sont pas encore documentées ici : contactez le support Mugnsoft avant de les utiliser.
Groupe Commandes
Transactions 2
Structures de contrôle 10
Assertions 17
Vérifications 14
Attentes 8
Variables 8
Pop-ups et boîtes de dialogue 5
Scripts et débogage 7
Navigateur et fenêtres 5
Interactions 20

Transactions

start transaction

Démarre une transaction : les étapes jusqu’au stop transaction correspondant sont chronométrées ensemble lorsque le parcours s’exécute comme moniteur EUM dans Mugnsoft.

  • target — transaction name : Le nom de la transaction (par exemple ajoutPanier).
  • value — transaction value : La valeur de la transaction : le seuil majeur, le seuil critique et la description de la transaction (par exemple 1.2, 1.5, ‘ajout au panier’).

stop transaction

Arrête la transaction du même nom ouverte par start transaction.

  • target — transaction name : Le nom de la transaction (par exemple ajoutPanier).

Structures de contrôle

do

Crée une boucle qui exécute les commandes suivantes au moins une fois. Terminez la branche avec la commande repeat if.

else

Fait partie d’un bloc if. Exécute les commandes de cette branche lorsque les conditions if et else if ne sont pas remplies. Terminez la branche avec la commande end.

else if

Fait partie d’un bloc if. Exécute les commandes de cette branche lorsqu’une condition if n’est pas remplie. Terminez la branche avec la commande end.

  • target — conditional expression : Une expression JavaScript renvoyant un booléen, utilisée par les commandes de contrôle.

end

Termine un bloc de contrôle if, while ou times.

for each

Crée une boucle qui exécute les commandes suivantes pour chaque élément d’une collection donnée.

  • target — array variable name : Le nom d’une variable contenant un tableau JavaScript.
  • value — iterator variable name : Le nom de la variable utilisée pour parcourir une collection dans une boucle (par exemple for each).

if

Crée une branche conditionnelle dans le test. Terminez la branche avec la commande end.

  • target — conditional expression : Une expression JavaScript renvoyant un booléen, utilisée par les commandes de contrôle.

repeat if

Termine conditionnellement une branche de contrôle do. Si l’expression conditionnelle est vraie, la boucle do recommence ; sinon elle se termine.

  • target — conditional expression : Une expression JavaScript renvoyant un booléen, utilisée par les commandes de contrôle.
  • value — loop limit : Le nombre maximal d’exécutions d’une boucle, pour se protéger des boucles infinies.

run

Exécute un test du projet courant.

  • target — test case : Le nom d’un test du projet.

times

Crée une boucle qui exécute les commandes suivantes n fois.

  • target — times : Le nombre de fois qu’une boucle times exécute les commandes de son bloc.
  • value — loop limit : Le nombre maximal d’exécutions d’une boucle, pour se protéger des boucles infinies.

while

Crée une boucle qui exécute les commandes suivantes tant que l’expression conditionnelle indiquée est vraie.

  • target — conditional expression : Une expression JavaScript renvoyant un booléen, utilisée par les commandes de contrôle.
  • value — loop limit : Le nombre maximal d’exécutions d’une boucle, pour se protéger des boucles infinies.

Assertions

assert

Vérifie qu’une variable a la valeur attendue. La valeur de la variable est convertie en chaîne pour la comparaison. Le test s’arrête si l’assertion échoue.

  • target — variable name : Le nom d’une variable (sans accolades). Sert à y mémoriser le résultat d’une expression ou à y faire référence pour une vérification (par exemple avec « assert » ou « verify »).
  • value — expected value : Le résultat attendu dans la variable (par exemple true, false ou une autre valeur).

assert alert

Vérifie qu’une alerte a été affichée avec le texte indiqué. Le test s’arrête si l’assertion échoue.

  • target — alert text : Le texte à vérifier.

assert checked

Vérifie que l’élément cible est coché. Le test s’arrête si l’assertion échoue.

  • target — locator : Un localisateur d’élément.

assert confirmation

Vérifie qu’une boîte de confirmation a été affichée. Le test s’arrête si l’assertion échoue.

  • target — alert text : Le texte à vérifier.

assert editable

Vérifie que l’élément cible est modifiable. Le test s’arrête si l’assertion échoue.

  • target — locator : Un localisateur d’élément.

assert element not present

Vérifie que l’élément cible n’est présent nulle part sur la page. Le test s’arrête si l’assertion échoue.

  • target — locator : Un localisateur d’élément.

assert element present

Vérifie que l’élément cible est présent quelque part sur la page. Le test s’arrête si l’assertion échoue.

  • target — locator : Un localisateur d’élément.

assert not checked

Vérifie que l’élément cible n’est pas coché. Le test s’arrête si l’assertion échoue.

  • target — locator : Un localisateur d’élément.

assert not editable

Vérifie que l’élément cible n’est pas modifiable. Le test s’arrête si l’assertion échoue.

  • target — locator : Un localisateur d’élément.

assert not selected value

Vérifie que l’attribut value de l’option sélectionnée d’une liste déroulante ne contient pas la valeur indiquée. Le test s’arrête si l’assertion échoue.

  • target — select locator : Un localisateur d’élément désignant une liste déroulante.
  • value — text : Une correspondance exacte de chaîne.

assert not text

Vérifie que le texte d’un élément ne contient pas la valeur indiquée. Le test s’arrête si l’assertion échoue.

  • target — locator : Un localisateur d’élément.
  • value — text : Une correspondance exacte de chaîne.

assert prompt

Vérifie qu’une invite de saisie JavaScript a été affichée. Le test s’arrête si l’assertion échoue.

  • target — alert text : Le texte à vérifier.

assert selected label

Vérifie que le libellé de l’option sélectionnée d’une liste déroulante contient la valeur indiquée. Le test s’arrête si l’assertion échoue.

  • target — select locator : Un localisateur d’élément désignant une liste déroulante.
  • value — text : Une correspondance exacte de chaîne.

assert selected value

Vérifie que l’attribut value de l’option sélectionnée d’une liste déroulante contient la valeur indiquée. Le test s’arrête si l’assertion échoue.

  • target — select locator : Un localisateur d’élément désignant une liste déroulante.
  • value — text : Une correspondance exacte de chaîne.

assert text

Vérifie que le texte d’un élément contient la valeur indiquée. Le test s’arrête si l’assertion échoue.

  • target — locator : Un localisateur d’élément.
  • value — text : Une correspondance exacte de chaîne.

assert title

Vérifie que le titre de la page courante contient le texte indiqué. Le test s’arrête si l’assertion échoue.

  • target — text : Une correspondance exacte de chaîne.

assert value

Vérifie la valeur (sans espaces de début et de fin) d’un champ de saisie, ou de tout élément ayant une valeur. Pour une case à cocher ou un bouton radio, la valeur est « on » ou « off » selon qu’il est coché ou non. Le test s’arrête si l’assertion échoue.

  • target — locator : Un localisateur d’élément.
  • value — text : Une correspondance exacte de chaîne.

Vérifications

verify

Vérification souple qu’une variable a la valeur attendue. La valeur de la variable est convertie en chaîne pour la comparaison. Le test continue même si la vérification échoue.

  • target — variable name : Le nom d’une variable (sans accolades). Sert à y mémoriser le résultat d’une expression ou à y faire référence pour une vérification (par exemple avec « assert » ou « verify »).
  • value — expected value : Le résultat attendu dans la variable (par exemple true, false ou une autre valeur).

verify checked

Vérification souple qu’un bouton à bascule (case à cocher ou bouton radio) est coché. Le test continue même si la vérification échoue.

  • target — locator : Un localisateur d’élément.

verify editable

Vérification souple que l’élément de saisie indiqué est modifiable (par exemple, qu’il n’est pas désactivé). Le test continue même si la vérification échoue.

  • target — locator : Un localisateur d’élément.

verify element not present

Vérification souple que l’élément indiqué n’est présent nulle part sur la page. Le test continue même si la vérification échoue.

  • target — locator : Un localisateur d’élément.

verify element present

Vérification souple que l’élément indiqué est présent quelque part sur la page. Le test continue même si la vérification échoue.

  • target — locator : Un localisateur d’élément.

verify not checked

Vérification souple qu’un bouton à bascule (case à cocher ou bouton radio) n’est pas coché. Le test continue même si la vérification échoue.

  • target — locator : Un localisateur d’élément.

verify not editable

Vérification souple que l’élément de saisie indiqué n’est pas modifiable (par exemple, qu’il est désactivé). Le test continue même si la vérification échoue.

  • target — locator : Un localisateur d’élément.

verify not selected value

Vérification souple que l’option attendue n’est pas choisie dans une liste, d’après son attribut value. Le test continue même si la vérification échoue.

  • target — select locator : Un localisateur d’élément désignant une liste déroulante.
  • value — option : Un localisateur d’option, généralement le simple libellé de l’option (par exemple « John Smith »).

verify not text

Vérification souple que le texte indiqué n’est pas présent dans un élément. Le test continue même si la vérification échoue.

  • target — locator : Un localisateur d’élément.
  • value — text : Le texte à vérifier.

verify selected label

Vérification souple du texte affiché de l’option sélectionnée dans la liste indiquée. Le test continue même si la vérification échoue.

  • target — select locator : Un localisateur d’élément désignant une liste déroulante.
  • value — text : Une correspondance exacte de chaîne.

verify selected value

Vérification souple que l’option attendue est choisie dans une liste, d’après son attribut value. Le test continue même si la vérification échoue.

  • target — select locator : Un localisateur d’élément désignant une liste déroulante.
  • value — option : Un localisateur d’option, généralement le simple libellé de l’option (par exemple « John Smith »).

verify text

Vérification souple que le texte d’un élément est présent. Le test continue même si la vérification échoue.

  • target — locator : Un localisateur d’élément.
  • value — text : Le texte à vérifier.

verify title

Vérification souple que le titre de la page courante contient le texte indiqué. Le test continue même si la vérification échoue.

  • target — text : Le texte à vérifier.

verify value

Vérification souple de la valeur (sans espaces de début et de fin) d’un champ de saisie, ou de tout élément ayant une valeur. Pour une case à cocher ou un bouton radio, la valeur est « on » ou « off » selon qu’il est coché ou non. Le test continue même si la vérification échoue.

  • target — locator : Un localisateur d’élément.
  • value — text : Une correspondance exacte de chaîne.

Attentes

pause

Attend pendant la durée indiquée.

  • target — wait time : La durée d’attente, en millisecondes.

wait for element editable

Attend qu’un élément soit modifiable.

  • target — locator : Un localisateur d’élément.
  • value — wait time : La durée d’attente, en millisecondes.

wait for element not editable

Attend qu’un élément ne soit plus modifiable.

  • target — locator : Un localisateur d’élément.
  • value — wait time : La durée d’attente, en millisecondes.

wait for element not present

Attend qu’un élément cible ne soit plus présent sur la page.

  • target — locator : Un localisateur d’élément.
  • value — wait time : La durée d’attente, en millisecondes.

wait for element not visible

Attend qu’un élément cible ne soit plus visible sur la page.

  • target — locator : Un localisateur d’élément.
  • value — wait time : La durée d’attente, en millisecondes.

wait for element present

Attend qu’un élément cible soit présent sur la page.

  • target — locator : Un localisateur d’élément.
  • value — wait time : La durée d’attente, en millisecondes.

wait for element visible

Attend qu’un élément cible soit visible sur la page.

  • target — locator : Un localisateur d’élément.
  • value — wait time : La durée d’attente, en millisecondes.

wait for text

Attend que le texte d’un élément soit présent.

  • target — locator : Un localisateur d’élément.
  • value — text : Le texte à vérifier.

Variables

store

Enregistre une chaîne dans une variable pour la réutiliser facilement.

  • target — text : Le texte à vérifier.
  • value — variable name : Le nom d’une variable (sans accolades). Sert à y mémoriser le résultat d’une expression ou à y faire référence pour une vérification (par exemple avec « assert » ou « verify »).

store attribute

Récupère la valeur d’un attribut d’élément. Cette valeur peut varier selon les navigateurs (c’est le cas de l’attribut « style », par exemple).

  • target — attribute locator : Un localisateur d’élément suivi d’un @ et du nom de l’attribut, par exemple « foo@bar ».
  • value — variable name : Le nom d’une variable (sans accolades). Sert à y mémoriser le résultat d’une expression ou à y faire référence pour une vérification (par exemple avec « assert » ou « verify »).

store element count

Récupère le nombre de nœuds correspondant au localisateur indiqué (par exemple « xpath=//table » donne le nombre de tableaux).

  • target — locator : Un localisateur d’élément.
  • value — variable name : Le nom d’une variable (sans accolades). Sert à y mémoriser le résultat d’une expression ou à y faire référence pour une vérification (par exemple avec « assert » ou « verify »).

store json

Enregistre du JSON sous forme d’objet dans une variable.

  • target — json : La représentation textuelle d’un objet JavaScript.
  • value — variable name : Le nom d’une variable (sans accolades). Sert à y mémoriser le résultat d’une expression ou à y faire référence pour une vérification (par exemple avec « assert » ou « verify »).

store text

Récupère le texte d’un élément et le mémorise pour plus tard. Fonctionne pour tout élément contenant du texte.

  • target — locator : Un localisateur d’élément.
  • value — variable name : Le nom d’une variable (sans accolades). Sert à y mémoriser le résultat d’une expression ou à y faire référence pour une vérification (par exemple avec « assert » ou « verify »).

store title

Récupère le titre de la page courante.

  • target — variable name : Le nom d’une variable (sans accolades). Sert à y mémoriser le résultat d’une expression ou à y faire référence pour une vérification (par exemple avec « assert » ou « verify »).

store value

Récupère la valeur d’un élément et la mémorise pour plus tard. Fonctionne pour tout élément de saisie.

  • target — locator : Un localisateur d’élément.
  • value — variable name : Le nom d’une variable (sans accolades). Sert à y mémoriser le résultat d’une expression ou à y faire référence pour une vérification (par exemple avec « assert » ou « verify »).

store window handle

Récupère l’identifiant (handle) de la page courante.

  • target — window handle : Un identifiant (handle) désignant une page précise (onglet ou fenêtre).

Pop-ups et boîtes de dialogue

accept alert

Agit sur une alerte actuellement affichée : Pulse l’accepte.

accept confirmation

Agit sur une boîte de confirmation actuellement affichée : Pulse l’accepte.

answer prompt

Agit sur une invite de saisie actuellement affichée : Pulse y donne la réponse indiquée.

  • target — answer : La réponse à donner à l’invite de saisie.

dismiss confirmation

Agit sur une boîte de confirmation actuellement affichée : Pulse la refuse.

dismiss prompt

Agit sur une invite de saisie actuellement affichée : Pulse la ferme sans répondre.

Scripts et débogage

debugger

Interrompt l’exécution et passe en mode débogage.

echo

Affiche le message indiqué. Utile pour le débogage.

  • target — message : Le message à afficher.

execute async script

Exécute un fragment de JavaScript asynchrone dans le contexte du cadre ou de la fenêtre sélectionnés. Le fragment est exécuté comme le corps d’une fonction anonyme et doit renvoyer une Promise. Le résultat de la Promise est enregistré dans la variable si vous utilisez le mot-clé « return ».

  • target — script : Le fragment de JavaScript à exécuter.
  • value — variable name (facultatif) : Le nom d’une variable (sans accolades). Sert à y mémoriser le résultat d’une expression ou à y faire référence pour une vérification (par exemple avec « assert » ou « verify »).

execute script

Exécute un fragment de JavaScript dans le contexte du cadre ou de la fenêtre sélectionnés. Le fragment est exécuté comme le corps d’une fonction anonyme. Pour mémoriser la valeur renvoyée, utilisez le mot-clé « return » et indiquez un nom de variable dans le champ Value.

  • target — script : Le fragment de JavaScript à exécuter.
  • value — variable name (facultatif) : Le nom d’une variable (sans accolades). Sert à y mémoriser le résultat d’une expression ou à y faire référence pour une vérification (par exemple avec « assert » ou « verify »).

free text

Ajoute du texte ou du code libre, repris tel quel dans le script Mugnsoft généré. Un test dont la première commande est free text est déployé comme test GUI.

  • value — free text value : Les fonctions du texte libre, exécutées dans l’ordre.

run script

Crée une balise « script » dans le corps de la fenêtre du test et y place le texte indiqué. Les exceptions JavaScript levées dans ces balises ne sont pas gérées par Pulse : enveloppez le script dans un bloc try/catch s’il risque d’en lever une.

  • target — script : Le fragment de JavaScript à exécuter.

set speed

Règle la vitesse d’exécution, c’est-à-dire le délai en millisecondes qui suit chaque commande. Par défaut, ce délai est de 0 milliseconde. Le réglage est global et s’applique à toutes les exécutions jusqu’à ce qu’il soit modifié.

  • target — wait time : La durée d’attente, en millisecondes.

close

Ferme la fenêtre courante. Inutile de fermer la fenêtre initiale : Pulse la réutilise, et la fermer peut ralentir le test.

open

Ouvre une URL et attend le chargement de la page avant de continuer. Accepte les URL relatives et absolues.

  • target — url : L’URL à ouvrir (relative ou absolue).

select frame

Sélectionne un cadre dans la fenêtre courante. Répétez la commande pour sélectionner un cadre imbriqué. Pour sélectionner le cadre parent, utilisez « relative=parent » comme localisateur ; pour le cadre supérieur, « relative=top ». Vous pouvez aussi sélectionner un cadre par son index à partir de 0 (le premier cadre avec « index=0 », le troisième avec « index=2 »).

  • target — locator : Un localisateur d’élément.

select window

Sélectionne une fenêtre pop-up à l’aide d’un localisateur de fenêtre. Une fois la fenêtre sélectionnée, toutes les commandes s’y appliquent. Les localisateurs de fenêtre utilisent des identifiants de fenêtre (handles).

  • target — window handle : Un identifiant (handle) désignant une page précise (onglet ou fenêtre).

set window size

Règle la taille de la fenêtre du navigateur, interface du navigateur comprise.

  • target — resolution : Une résolution de fenêtre au format LargeurxHauteur (par exemple 1280x800).

Interactions

add selection

Ajoute une option à la sélection d’un élément à sélection multiple.

  • target — locator : Un localisateur d’élément.

check

Coche un bouton à bascule (case à cocher ou bouton radio).

  • target — locator : Un localisateur d’élément.

click

Clique sur un élément cible (par exemple un lien, un bouton, une case à cocher ou un bouton radio).

  • target — locator : Un localisateur d’élément.

click at

Clique sur un élément cible (par exemple un lien, un bouton, une case à cocher ou un bouton radio). Les coordonnées sont relatives à l’élément cible (0,0 est son coin supérieur gauche) et servent surtout à vérifier des effets qui en dépendent, comme l’effet d’onde de Material.

  • target — locator : Un localisateur d’élément.
  • value — coord string : La position x,y (par exemple 10,20) de l’événement souris, relative à l’élément trouvé par le localisateur.

double click

Double-clique sur un élément (par exemple un lien, un bouton, une case à cocher ou un bouton radio).

  • target — locator : Un localisateur d’élément.

double click at

Double-clique sur un élément cible (par exemple un lien, un bouton, une case à cocher ou un bouton radio). Les coordonnées sont relatives à l’élément cible (0,0 est son coin supérieur gauche) et servent surtout à vérifier des effets qui en dépendent, comme l’effet d’onde de Material.

  • target — locator : Un localisateur d’élément.
  • value — coord string : La position x,y (par exemple 10,20) de l’événement souris, relative à l’élément trouvé par le localisateur.

drag and drop to object

Fait glisser un élément et le dépose sur un autre élément.

  • target — locator of object to be dragged : Le localisateur de l’élément à faire glisser.
  • value — locator of drag destination object : Le localisateur de l’élément dont l’emplacement (par exemple son pixel central) sera le point où l’élément glissé est déposé.

edit content

Définit la valeur d’un élément modifiable (contenteditable) comme si vous l’aviez saisie.

  • target — locator : Un localisateur d’élément.
  • value — value : La valeur à saisir.

mouse down

Simule l’appui sur le bouton gauche de la souris (sans le relâcher).

  • target — locator : Un localisateur d’élément.

mouse down at

Simule l’appui sur le bouton gauche de la souris (sans le relâcher) à l’emplacement indiqué.

  • target — locator : Un localisateur d’élément.
  • value — coord string : La position x,y (par exemple 10,20) de l’événement souris, relative à l’élément trouvé par le localisateur.

mouse move at

Simule l’appui sur le bouton de la souris (sans le relâcher) sur l’élément indiqué.

  • target — locator : Un localisateur d’élément.
  • value — coord string : La position x,y (par exemple 10,20) de l’événement souris, relative à l’élément trouvé par le localisateur.

mouse out

Simule le pointeur de la souris qui quitte l’élément indiqué.

  • target — locator : Un localisateur d’élément.

mouse over

Simule le survol de l’élément indiqué par la souris.

  • target — locator : Un localisateur d’élément.

mouse up

Simule le relâchement du bouton de la souris.

  • target — locator : Un localisateur d’élément.

mouse up at

Simule le relâchement du bouton de la souris à l’emplacement indiqué.

  • target — locator : Un localisateur d’élément.
  • value — coord string : La position x,y (par exemple 10,20) de l’événement souris, relative à l’élément trouvé par le localisateur.

remove selection

Retire une option de la sélection d’un élément à sélection multiple, à l’aide d’un localisateur d’option.

  • target — locator : Un localisateur d’élément.
  • value — option : Un localisateur d’option, généralement le simple libellé de l’option (par exemple « John Smith »).

select

Sélectionne une option d’une liste déroulante à l’aide d’un localisateur d’option. Les localisateurs d’option permettent de désigner l’option de plusieurs façons (label=, value=, id=, index=). Sans préfixe, Pulse recherche l’option par son libellé.

  • target — select locator : Un localisateur d’élément désignant une liste déroulante.
  • value — option : Un localisateur d’option, généralement le simple libellé de l’option (par exemple « John Smith »).

send keys

Simule la frappe sur l’élément indiqué, comme si la valeur était tapée touche par touche. La saisie est soumise aux limites d’un vrai utilisateur : impossible de taper dans un élément invisible ou en lecture seule. Utile pour les composants dynamiques (comme les listes à complétion automatique) qui attendent de vrais événements clavier. Contrairement à la commande « type », qui force la valeur dans la page, cette commande ne remplace pas le contenu existant.

  • target — locator : Un localisateur d’élément.
  • value — key sequence : Une séquence de touches à taper, par exemple pour envoyer des frappes spéciales (${KEY_ENTER}).

type

Définit la valeur d’un champ de saisie, comme si vous l’aviez tapée. Peut aussi définir la valeur des listes, cases à cocher, etc. : la valeur est alors celle de l’option choisie, pas le texte affiché. Chrome uniquement : si un chemin de fichier est indiqué, le fichier est téléversé dans le champ (type=file) ; les localisateurs XPath ne sont pas pris en charge.

  • target — locator : Un localisateur d’élément.
  • value — value : La valeur à saisir.

uncheck

Décoche un bouton à bascule (case à cocher ou bouton radio).

  • target — locator : Un localisateur d’élément.

Voir aussi

Traductions

Arguments