Section courante

A propos

Section administrative du site

Voici la liste des différentes commandes reconnus par l'API de Selenium :

Modules Description
add selection Cette commande permet d'ajouter une sélection à l'ensemble d'options dans un élément à sélection multiple.
answer on next prompt Cette commande permet d'affecter le prochain prompt d'alerte. Elle lui enverra la chaîne de réponse spécifiée. Si l'alerte est déjà présente, utilisez plutôt la commande webdriver answer on visible prompt.
assert Cette commande permet de vérifier qu'une variable est une valeur attendue. La valeur de la variable sera convertie en chaîne pour comparaison. Le test s'arrêtera si l'assertion échoue.
assert alert Cette commande permet de confirmer qu'une alerte a été rendue avec le texte fourni. Le test s'arrêtera si l'assertion échoue.
assert checked Cette commande permet de confirmer que l'élément cible a été vérifié. Le test s'arrêtera si l'assertion échoue.
assert confirmation Cette commande permet de confirmer qu'une confirmation a été rendue. Le test s'arrêtera si l'assertion échoue.
assert editable Cette commande permet de confirmer que l'élément cible est modifiable. Le test s'arrêtera si l'assertion échoue.
assert element present Cette commande permet de confirmer que l'élément cible est présent quelque part sur la page. Le test s'arrêtera si l'assertion échoue.
assert element not present Cette commande permet de confirmer que l'élément cible n'est présent nulle part sur la page. Le test s'arrêtera si l'assertion échoue.
assert not checked Cette commande permet de confirmer que l'élément cible n'a pas été vérifié. Le test s'arrêtera si l'assertion échoue.
assert not editable Cette commande permet de confirmer que l'élément cible n'est pas modifiable. Le test s'arrêtera si l'assertion échoue.
assert not selected value Cette commande permet de confirmer que l'attribut value de l'option sélectionnée dans un élément de liste déroulante ne contient pas la valeur fournie. Le test s'arrêtera si l'assertion échoue.
assert not text Cette commande permet de confirmer que le texte d'un élément ne contient pas la valeur fournie. Le test s'arrêtera si l'assertion échoue.
assert prompt Cette commande permet de confirmer qu'un prompt JavaScript a été rendue. Le test s'arrêtera si l'assertion échoue.
assert selected value Cette commande permet de confirmer que l'attribut de valeur de l'option sélectionnée dans un élément de liste déroulante contient la valeur fournie. Le test s'arrêtera si l'assertion échoue.
assert selected label Cette commande permet de confirmer que l'étiquette de l'option sélectionnée dans un élément de liste déroulante contient la valeur fournie. Le test s'arrêtera si l'assertion échoue.
assert text Cette commande permet de confirmer que le texte d'un élément contient la valeur fournie. Le test s'arrêtera si l'assertion échoue.
assert title Cette commande permet de confirmer que le titre de la page actuelle contient le texte fourni. Le test s'arrêtera si l'assertion échoue.
assert value Cette commande permet de confirmer la valeur (coupée par des espaces) d'un champ d'entrée (ou toute autre chose avec un paramètre de valeur). Pour les éléments de case à cocher ou de bouton radio, la valeur sera "on" ou "off" selon que l'élément est coché ou non. Le test s'arrêtera si l'assertion échoue.
check Cette commande permet de cocher un bouton à bascule (case à cocher ou bouton radio).
choose cancel on next confirmation Cette commande permet d'affecter la prochaine alerte de confirmation. Cette commande l'annulera. Si l'alerte est déjà présente, utilisez plutôt la commande webdriver choose cancel on visible confirmation.
choose cancel on next prompt Cette commande permet d'affecter la prochaine invite d'alerte. Cette commande l'annulera. Si l'alerte est déjà présente, utilisez plutôt la commande webdriver choose cancel on visible prompt.
choose ok on next confirmation Cette commande permet d'affecter la prochaine alerte de confirmation. Cette commande l'acceptera. Si l'alerte est déjà présente, utilisez plutôt la commande webdriver choose ok on visible confirmation.
click Cette commande permet de cliquer sur un élément cible (par exemple, un lien, un bouton, une case à cocher ou un bouton radio).
click at Cette commande permet de cliquer 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 (par exemple, 0,0 est le coin supérieur gauche de l'élément) et sont principalement utilisées pour vérifier les effets les relayant, par exemple l'effet d'entraînement du matériel.
close Cette commande permet de fermer la fenêtre actuelle. Il n'est pas nécessaire de fermer la fenêtre initiale, l'IDE la réutilisera; le fermer peut entraîner une baisse des performances du test.
debugger Cette commande permet d'interrompre l'exécution et d'entrer dans le débogueur.
do Cette commande permet de créer une boucle exécutant les commandes en cours au moins une fois. Terminez la branche avec la commande repeat if.
double click Cette commande permet de double-cliquer sur un élément (par exemple, un lien, un bouton, une case à cocher ou un bouton radio).
double click at Cette commande permet de double-cliquer 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 (par exemple, 0,0 est le coin supérieur gauche de l'élément) et sont principalement utilisées pour vérifier les effets les relayant, par exemple l'effet d'entraînement du matériel.
drag and drop to object Cette commande permet de faire glisser un élément et de le déposer sur un autre élément.
echo Cette commande permet d'afficher le message spécifié dans la troisième cellule du tableau de vos tableaux Selenese. Utile pour le débogage.
edit content Cette commande permet de définir la valeur d'un élément modifiable de contenu comme si vous y aviez saisi.
else Cette commande permet d'indiquer la partie d'un bloc if. Exécutez les commandes dans cette branche lorsqu'une condition if et/ou else if n'est pas remplie. Terminez la branche avec la commande end.
else if Cette commande permet d'indiquer la partie d'un bloc if. Exécutez les commandes dans cette branche lorsqu'une condition if n'est pas remplie. Terminez la branche avec la commande end.
end Cette commande permet de terminer un bloc de flux de contrôle pour if, while et times.
execute script Cette commande permet d'exécuter un extrait de code JavaScript dans le contexte du cadre ou de la fenêtre actuellement sélectionné. Le fragment de script sera exécuté en tant que corps d'une fonction anonyme. Pour entreposer la valeur de retour, utilisez le mot-clef 'return' et indiquer un nom de variable dans le champ d'entrée de la valeur.
execute async script Cette commande permet d'exécuter un extrait de code désynchronisé de JavaScript dans le contexte du cadre ou de la fenêtre actuellement sélectionné. Le fragment de script sera exécuté en tant que corps d'une fonction anonyme et doit renvoyer une Promise. Le résultat de la Promise sera enregistré sur la variable si vous utilisez le mot-clef 'return'.
for each Cette commande permet de créer une boucle exécutant les commandes en cours pour chaque élément d'une collection donnée.
if Cette commande permet de créer une branche conditionnelle dans votre test. Terminez la branche avec la commande end.
mouse down Cette commande permet de simuler un utilisateur appuyant sur le bouton gauche de la souris (sans le relâcher encore).
mouse down at Cette commande permet de simuler un utilisateur appuyant sur le bouton gauche de la souris (sans le relâcher encore) à l'emplacement spécifié.
mouse move at Cette commande permet de simuler un utilisateur appuyant sur le bouton de la souris (sans le relâcher encore) sur l'élément spécifié.
mouse out Cette commande permet de simuler un utilisateur éloignant le pointeur de la souris de l'élément spécifié.
mouse over Cette commande permet de simuler un utilisateur passant la souris sur l'élément spécifié.
mouse up Cette commande permet de simuler l'événement se produisant lorsque l'utilisateur relâche le bouton de la souris (par exemple, cesse de maintenir le bouton enfoncé).
mouse up at Cette commande permet de simuler l'événement se produisant lorsque l'utilisateur relâche le bouton de la souris (par exemple, cesse de maintenir le bouton enfoncé) à l'emplacement spécifié.
open Cette commande permet d'ouvrir une URL et d'attendre le chargement de la page avant de continuer. Elle accepte les URL relatives et absolues.
pause Cette commande permet d'attendre la durée spécifiée.
remove selection Cette commande permet de supprimer une sélection de l'ensemble d'options sélectionnées dans un élément à sélection multiple à l'aide d'un localisateur d'options.
repeat if Cette commande permet de terminer une branche de flux de contrôle «do» de manière conditionnelle. Si le résultat de l'expression conditionnelle fournie est vrai, il recommence la boucle do. Sinon, il met fin à la boucle.
run Cette commande permet d'exécuter un scénario de test à partir du projet actuel.
run script Cette commande permet de créer une nouvelle balise script dans le corps de la fenêtre de test actuelle et ajoute le texte spécifié dans le corps de la commande. Attention, les exceptions JS lancées dans ces balises script ne sont pas gérées par Selenium, donc vous devriez probablement envelopper votre script dans des blocs try/catch s'il y a une chance que le script lève une exception.
select Cette commande permet de sélectionner un élément dans un menu déroulant à l'aide d'un localisateur d'options. Les localisateurs d'options fournissent différentes manières de spécifier un élément de sélection (par exemple, label=, value=, id=, index=). Si aucun préfixe de localisateur d'option n'est fourni, une correspondance sur l'étiquette sera tentée.
select frame Cette commande permet de sélectionner un cadre dans la fenêtre actuelle. Vous pouvez sélectionner une image par son numéro d'index basé sur 0 (par exemple, sélectionnez la première image avec "index=0" ou la troisième image avec "index=2"). Pour les cadres imbriqués, vous devrez appeler cette commande plusieurs fois (une fois pour chaque image de l'arborescence jusqu'à ce que vous atteigniez l'image souhaitée). Vous pouvez sélectionner le cadre parent avec "relative=parent". Pour retourner en haut de la page, utilisez "relative=top".
select window Cette commande permet de sélectionner une fenêtre contextuelle à l'aide d'un localisateur de fenêtre. Une fois qu'une fenêtre contextuelle a été sélectionnée, toutes les commandes iront dans cette fenêtre. Les localisateurs de fenêtre utilisent des poignées pour sélectionner les fenêtres.
send keys Cette commande permet de simuler les événements de frappe sur l'élément spécifié, comme si vous aviez tapé la valeur clef par clef. Elle simule un utilisateur réel tapant chaque caractère dans la chaîne de caractères spécifiée; elle est également lié par les limitations d'un utilisateur réel, comme ne pas pouvoir taper dans un élément invisible ou en lecture seule. Elle est utile pour les widgets d'interface utilisateur dynamiques (comme les zones de liste déroulante à remplissage automatique) nécessitant des événements clefs explicites. Contrairement à la simple commande "type", forçant la valeur spécifiée directement dans la page, cette commande ne remplacera pas le contenu existant.
set speed Cette commande permet de régler la vitesse d'exécution (par exemple, définissez la durée en millisecondes d'un délai suivant chaque opération Selenium). Par défaut, il n'y a pas de tel délai, par exemple, le délai est de 0 millisecondes. Ce paramètre est global et affectera toutes les exécutions de test, jusqu'à ce qu'il soit modifié.
set window size Cette commande permet de définir la taille de la fenêtre du navigateur Web, y compris l'interface du navigateur Web.
store Cette commande permet d'enregistrer une chaîne de caractères cible en tant que variable pour une réutilisation facile.
store attribute Cette commande permet de demander la valeur d'un attribut d'élément. La valeur de l'attribut peut différer selon les navigateurs Web (c'est le cas de l'attribut "style", par exemple).
store json Cette commande permet d'entreposer un json.
store text Cette commande permet de demander le texte d'un élément et l'entrepose pour une utilisation ultérieure. Elle fonctionne pour tout élément contenant du texte.
store title Cette commande permet de demander le titre de la page actuelle.
store value Cette commande permet de demander la valeur de l'élément et l'entrepose pour une utilisation ultérieure. Elle fonctionne pour n'importe quel élément de type d'entrée.
store window handle Cette commande permet de demander l'identificateur de descripteur de la page actuelle.
store xpath count Cette commande permet de demander le nombre de nouds qui correspondent au xpath spécifié (par exemple, "// table" donnerait le nombre de tables).
submit Cette commande permet de soumettre le formulaire spécifié. Elle est particulièrement utile pour les formulaires sans boutons d'envoi, par exemple les formulaires de recherche à entrée unique.
times Cette commande permet de créer une boucle exécutant les commandes en cours n nombre de fois.
type Cette commande permet de définir la valeur d'un champ de saisie, comme si vous l'aviez tapé. Peut également être utilisé pour définir la valeur des zones de liste déroulante, des cases à cocher,... Dans ces cas, la valeur doit être la valeur de l'option sélectionnée, pas le texte visible. Avec Google Chrome uniquement : si un chemin de fichier est indiqué, il sera téléchargé vers l'entrée (pour type=file), Remarque : les localisateurs XPath ne sont pas pris en charge.
uncheck Cette commande permet de décocher un bouton bascule (case à cocher ou bouton radio).
verify Cette commande permet d'indiquer une affirmation logiciel qu'une variable est une valeur attendue. La valeur de la variable sera convertie en chaîne de caractères pour comparaison. Le test se poursuivra même si la vérification échoue.
verify checked Cette commande permet d'indiquer une affirmation logiciel qu'un bouton bascule (case à cocher ou bouton radio) a été coché. Le test se poursuivra même si la vérification échoue.
verify editable Cette commande permet d'indiquer une affirmation logiciel si l'élément d'entrée spécifié est modifiable (par exemple, n'a pas été désactivé). Le test se poursuivra même si la vérification échoue.
verify element present Cette commande permet d'indiquer une affirmation logiciel que l'élément spécifié est quelque part sur la page. Le test se poursuivra même si la vérification échoue.
verify element not present Cette commande permet d'indiquer une affirmation logiciel que l'élément spécifié n'est pas quelque part sur la page. Le test se poursuivra même si la vérification échoue.
verify not checked Cette commande permet d'indiquer une affirmation logiciel qu'un bouton à bascule (case à cocher ou bouton radio) n'a pas été coché. Le test se poursuivra même si la vérification échoue.
verify not editable Cette commande permet d'indiquer une affirmation logiciel si l'élément d'entrée spécifié n'est pas modifiable (par exemple, n'a pas été désactivé). Le test se poursuivra même si la vérification échoue.
verify not selected value Cette commande permet d'indiquer une affirmation logiciel que l'élément attendu n'a pas été choisi dans un menu de sélection par son attribut option. Le test se poursuivra même si la vérification échoue.
verify not text Cette commande permet d'indiquer une affirmation logiciel que le texte d'un élément n'est pas présent. Le test se poursuivra même si la vérification échoue.
verify selected label Cette commande permet d'indiquer une affirmation logiciel du texte visible pour une option sélectionnée dans l'élément de sélection spécifié. Le test se poursuivra même si la vérification échoue.
verify selected value Cette commande permet d'indiquer une affirmation logiciel que l'élément attendu a été choisi dans un menu de sélection par son attribut option. Le test se poursuivra même si la vérification échoue.
verify text Cette commande permet d'indiquer une affirmation logiciel que le texte d'un élément est présent. Le test se poursuivra même si la vérification échoue.
verify title Cette commande permet d'indiquer une affirmation logiciel que le titre de la page actuelle contient le texte fourni. Le test se poursuivra même si la vérification échoue.
verify value Cette commande permet d'indiquer une affirmation logiciel que la valeur (coupée en espace) d'un champ d'entrée (ou de tout autre élément avec un paramètre de valeur). Pour les éléments de case à cocher ou de bouton radio, la valeur sera "on" ou "off" selon que l'élément est coché ou non. Le test se poursuivra même si la vérification échoue.
wait for element editable Cette commande permet d'indiquer qu'il faut attendre qu'un élément soit modifiable.
wait for element not editable Cette commande permet d'indiquer qu'il faut attendre qu'un élément ne soit pas modifiable.
wait for element not present Cette commande permet d'indiquer qu'il faut attendre qu'un élément cible ne soit pas présent sur la page.
wait for element not visible Cette commande permet d'indiquer qu'il faut attendre qu'un élément cible ne soit pas visible sur la page.
wait for element present Cette commande permet d'indiquer qu'il faut attendre qu'un élément cible soit présent sur la page.
wait for element visible Cette commande permet d'indiquer qu'il faut attendre qu'un élément cible soit visible sur la page.
webdriver answer on visible prompt Cette commande permet d'indiquer qu'il faut affecter un prompt d'alerte actuellement affichée. Cette commande demande à Selenium de lui fournir la réponse spécifiée. Si l'alerte n'est pas encore apparue, utilisez plutôt répondre à la commande answer on next prompt.
webdriver choose cancel on visible confirmation Cette commande permet d'indiquer qu'il faut affecter une alerte de confirmation actuellement affichée. Cette commande demande à Selenium de l'annuler. Si l'alerte n'est pas encore apparue, utilisez à la place la commande choose cancel on next confirmation.
webdriver choose cancel on visible prompt Cette commande permet d'indiquer qu'il faut affecter un prompt d'alerte actuellement affichée. Cette commande demande à Selenium de l'annuler. Si l'alerte n'est pas encore apparue, utilisez à la place la commander choose cancel on next prompt.
webdriver choose ok on visible confirmation Cette commande permet d'indiquer qu'il faut affecter une alerte de confirmation actuellement affichée. Cette commande demande à Selenium de l'accepter. Si l'alerte n'est pas encore apparue, utilisez à la place la commande choose ok on next confirmation.
while Cette commande permet de créer une boucle exécutant les commandes en cours de manière répétée tant que l'expression conditionnelle fournie est vraie.


Dernière mise à jour : Mercredi, le 7 octobre 2020