Automatisation des tests End-2-End d'un système d'information intégré
Partie 2-2. Implémentation du processus de téléchargement d'un fichier depuis un conteneur avec un navigateur vers un framework de test. Recherchez le nom du fichier téléchargé par le navigateur
Auteur: habr.com/us/users/anrad
Hubs:
Tags: #autotest, #selenium, #selenoid, #headlessbrowser, #downloadLorsque nous développions des autotests End-2-End pour l'interface utilisateur, nous étions confrontés à la question «Comment obtenir le nom du dernier chargé navigateur de fichiers de WebDriver? ", Google n’a rien obtenu rapidement. Par conséquent, j'ai écrit cet article, qui a en même temps dit ce que nous avions exactement un problème et comment nous l'avons résolu.Avec cet article, nous continuons une série de publications sur la façon dont nous avons automatisé le processus de test manuel (ci-après dénommé auto-tests) d'un grand système d'information (ci-après dénommé Systèmes) dans l'un des principaux projets LANIT et ce qui en est ressorti.
la sourceL'article lui-même complète le cycle, ci-dessous est un lien vers toutes les parties précédentes:Partie 1. Organisationnelle et managériale. Pourquoi avions-nous besoin d'automatisation. Organisation du processus de développement et de gestion. Organisation de l'utilisationPartie 2. Technique. Architecture et pile technique. Détails de mise en œuvre et surprises techniquesPartie 2-1. Implémentation de la classe de base pour tous les tests et JUnit RuleChain.C'était il y a un an. Aujourd'hui, cela n'est peut-être pas pertinent. Écrivez dans les commentaires si vous savez comment traiter efficacement des fichiers avec plusieurs serveurs de grille sélénoïde.Lors du développement des «autotests», nous avons eu la tâche de télécharger (télécharger) des fichiers à partir du système avec une analyse ultérieure de leur contenu. Pour «télécharger» des fichiers à partir du système testé, nous utilisons les solutions suivantes:- pour le mode de lancement "local" (lancement directement sur le PC de travail) - lorsque le navigateur "local" est initialisé, le nom du dossier local temporaire lui est transmis en paramètre. Ensuite, le fichier est lu directement à partir du dossier local pour une analyse ultérieure;
- pour le mode "à distance" (via Bamboo) - le fichier a été "extrait" du conteneur avec le navigateur via la fonction de serveur Solenoid: selenoid-host.example.com : 4444 / download / {SESSION_ID} / {FILE_NAME}
Les détails sont décrits dans la documentation.Pour les deux modes, pour accéder au fichier, il fallait connaître son nom. Ce fut une surprise. Le problème du manque de données sur le nom du fichier «download» était le suivant:- après avoir «cliqué» sur le bouton «télécharger le fichier», le navigateur a téléchargé le fichier dans le dossier local approprié dans le conteneur;
- dans ce cas, le nom du fichier a été formé dynamiquement et, comment le déterminer à l'avance, nous n'avons pas pu le trouver. C'était une caractéristique de notre système de test;
- En outre, ce fichier doit être «retiré» du conteneur et une vérification commerciale de son contenu doit être effectuée;
- pour «extraire» le fichier, vous devez connaître son nom, mais nous ne connaissions pas le nom, car le nom était généré dynamiquement et il n'y avait aucune valeur dans le lien.
De plus, la situation était aggravée par le fait qu'en raison de la grande complexité de certains tests, plusieurs fichiers pouvaient être déchargés pendant le test dans le cadre de différents scripts de test indépendants de la composition du test lui-même.La meilleure solution pour nous était la méthode selon laquelle nous avons déterminé le dernier fichier téléchargé. Il y avait plusieurs façons de procéder:- . . , ;
- Google Chrome javascript chrome://downloads/, html-. .
L'analyse de la composition des fichiers chargés par le navigateur pour le mode local est une tâche triviale.Pour le mode distant, vous devez utiliser la fonction «non documenté» du serveur selenoid: selenoid-host.example.com : 4444 / download / {SESSION_ID} affiche une liste de tous les fichiers téléchargés avec succès, où SESSION_ID est un ID de session selenoid.En général, le schéma fonctionne bien à une exception près: nous Vous devez attendre un certain temps jusqu'à ce que le fichier soit téléchargé et apparaisse dans la liste. L'attente peut être définie via un cycle de temporisation, cependant, de cette façon, nous ne pouvons pas obtenir d'informations sur une éventuelle erreur de téléchargement de fichier. Nous pouvons seulement déterminer que le fichier n'a pas été chargé dans ce circuit. Par conséquent, à la fin, nous avons opté pour la méthode de détermination du nom de fichier via la page chrome: // Downloads /.Obtenir le nom du fichier via le chrome: // téléchargements / page
Cette méthode fonctionne aussi bien en mode local que distant. Le schéma de travail est assez simple:- exécutez le script java pour ouvrir la fenêtre chrome: // téléchargements /;
- traiter les données dans la fenêtre de la manière habituelle. Attendez que le premier fichier de la liste soit chargé et déterminez son nom;
- fermez la fenĂŞtre chrome: // Downloads / et retournez le nom du fichier que vous recherchez.
Nous avons recherché sur Google l’idée d’utiliser chrome: // Downloads / et, à mon grand regret, je ne peux pas fournir de lien vers la source, car elle n’était pas conservée. L'implémentation réelle de la classe pour obtenir le nom de fichier est donnée ci-dessous.Classe pour obtenir le nom du fichier téléchargé via chrome: // téléchargements / private static final long DOWNLOADS_PAGE_LOAD_TIMEOUT = 5_000;
private static final long MAX_GET_FILE_NAME_ATTEMPT = 5;
public static String getLastDownloadedFilename() throws DownloaderException {
String[] filename = new String[1];
Exception[] ex = new Exception[1];
WebDriver driver = WebDriverRunner.getWebDriver();
JavascriptExecutor executor = (JavascriptExecutor) driver;
Utils.driver.openNewTabCheckAndClose(
() -> {
executor.executeScript("window.open('','_blank');");
},
() -> {
driver.get("chrome://downloads/");
for (int i = 0; i < MAX_GET_FILE_NAME_ATTEMPT; i++) {
ex[0] = null;
sleep();
try {
WebElement element = (WebElement) executor.executeScript(
"return document.querySelector('downloads-manager').shadowRoot.querySelector('downloads-item').shadowRoot.getElementById('file-link')");
filename[0] = element.getText();
LOGGER.info("Attempt get file name " + i + ". Name = '" + filename[0] + "'");
} catch (WebDriverException e) {
ex[0] = e;
LOGGER.info("Failed attempt "+ i + " to get filename text: " + e.getMessage());
continue;
}
if (filename[0] != null && !filename[0].isEmpty()) {
executor.executeScript(
"document.querySelector('downloads-manager').shadowRoot.querySelector('downloads-item').shadowRoot.getElementById('remove').click()");
break;
}
}
}
);
if (filename[0] != null && !filename[0].isEmpty()) {
return filename[0];
}
String message = "Timeout. Can not get last downloaded file name from chrome://downloads/. File name is '" + filename[0] + "'. Exception: " + ex[0].getMessage();
LOGGER.warning(message);
throw new DownloaderException(message, ex[0]);
}