> For the complete documentation index, see [llms.txt](https://kaliostest-nouvelle-version.gitbook.io/manuel-utilisateur/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kaliostest-nouvelle-version.gitbook.io/manuel-utilisateur/chapitre-1-les-concepts/objet-propriete-action.md).
# Objet / Propriété / Action
## Définition
| Concept | Explication | Exemple |
| --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Objet |
Un élément d'une page (bouton, liste, …).
Un objet de saisie est un objet dans lequel on peut saisir/sélectionner un paramètre (par exemple un champ texte).
Un objet de navigation est un objet cliquable (par exemple un menu ou un icône).
Un objet de vérification est un objet à l'écran avec une valeur à vérifier.
|
Un champ texte « login » est un objet de saisie.
Un bouton « Ajouter au panier » est un objet de navigation.
Le montant de TVA est un objet de vérification.
|
| Propriété |
La propriété utilisée pour localiser un objet. L'approche d'automatisation de kaliosTest est de localiser un objet par le texte affiché à l’écran (par exemple le texte d’un bouton ou le texte à côté d’un champ). On peut également mettre une partie du texte.
Les propriétés internes des objets peuvent aussi être utilisées pour localiser un objet : un id, un name ou un xpath.
Xpath = une expression régulière pour rechercher un élément dans un document
| La propriété texte « Ajouter au panier » d’un bouton. |
| Action |
Une action effectuée sur un objet.
Action de saisie : saisir une donnée dans un champ, sélectionner une valeur dans une liste. Ces actions sont paramétrables (ex : valeur à saisir).
Action de navigation : cliquer sur un élément cliquable comme un lien ou un bouton. Ces actions ne sont pas paramétrables.
Action de vérification : vérifier un texte à l’écran. Ces actions sont paramétrables avec la valeur attendue (par exemple un montant de TVA attendu).
Certaines actions ne sont pas effectuées un objet particulier. Par exemple faire une verification dans un fichier PDF.
|
Je sélectionne la valeur XL dans la liste des tailles (action de saisie)
Je clique sur ajouter un article (action de navigation)
Je vérifie le montant Total TTC (action de vérification)
Je vérifie le contenu d'un fichier PDF (action de vérification)
|
## Les actions principales
### clickbytext
L’action clickbytext permet de cliquer sur un objet cliquable comme un bouton. Pour localiser l’objet, mettre le texte de l’objet (ex : SEARCH) :
Parfois, on peut avoir plusieurs objets cliquables avec le même texte (ex: ADD TO CART) :
Dans ce cas, pour localiser l’objet, on peut mettre le texte de l'objet (ADD TO CART) et un texte proche permettant de les distinguer (ex: adidas Consortium). L'action clickbytext cherchera l'objet (ex: ADD TO CART) proche du text (ex:adidas Consortium).
### hoverbytext
L’action hoverbytext est similaire à clickbytext et permet de déplacer la souris au dessus d’un texte (sans toutefois cliquer dessus). Cette action peut servir pour déplacer la souris sur un menu (ex: Apparel) et ainsi ouvrir des sous-menus sur lesquels on pourra cliquer (ex: Shoes) :
Comme pour le clickbytext, pour localiser l’objet avec hoverbytext, mettre le texte de l’objet (ex : Apparel).
### sendkeysbytext
L’action sendkeysbytext permet de saisir une valeur dans un champ. Pour localiser l’objet, mettre le texte à côté du champ (ex: Email) :
On peut aussi mettre le texte à l’intérieur du champ qui sert à le décrire (ex Zip / postal code) :
### selectbytext
L’action selectbytext est similaire à sendkeysbytext et permet de sélectionner une valeur dans une liste. Pour localiser l’objet, mettre le texte à côté de la liste (ex: Size) :
ou un élément existant à l’intérieur de la liste (ex : Select country) :
Selectbytext peut également servir pour les radios boutons et les cases à cocher. Pour localiser l’objet, mettre le texte à côté du radio bouton / de la case à cocher (ex : I agree with the terms of service and I adhere to them unconditionally) :
