Commandes GDSL - Android/Web

Commandes GDSL - Android/Web

MAJ 29 JUIL 2025

Inventaire des Commandes

Voici la description des Commandees GDSL regroupées par domaines :

  • Application

  • Vérification

  • Gestion du navigateur

  • Clic

  • Balise

  • Ecran

  • Paramètres

  • Appareil

  • Dump

  • Manageur de fichiers

  • Trouver

  • Capture d'écran

  • Défilement

  • Attente élément

  • Formulaire

  • Clavier

  • Réseau

  • OTP

  • Saisie de texte

  • Configuration UIAutomatorViewer

  • Zoom

Retrouvez le détail des commandes et leurs cas d’usage dans la section Détails de méthodes.

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

Application

Commande

Exemple

Description

applicationStart

applicationStart,[PACKAGE]

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

COMPATIBILITE : UNIVERSELLE

applicationToForeground

applicationToForeground,[PACKAGE]

Place une application déjà lancée au premier plan à partir de son nom de package.

COMPATIBILITE : UNIVERSELLE

applicationKill

applicationKill,[PACKAGE]

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

COMPATIBILITE : UNIVERSELLE

applicationClearData

applicationClearData,[PACKAGE]

Efface le cache d'une application à partir de son nom de package.

COMPATIBILITE : UNIVERSELLE

installApp

installApp,[PACKAGE]

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

uninstallApp

uninstallApp,[PACKAGE]

Désinstalle l'application à partir de son nom de package.

COMPATIBILITE : UNIVERSELLE

applicationCloseAll

 

Ferme toutes les applications récentes.

Vérification

Commande

Exemple

Description

assertNotExistsText

assertNotExistsText,[TEXTE]

Vérifie si l'élément dont le texte ou le content-desc contient le sélecteur de texte n'existe pas.

SENSIBLE-CASSE COMPATIBILITE : UNIVERSELLE

assertNotExistsTextExact

assertNotExistsTextExact,[TEXTE-EXACT]

Vérifie si l'élément dont le texte ou le content-desc est le sélecteur exact donné n'existe pas.

SENSIBLE-CASSE COMPATIBILITE : UNIVERSELLE

assertNotExistsId

assertNotExistsId,[ID]

Vérifie si l'élément avec le sélecteur id n'existe pas.

COMPATIBILITE : UNIVERSELLE

assertNotExistsClass

assertNotExistsClass,[CLASSE]

Vérifie si l'élément avec le sélecteur de classe n'existe pas.

COMPATIBILITE : UNIVERSELLE

Gestion Navigateur

Commande

Exemple

Description

setBrowser

setBrowser,chrome setBrowser,firefox

Définit le navigateur à utiliser.

launchBrowser

 

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

browserClearCache

 

Efface le cache du navigateur actuel.

browserNewTab

 

Ouvre un nouvel onglet dans le navigateur actuel.

browserGoToUrl

browserGoToUrl,https://greenspector.com/

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

browserCloseAllTabs

 

Ferme tous les onglets ouverts dans le navigateur actuel.

browserReset

 

La réinitialisation du navigateur efface le cache et les données de l'utilisateur et prépare le navigateur pour le test.

waitUntilPageLoaded

waitUntilPageLoaded,[DUREE]

Attend que la page web actuelle soit chargée.

COMPATIBILITE : UNIVERSELLE

browserPrepareAndOpen

 

Préparer le navigateur pour la mesure : (vider le cache, fermer tous les onglets, fermer le navigateur et le rouvrir).

browserCloseAllTabsAndOpen

 

Ferme tous les onglets du navigateur et ouvre un nouvel onglet. (Le navigateur sera fermé pendant le processus)

browserPrepareAndOpenForReference

 

Préparer le navigateur pour la mesure. Vider le cache, fermer tous les onglets, fermer le navigateur et le rouvrir, aller sur une page noire et attendre 60s.

changeDefaultSearchEngine

changeDefaultSearchEngine,Google

changeDefaultSearchEngine,Ecosia

Modifie le moteur de recherche par défaut du navigateur (non pris en charge par Firefox)

enableDisplaySiteAsDesktop

 

Permet d'afficher le site en mode pc. Le navigateur et le site web doivent être déjà ouverts.

disableDisplaySiteAsDesktop

 

Désactive l'affichage du site en mode pc. Le navigateur et le site web doivent être déjà ouverts.

Clic

Commande

Exemple

Description

longClickById

longClickById

longClickById,[DUREE]

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

DEFAULT : 1000 DUREE OPTIONNELLE COMPATIBILITE : UNIVERSELLE

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é.

DEFAULT : 1000 DUREE OPTIONNELLE COMPATIBILITE : UNIVERSELLE

longClickByXY

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

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

DEFAULT : 1000 COMPATIBILITE : UNIVERSELLE

clickByText

clickByText,[TEXTE]

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

NON-SENSIBLE-CASSE COMPATIBILITE : UNIVERSELLE

clickByTextExact

clickByTextExact,[TEXTE]

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

SENSIBLE-CASSE COMPATIBILITE : UNIVERSELLE

clickByClass

clickByClass,[CLASSE]

Clique sur l'élément avec le sélecteur de classe donné.

COMPATIBILITE : UNIVERSELLE

clickByXY

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

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

COMPATIBILITE : 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.

COMPATIBILITE : UNIVERSELLE

clickById

clickById,[ID]

Clique sur l'élément qui contient l'identification donnée.

COMPATIBILITE : UNIVERSELLE

clickOnLastElementFound

 

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

COMPATIBILITE : UNIVERSELLE

Appareil

Commande

Exemple

Description

pressHome

 

Appuie sur le bouton d'accueil.

COMPATIBILITE : UNIVERSELLE

pause

pause,[DUREE]

Attend la durée en millisecondes en argument.

COMPATIBILITE : UNIVERSELLE

pressEnter

 

Appuie sur le bouton d'entrée.

COMPATIBILITE : UNIVERSELLE

pressPower

 

Appuie sur le bouton d'alimentation.

COMPATIBILITE : UNIVERSELLE

pressBack

 

Appuie sur la touche retour.

COMPATIBILITE : UNIVERSELLE

pressRecentApps

 

Appuie sur le bouton des applications récentes.

COMPATIBILITE : UNIVERSELLE

pressTab

 

Appuie sur la touche TAB. Vous pouvez naviguer jusqu'à l'élément suivant dans la vue qui peut recevoir le focus. Utile pour les formulaires.

COMPATIBILITE : UNIVERSELLE

pressMajTab

 

Appuie sur la touche MAJ + TAB. Vous pouvez naviguer à l'élément précédent dans la vue qui peut recevoir le focus. Utile pour les formulaires.

COMPATIBILITE : UNIVERSELLE

setVolume

setVolume,min setVolume,mid setVolume,max

Définit le volume des flux de l'appareil à la valeur donnée.

pressKeyCode

pressKeyCode,[KEYCODE]

pressKeyCode,36: pour appuyer sur h (KEYCODE_H)

pressKeyCode,36,64 : pour appuyer sur H (KEYCODE_H) en majuscule (META_SHIFT_LEFT_ON)

Réalise une action en utilisant une (ou plusieurs) clé d'évenement. Il faut indiquer la valeur numérique de la clé (la constant value sur la page d’Android Developers)

La liste des codes de touches et des méta-états se trouve ici : https://developer.android.com/reference/android/view/KeyEvent.

COMPATIBILITE : UNIVERSELLE

openQuickSettings

 

Ouvre les réglages rapides.

COMPATIBILITE : UNIVERSELLE

enableHotspot

 

Active le paramètre hotspot.

disableHotspot

 

Désactive le paramètre hotspot.

enableSettings

enableSettings,[NOM-PARAMETRE1]|[NOM-PARAMETRE2]|[NOM-PARAMETRE3]

Active le premier paramètre de la liste de noms de paramètres donnée.

disableSettings

disableSettings,[NOM-PARAMETRE1]|[NOM-PARAMETRE2]|[NOM-PARAMETRE3]

Désactive le premier paramètre de la liste de noms de paramètres donnée.

Dump

Commande

Exemple

Description

dump

dump

dump,[NOM-FICHIER]

Prend un dump de l'état actuel de l'appareil. S'il est défini, le fichier sera stocké dans fileName.uix. S'il n'est pas défini, le dump sera stocké dans le fichier dump.uix.

DUREE OPTIONNELLE COMPATIBILITE : UNIVERSELLE

Manageur de fichiers

Commande

Exemple

Description

filesEmptyDownloadsFolder

 

Vide le dossier de téléchargement de l'appareil.

filesOpenDownloadsFolder

 

Ouvre le système de fichiers et va dans le dossier de téléchargement.

filesSelectDownloadsFolder

 

Sur un système de fichiers ouvert, va dans le dossier de téléchargement.

filesDownloadFile

filesDownloadFile,[URL-FICHIER]

Télécharge un fichier. Le fichier sera stocké dans le fichier Téléchargementd de l’appareil.

Trouver

Commande

Exemple

Description

findByText

findByText,[TEXTE]

findByText,[TEXTE],[RANG]

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

NON-SENSIBLE-CASSE RANG PAR DEFAUT : 1 RANG OPTIONNEL COMPATIBILITE : UNIVERSELLE

findByTextExact

findByText,[TEXTE-EXACT]

findByText,[TEXTE-EXACT],[RANG]

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

SENSIBLE-CASSE RANG PAR DEFAUT : 1 RANG OPTIONNEL COMPATIBILITE : UNIVERSELLE

findById

findById,[ID]

findById,[ID],[RANG]

Trouve le nième élément à l'aide du sélecteur id. L'élément est enregistré comme le dernier élément trouvé.

RANG PAR DEFAUT : 1 RANG OPTIONNEL COMPATIBILITE : 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é.

RANG PAR DEFAUT : 1 RANG OPTIONNEL COMPATIBILITE : UNIVERSELLE

findParentLastElementFound

 

Trouve le parent du dernier élément trouvé. Le parent est sauvegardé et remplace le dernier élément trouvé.

COMPATIBILITE : UNIVERSELLE

findChildByClassLastElementFound

findChildByClassLastElementFound,[CLASSE]

Trouve le premier enfant du dernier élément trouvé en utilisant la classe donnée comme sélecteur. Le parent est sauvegardé et remplace le dernier élément trouvé.

COMPATIBILITE : UNIVERSELLE

findChildByIndexLastElementFound

findChildByIndexLastElementFound,[RANG]

Trouve par index un enfant du dernier élément trouvé. L'index correspond à l'index dans le vidage d'écran.

RANG PAR DEFAUT : 0 RANG OPTIONNEL COMPATIBILITE : UNIVERSELLE