Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Status
colourGreen
titlemaj 31 oct 2024

Inventaire des Commandes

Voici la description des commandes GDSL regroupées par domaine

...

:

  • Application

  • Gestion du Navigateur

  • Clic

  • Appareil

  • Trouver

  • Balise

  • Défilement

  • Saisie de texte

  • Attente d'élément

Le paramètre d'une commande ne doit pas contenir de virgule, car il s'agit du caractère séparateur.

Excerpt
nameapplication

Application

Commande

Exemple

Description

applicationStart

applicationStart,[PACKAGE]

Démarre une application à partir de son nom de package.

Status
colourYellow
titlecompatibilitE : universelle

applicationKill

applicationKill,[PACKAGE]

Force une application à s'arrêter à partir de son nom de package.

Status
colourYellow
titlecompatibilitE : universelle

installApp

installApp,[PACKAGE]

Installe l'application à partir de son nom de package.

Excerpt
namebrowsermanager

Gestion Navigateur

Commande

Exemple

Description

launchBrowser

Lance le navigateur actuellement défini. S'il n'est pas défini, lance le navigateur par défaut Chrome.

browserGoToUrl

browserGoToUrl,https://greenspector.com/

Parcourt l'url donnée dans le navigateur actuel.

browserClearCache

Vide le cache de Safari.

browserPrepareAndOpen

Prépare le navigateur pour la mesure. Vide le cache, ferme tous les onglets, ferme le navigateur et le rouvre.

browserPrepareAndOpenForReference

Prépare le navigateur pour la mesure. Vide le cache, ferme tous les onglets, ferme le navigateur et le rouvre, va sur une page noire et attend 60s.

Excerpt
nameclick

Clic

Commande

Exemple

Description

longClickByText

longClickByText,[TEXTE]

longClickByText,[TEXTE],[DUREE]

Effectue un clic long pour la durée donnée sur l'élément qui contient le sélecteur de texte donné.

Status
titledefault : 1000
Status
colourBlue
titleduree optionnelle
Status
colourYellow
titlecompatibilitE : universelle

longClickByXY

longClickByXY,[X-POS],[Y-POS]

Effectue un clic long de la durée donnée sur la coordonnée donnée.

Status
titledefault : 1000
Status
colourYellow
titlecompatibilitE : universelle

clickByText

clickByText,[TEXTE]

Clique sur l'élément qui contient le sélecteur de texte donné.

Status
colourGreen
titlenon-sensible-casse
Status
colourYellow
titlecompatibilitE : universelle

clickByTextExact

clickByTextExact,[TEXTE]

Clique sur l'élément qui contient exactement le sélecteur de texte donné.

Status
colourPurple
titlesensible-casse
Status
colourYellow
titlecompatibilitE : universelle

clickByXY

clickByXY,[X-Pos],[Y-Pos]

Clique sur l'élément situé aux coordonnées données.

Status
colourYellow
titlecompatibilitE : universelle

clickByPercent

clickByPercent,[X-Perc],[Y-Perc]

Clique sur l'élément situé aux coordonnées calculées à partir des pourcentages donnés de l'écran de l'appareil.

Status
colourYellow
titlecompatibilitE : universelle

clickByTextOnSystemPopup

clickByTextOnSystemPopup,[TEXTE]

Clique sur une fenêtre pop-up système qui n'est pas détectée automatiquement et qui contient le sélecteur de texte donné. Les fenêtres pop-up détectées automatiquement sont acceptées par défaut.

clickOnLastElementFound

Clique sur le dernier élément trouvé par la commande GDSL précédente dans le groupe Rechercher comme findByText ou findByTextExact.

Status
colourYellow
titlecompatibilitE : universelle

Excerpt
namedevice

Appareil

Commande

Exemple

Description

pause

pause,[DUREE]

Attend la durée en millisecondes en argument.

Status
colourYellow
titlecompatibilitE : universelle

pressHome

pressHome

Presse le bouton accueil.

Status
colourYellow
titlecompatibility : universal

pressVolumeDown

pressVolumeDown

Presse le bouton volume bas.

Status
colourYellow
titlecompatibility : universal

pressVolumeUp

pressVolumeUp

Presse le bouton volume haut.

Status
colourYellow
titlecompatibility : universal

Excerpt
nameTrouver

Trouver

Commande

Exemple

Description

findByText

findByText,[TEXTE]

findByText,[TEXTE],[RANG]

Trouve le nième élément dont le texte contient le sélecteur donné. L'élément est enregistré comme le dernier élément trouvé.

Status
colourGreen
titlenon-sensible-casse
Status
titlerang par defaut : 1
Status
colourBlue
titlerang optionnel
Status
colourYellow
titlecompatibilitE : universelle

findByTextExact

findByText,[TEXTE-EXACT]

findByText,[TEXTE-EXACT],[RANG]

Trouve le nième élément dont le texte correspond exactement au sélecteur donné. L'élément est enregistré comme le dernier élément trouvé.

Status
colourPurple
titlesensible-casse
Status
titlerang par defaut : 1
Status
colourBlue
titlerang optionnel
Status
colourYellow
titlecompatibilitE : universelle

findByClass

findById,[CLASSE]

findById,[CLASSE],[RANG]

Trouve le nième élément avec le sélecteur de classe. L'élément est enregistré comme le dernier élément trouvé.

Status
titlerang par defaut : 1
Status
colourBlue
titlerang optionnel
Status
colourYellow
titlecompatibilitE : universelle

Excerpt
nameprobe

Balise

Commande

Exemple

Description

measureStart

measureStart,CHRGT_accueil

Lance une mesure qui peut être identifiée par le nom donné.

Status
colourYellow
titlecompatibilitE : universelle

measureStop

Arrête la mesure en cours.

Status
colourYellow
titlecompatibilitE : universelle

Excerpt
namescroll

Défilement

Commande

Exemple

Description

scrollDownward

Défile l'écran vers le bas (uniquement 1 scroll).

Status
colourYellow
titlecompatibilitE : universelle

scrollUpward

Défile l'écran vers le haut (uniquement 1 scroll).

Status
colourYellow
titlecompatibilitE : universelle

scrollLeftward

Fait défiler l'écran vers la gauche (uniquement 1 scroll).

Status
colourYellow
titlecompatibilitE : universelle

scrollRightward

Fait défiler l'écran vers la droite (uniquement 1 scroll).

Status
colourYellow
titlecompatibilitE : universelle

swipeRightward

swipeRighward,[percY]

Swipes rightward the screen. The swipe gesture is from screen point A (X 90%, Y percY) to screen point B (X 10%, Y percY).

Status
colourYellow
titlecompatibilitE : universelle

swipeLeftward

swipeLeftward,[percY]

Swipes leftward the screen. The swipe gesture is from screen point A (X 10%, Y percY) to screen point B (X 90%, Y percY).

Status
colourYellow
titlecompatibilitE : universelle

swipeUpward

swipeUpward

swipeUpward,[percX],[percStartY]

Swipes upward the screen. The swipe gesture is from screen point A (X percX, Y percStartY) to screen point B (X percX, Y 90%).

Status
titledefault percx : 50
Status
titledefault percstarty : 10
Status
colourBlue
titleoptional perc
Status
colourYellow
titlecompatibilitE : universelle

swipeDownward

swipeDownward

swipeDownward,[percX],[percStartY]

Swipes downward the screen. The swipe gesture is from screen point A (X percX, Y percStartY) to screen point B (X percX, Y 10%).

Status
titledefault percx : 50
Status
titledefault percstarty : 90
Status
colourBlue
titleoptional perc
Status
colourYellow
titlecompatibilitE : universelle

swipeVertical

swipeVertical,[percStartY],[percEndY],[percX]

swipeVertical,[percStartY],[percEndY],[percX],[DUREE]

Swipes vertically the screen. The swipe gesture is from screen point A (X percX, Y percStartY) to screen point B (X percX, Y percEndY).

Status
titledefault duration : 500
Status
colourBlue
titleduree optionnelle
Status
colourYellow
titlecompatibilitE : universelle

swipeHorizontal

swipeHorizontal,[percStartX],[percEndX],[percY]

swipeHorizontal,[percStartX],[percEndX],[percY],[DURATION]

Swipes horizontally the screen. The swipe gesture is from screen point A (X percStartX, Y percY) to screen point B (X percEndX, Y percY).

Status
titledefault duration : 500
Status
colourBlue
titleduree optionnelle
Status
colourYellow
titlecompatibilitE : universelle

swipeDownwardToText

swipeDownwardToText,[TEXTE]

swipeDownwardToText,[TEXTE],[ITERATION],[percX]

Glisse vers le bas pour trouver le premier élément qui contient le sélecteur donné. Le geste de balayage va du point A de l'écran (X 50 %, Y 90 %) au point B de l'écran (X 50 %, Y 10 %).

Status
colourGreen
titlecase-insensitive
Status
titledefault iterations : 10 (max 30)
Status
colourYellow
titlecompatibility : universal

swipeUpwardToText

swipeUpwardToText,[TEXTE]

swipeUpwardToText,[TEXTE],[ITERATIONS],[percX]

Glisse vers le haut pour trouver le premier élément qui contient le sélecteur donné. Le geste de balayage va du point A de l'écran (X 50 %, Y 10 %) au point B de l'écran (X 50 %, Y 90 %).

Status
colourPurple
titleCASE-SENSITIVE
Status
titledefault iterations : 10 (max 30)
Status
titledefault percx: 50
Status
colourBlue
titleoptional iterations and percx
Status
colourYellow
titlecompatibility : universal

Excerpt
namesettext

Saisie de texte

Commande

Exemple

Description

setTextByText

setTextByText,[TEXTE],[TEXTE-SELECTEUR]

Colle le texte donné dans l'élément qui contient le texte sélectionné.

Status
colourYellow
titlecompatibilitE : universelle

setTextByTextExact

setTextByText,[TEXTE],[TEXTE-EXACT-SELECTEUR]

Colle le texte donné dans l'élément qui contient le texte sélectionné exact.

Status
colourYellow
titlecompatibilitE : universelle

enterText

enterText,[TEXTE]

enterText,[TEXTE],[FREQUENCE]

Saisit le texte donné dans le champ sélectionné en cliquant sur les touches du clavier pour chaque caractère. Le texte est saisi caractère par caractère à la fréquence donnée.

Status
colourBlue
titlefrequence optionnelle
Status
colourYellow
titlecompatibilitE : universelle

enterTextFast

enterTextFast,[TEXTE]

Saisit le texte spécifié dans le paramètre. Saisir tout le texte en une seule fois.

Status
colourYellow
titlecompatibilitE : universelle

Excerpt
nameWait Object

Attente Elément

Commande

Exemple

Description

waitUntilText

waitUntilText,[TEXTE]

waitUntilText,[TEXTE],[TIMEOUT]

Attend qu'un élément de vue avec le texte spécifié devienne visible à l'écran jusqu'à un délai spécifié. S'il n'est pas trouvé, une erreur est générée.

Status
colourGreen
titlenon-sensible-casse
Status
titletimeout PAR DEFAUT: 30000
Status
colourBlue
titletimeout OPTIONNEL
Status
colourYellow
titlecompatibilitE : universelle

waitUntilAccessibilityField

waitUntilDesc,[NAME/ID]

waitUntilDesc,[NAME/ID],[TIMEOUT]

Attend qu'un élément de vue dont le name (Appium Inspector) ou identifier (dump) est spécifié devienne visible à l'écran jusqu'à un délai spécifié. S'il n'est pas trouvé, une erreur est générée.

Status
colourGreen
titlenon-sensible-casse
Status
titletimeout PAR DEFAUT: 30000
Status
colourBlue
titletimeout OPTIONNEL
Status
colourYellow
titlecompatibilitE : universelle

waitUntilTextBeforeClick

  • waitUntilTextBeforeClick,[TEXTE]= waitUntilTextBeforeClick,[TEXTE],false

Attend qu'un élément de vue avec le texte spécifié devienne visible à l'écran et clique dessus. Si false, il attend 10 secondes max avant que l'erreur ne soit déclenchée. Si true, il attend 2 secondes max.

Status
titlebooleEn PAR DEFAUT: false
Status
colourBlue
titlebooleEn OPTIONNEL
Status
colourYellow
titlecompatibilitE : universelle

waitUntilAccessibilityFieldBeforeClick

  • waitUntilDescBeforeClick,[NAME/ID]= waitUntilDescBeforeClick,[NAME/ID],false

Attend qu'un élément de vue avec le name (Appium Inspector) ou identifier (dump) spécifié devienne visible à l'écran et clique dessus. Si false, il attend 10 secondes max avant que l'erreur ne soit déclenchée. Si true, il attend 2 secondes max.

Status
titlebooleEn PAR DEFAUT: false
Status
colourBlue
titlebooleEn OPTIONNEL
Status
colourGreen
titlenon-sensible-casse
Status
colourYellow
titlecompatibilitE : universelle

waitUntilTextExact

waitUntilTextExact,[TEXTE-EXACT]

waitUntilTextExact,[TEXTE-EXACT],[TIMEOUT]

Attend qu'un élément de vue, avec le texte exact sélectionné, devienne visible à l'écran jusqu'à un délai spécifié. S'il n'est pas trouvé, une erreur est générée.

Status
colourPurple
titlesensible-casse
Status
titletimeout PAR DEFAUT: 30000
Status
colourBlue
titletimeout OPTIONNEL
Status
colourYellow
titlecompatibilitE : universelle

waitUntilTextExactBeforeClick

  • waitUntilTextExactBeforeClick,[TEXTE-EXACT]= waitUntilTextExactBeforeClick,[TEXTE-EXACT],false

Attend qu'un élément de vue, avec le texte exact sélectionné, devienne visible à l'écran et clique dessus. Si false, il attend 10 secondes max avant que l'erreur ne soit déclenchée. Si true, il attend 2 secondes max.

Status
colourPurple
titlesensible-casse
Status
titlebooleEn PAR DEFAUT: false
Status
colourBlue
titlebooleEn OPTIONNEL
Status
colourYellow
titlecompatibilitE : universelle

waitUntilAccessibilityFieldExact

waitUntilDescExact,[NAME/ID-EXACT]

waitUntilDescExact,[NAME/ID-EXACT],[TIMEOUT]

Attend qu'un élément de vue, avec le name (Appium Inspector) ou identifier (dump) exact sélectionné, devienne visible à l'écran jusqu'à un délai spécifié. S'il n'est pas trouvé, une erreur est générée.

Status
colourPurple
titlesensible-casse
Status
titletimeout PAR DEFAUT: 30000
Status
colourBlue
titletimeout OPTIONNEL
Status
colourYellow
titlecompatibilitE : universelle

waitUntilAccessibilityFieldExactBeforeClick

  • waitUntilDescExactBeforeClick,[NAME/ID-EXACT]= waitUntilDescExactBeforeClick,[NAME/ID-EXACT],false

Attend qu'un élément de vue, avec le name (Appium Inspector) ou identifier (dump) exact sélectionné, devienne visible à l'écran et clique dessus. Si false, il attend 10 secondes max avant que l'erreur ne soit déclenchée. Si true, il attend 2 secondes max.

Status
colourPurple
titlesensible-casse
Status
titlebooleEn PAR DEFAUT: false
Status
colourBlue
titlebooleEn OPTIONNEL
Status
colourYellow
titlecompatibilitE : universelle

waitUntilGoneText

waitUntilGoneText,[TEXTE]

waitUntilGoneText,[TEXTE],[TIMEOUT]

Attend qu'il n'y ait pas d'élément de vue, avec du texte sélectionné, visible à l'écran jusqu'à un délai spécifié. S'il est toujours trouvé, une erreur est générée.

Status
colourGreen
titlenon-sensible-casse
Status
titletimeout PAR DEFAUT: 30000
Status
colourBlue
titletimeout OPTIONNEL
Status
colourYellow
titlecompatibilitE : universelle

waitUntilGoneTextExact

waitUntilGoneTextExact,[TEXTE-EXACT]

waitUntilGoneTextExact,[TEXTE-EXACT],[TIMEOUT]

Attend qu'aucun élément d'affichage, avec le texte exact sélectionné, ne soit visible à l'écran jusqu'à un délai spécifié. S'il est toujours trouvé, une erreur est générée.

Status
colourPurple
titlesensible-casse
Status
titletimeout PAR DEFAUT: 30000
Status
colourBlue
titletimeout OPTIONNEL
Status
colourYellow
titlecompatibilitE : universelle

waitUntilGoneAccessibilityField

waitUntilGoneDesc,[NAME/ID]

waitUntilGoneDesc,[NAME/ID],[TIMEOUT]

Attend qu'il n'y ait pas d'élément view, avec name (Appium Inspector) ou identifier (dump) sélectionné, visible à l'écran jusqu'à un délai spécifié. S'il est encore trouvé, une erreur est générée.

Status
colourGreen
titlenon-sensible-casse
Status
titletimeout PAR DEFAUT: 30000
Status
colourBlue
titletimeout OPTIONNEL
Status
colourYellow
titlecompatibilitE : universelle

waitUntilGoneAccessibilityFieldExact

waitUntilGoneDescExact,[NAME/ID-EXACT]

waitUntilGoneDescExact,[NAME/ID-EXACT],[TIMEOUT]

Attend qu'il n'y ait pas d'élément view, avec name (Appium Inspector) ou identifier (dump) sélectionné, visible à l'écran jusqu'à un délai spécifié. S'il est encore trouvé, une erreur est générée.

Status
colourPurple
titlesensible-casse
Status
titletimeout PAR DEFAUT: 30000
Status
colourBlue
titletimeout OPTIONNEL
Status
colourYellow
titlecompatibilitE : universelle

waitUntilTextOnSystemPopup

waitUntilTextOnSystemPopup,[TEXT]

waitUntilTextOnSystemPopup,[TEXT],[TIMEOUT]

Attend une fenêtre pop-up du système qui n'est pas détectée automatiquement et qui contient le sélecteur de texte donné. Les fenêtres pop-up détectées automatiquement sont acceptées par défaut.

Status
colourGreen
titleCASE-inSENSITIVE
Status
titledefault timeout: 30000
Status
colourBlue
titleoptional timeout
Status
colourYellow
titlecompatibility : universal