#Author: your.email@your.domain.com #Keywords Summary: #Feature: List of scenarios. #Scenario: Business rule through list of steps with arguments. #Given: Some precondition step #When: Some key actions #Then: To observe outcomes or validation #And,But: To enumerate more Given,When,Then steps #Scenario Outline: List of steps for data-driven as an Examples and #Examples: Container. As an alternative way you can use already configured Docker container with older versions of Selenium and Firefox: docker run -net=host selenium/standalone-firefox:2.53.0 (Optional) Create yii2basictest database and update it by applying migrations if you have them. Tests/bin/yii migrate The database configuration can be found at config/test.
WebDriver permet aux développeurs de créer des tests automatisés qui simulent l’interaction utilisateur.WebDriver allows developers to create automated tests that simulate user interaction.Les tests et simulations WebDriver diffèrent des tests unitaires JavaScript des manières suivantes.WebDriver tests and simulations differ from JavaScript unit tests in the following ways.
- Accède aux fonctionnalités et informations non disponibles pour JavaScript en cours d’exécution dans les navigateurs.Accesses functionality and information not available to JavaScript running in browsers.
- Simule les événements utilisateur ou au niveau du système d’exploitation plus précisément.Simulates user events or OS-level events more accurately.
- Gère plusieurs fenêtres, onglets et pages web en une seule session de test.Manages multiple windows, tabs, and webpages in a single test session.
- Exécute plusieurs sessions de Microsoft Edge sur un ordinateur spécifique.Runs multiple sessions of Microsoft Edge on a specific machine.
La section suivante décrit comment commencer avec WebDriver pour Microsoft Edge (Chromium).The following section describes how to get started with WebDriver for Microsoft Edge (Chromium).
Installer Microsoft Edge (Chromium)Install Microsoft Edge (Chromium)
Assurez-vous d’installer Microsoft Edge (Chromium).Ensure you install Microsoft Edge (Chromium).Pour confirmer que Microsoft Edge (Chromium) est installé, accédez à et vérifiez que le numéro de version est edge://settings/help
la version 75 ou ultérieure.To confirm that you have Microsoft Edge (Chromium) installed, navigate to edge://settings/help
, and verify the version number is version 75 or later.
Télécharger le pilote Microsoft EdgeDownload Microsoft Edge Driver
Pour commencer à automatiser les tests, utilisez les étapes suivantes pour vous assurer que la version WebDriver que vous installez correspond à la version de votre navigateur.To begin automating tests, use the following steps to ensure that the WebDriver version you install matches your browser version.
Pour afficher la version de Microsoft Edge, accédez à
edge://settings/help
.To display the version of Microsoft Edge, navigate toedge://settings/help
.Accédez à Pilote Microsoft Edge,sous la section Téléchargements, et téléchargez le WebDriver qui correspond au numéro de version de Microsoft Edge.Navigate to Microsoft Edge Driver, under the Downloads section, and download the WebDriver that matches the version number of Microsoft Edge.
La section Téléchargements sur le pilote Microsoft EdgeThe Downloads section on Microsoft Edge Driver
Choisir une liaison de langue WebDriverChoose a WebDriver language binding
Le dernier composant que vous devez télécharger est un pilote client propre à une langue pour traduire votre code (Python, Java, C#, Ruby, JavaScript) en commandes que le pilote Microsoft Edge exécute dans Microsoft Edge (Chromium).The last component you must download is a language-specific client driver to translate your code (Python, Java, C#, Ruby, JavaScript) into commands the Microsoft Edge Driver runs in Microsoft Edge (Chromium).
Téléchargez la liaison de langue WebDriver de votre choix.Download the WebDriver language binding of your choice.L’équipe Microsoft Edge recommande Selenium 4.00-alpha07 ou version ultérieure, car elle prend en charge Microsoft Edge (Chromium).The Microsoft Edge team recommends Selenium 4.00-alpha07 or later, because it supports Microsoft Edge (Chromium).Toutefois, vous pouvez contrôler Microsoft Edge (Chromium) dans toutes les versions antérieures de Selenium, y compris la version stable actuelle de Selenium 3.However, you may control Microsoft Edge (Chromium) in all older versions of Selenium, including the current stable Selenium 3 release.
Important
Si vous avez précédemment automatisé ou testé l’utilisation et les classes de Microsoft Edge (Chromium), votre code WebDriver ne s’exécute pas sur ChromeDriver
ChromeOptions
Microsoft Edge Version 80 ou ultérieure.If you previously automated or tested Microsoft Edge (Chromium) using ChromeDriver
and ChromeOptions
classes, your WebDriver code does not run on Microsoft Edge Version 80 or later.Pour résoudre le problème, mettez à jour vos tests pour utiliser la EdgeOptions
classe et téléchargez le pilote Microsoft Edge.To solve the problem, update your tests to use the EdgeOptions
class and download Microsoft Edge Driver.
Utiliser Selenium 3Use Selenium 3
Si vous utilisez déjà [Selenium 3,][|::ref1::|]vous avez peut-être des tests de navigateur existants et souhaitez ajouter une couverture pour Microsoft Edge (Chromium) sans modifier votre version de Selenium.If you already use [Selenium 3][|::ref1::|], you may have existing browser tests and want to add coverage for Microsoft Edge (Chromium) without changing your version of Selenium.Pour utiliser [Selenium 3][|::ref2::|] afin d’écrire des tests automatisés pour Microsoft Edge (EdgeHTML) et Microsoft Edge (Chromium), installez le package Outils Selenium pour Microsoft Edge pour utiliser le pilote mis à jour.To use [Selenium 3][|::ref2::|] to write automated tests for both Microsoft Edge (EdgeHTML) and Microsoft Edge (Chromium), install the Selenium Tools for Microsoft Edge package to use the updated driver.Les classes incluses dans les outils sont entièrement compatibles avec les EdgeDriver
EdgeDriverService
équivalents intégrés dans Selenium 4.The EdgeDriver
and EdgeDriverService
classes included in the tools are fully compatible with the built-in equivalents in Selenium 4.
Utilisez les étapes suivantes pour ajouter les outils Selenium pour Microsoft Edge et [Selenium 3][|::ref3::|] à votre projet.Use the following steps to add the Selenium Tools for Microsoft Edge and [Selenium 3][|::ref3::|] to your project.
- C#C#
- PythonPython
- JavaJava
- JavaScriptJavaScript
Ajoutez les packages Microsoft.Edge.SeleniumTools et Selenium.WebDriver à votre projet .NET à l’aide de l’CLI NuGetou Visual Studio.Add the Microsoft.Edge.SeleniumTools and Selenium.WebDriver packages to your .NET project using the NuGet CLI or Visual Studio.
Utilisez pip pour installer les packages msedge-selenium-tools et selenium.Use pip to install the msedge-selenium-tools and selenium packages.
Si votre Java utilise Maven, copiez et collez la dépendance suivante dans votre fichier pour ajouter pom.xml
msedge-selenium-tools-java.If your Java project uses Maven, copy and paste the following dependency to your pom.xml
file to add msedge-selenium-tools-java.
Le package Java est également disponible en téléchargement directement sur la page Outils Selenium pour Microsoft Edge Releases.The Java package is also available to download directly on the Selenium Tools for Microsoft Edge Releases page.
Utilisez [npm][JavaScript|::ref4::|] pour installer les packages edge-selenium-tools et selenium-webdriver.Use [npm][JavaScript|::ref4::|] to install the edge-selenium-tools and selenium-webdriver packages.
Automatiser Microsoft Edge (Chromium) avec WebDriverAutomate Microsoft Edge (Chromium) with WebDriver
Pour automatiser un navigateur à l’aide de WebDriver, vous devez d’abord démarrer une session WebDriver à l’aide de votre liaison de langue WebDriver préférée.To automate a browser using WebDriver, you must first start a WebDriver session using your preferred WebDriver language binding.Une session est une instance en cours d’exécution unique d’un navigateur contrôlée à l’aide de commandes WebDriver.A session is a single running instance of a browser controlled using WebDriver commands.Démarrez une session WebDriver pour lancer une nouvelle instance de navigateur.Start a WebDriver session to launch a new browser instance.L’instance de navigateur lancée reste ouverte jusqu’à la fermeture de la session WebDriver.The launched browser instance remains open until you close the WebDriver session.
Le contenu suivant vous aide à utiliser Selenium pour démarrer une session WebDriver avec Microsoft Edge (Chromium).The following content walks you through using Selenium to start a WebDriver session with Microsoft Edge (Chromium).Vous pouvez exécuter les exemples à l’aide de Selenium 3 ou 4.You may run the examples using either Selenium 3 or 4.Pour être utilisé avec Selenium 3, le package Outils Selenium pour Microsoft Edge doit être installé.To use with Selenium 3, the Selenium Tools for Microsoft Edge package must be installed.
Automatiser Microsoft Edge (Chromium)Automate Microsoft Edge (Chromium)
Selenium utilise la EdgeDriver
classe pour gérer une session Microsoft Edge (Chromium).Selenium uses the EdgeDriver
class to manage a Microsoft Edge (Chromium) session.Pour démarrer une session et automatiser Microsoft Edge (Chromium), créez un objet et passez-lui un objet avec la propriété EdgeDriver
EdgeOptions
définie sur UseChromium
true
.To start a session and automate Microsoft Edge (Chromium), create a new EdgeDriver
object and pass it an EdgeOptions
object with the UseChromium
property set to true
.
- C#C#
- PythonPython
- JavaJava
- JavaScriptJavaScript
La classe prend uniquement en charge Microsoft Edge (Chromium) et ne prend pas en charge EdgeDriver
Microsoft Edge (EdgeHTML).The EdgeDriver
class only supports Microsoft Edge (Chromium), and doesn't support Microsoft Edge (EdgeHTML).Pour une utilisation de base, vous pouvez créer un EdgeDriver
sans fournir EdgeOptions
.For basic usage, you may create an EdgeDriver
without providing EdgeOptions
.
Notes
Si votre administrateur informatique a définie la stratégie DeveloperToolsAvailability sur , le pilote Microsoft Edge ne peut pas conduire Microsoft Edge (Chromium), car le pilote utilise 2
Microsoft Edge DevTools.If your IT admin has set the DeveloperToolsAvailability policy to 2
, Microsoft Edge Driver is blocked from driving Microsoft Edge (Chromium), because the driver uses the Microsoft Edge DevTools.Assurez-vous que la stratégie DeveloperToolsAvailability est définie sur ou pour 0
1
automatiser Microsoft Edge (Chromium).Ensure the DeveloperToolsAvailability policy is set to 0
or 1
to automate Microsoft Edge (Chromium).
Choisir des binaires de navigateur spécifiques (chrome uniquement)Choose Specific Browser Binaries (Chromium-Only)
Vous pouvez démarrer une session WebDriver avec des binaires Microsoft Edge (Chromium) spécifiques.You may start a WebDriver session with specific Microsoft Edge (Chromium) binaries.Par exemple, vous pouvez exécuter des tests à l’aide des canaux d’aperçu De Microsoft Edge tels que Microsoft Edge Bêta.For example, you may run tests using the Microsoft Edge preview channels such as Microsoft Edge Beta.
Personnaliser le service de pilote Microsoft EdgeCustomize the Microsoft Edge Driver Service
- C#C#
- PythonPython
- JavaJava
- JavaScriptJavaScript
Lorsque vous utilisez la classe pour créer une instance de classe, elle crée et lance la classe appropriée pour EdgeOptions
EdgeDriver
Microsoft Edge EdgeDriverService
(EdgeHTML) ou Microsoft Edge (Chromium).When you use the EdgeOptions
class to create an EdgeDriver
class instance, it creates and launches the appropriate EdgeDriverService
class for either Microsoft Edge (EdgeHTML) or Microsoft Edge (Chromium).
Si vous souhaitez créer un , utilisez la méthode pour en créer une configurée pour EdgeDriverService
CreateChromiumService()
Microsoft Edge (Chromium).If you want to create an EdgeDriverService
, use the CreateChromiumService()
method to create one configured for Microsoft Edge (Chromium).La CreateChromiumService()
méthode est utile lorsque vous devez ajouter des personnalisations.The CreateChromiumService()
method is useful when you need to add customizations.Par exemple, le code suivant démarre une sortie détaillée du journal.For example, the following code starts verbose log output.
Notes
Vous n’avez pas besoin de fournir EdgeOptions
l’objet lorsque vous passez EdgeDriverService
à EdgeDriver
l’instance.You do not need to provide the EdgeOptions
object when you pass EdgeDriverService
to the EdgeDriver
instance.La classe utilise les options par défaut pour EdgeDriver
Microsoft Edge (EdgeHTML) ou Microsoft Edge (Chromium) en fonction du service que vous fournissez.The EdgeDriver
class uses the default options for either Microsoft Edge (EdgeHTML) or Microsoft Edge (Chromium) based on the service you provide.
Toutefois, si vous souhaitez fournir les deux classes, assurez-vous que les deux sont configurés pour EdgeDriverService
la même version de Microsoft EdgeOptions
Edge.However, if you want to provide both EdgeDriverService
and EdgeOptions
classes, ensure that both are configured for the same version of Microsoft Edge.Par exemple, vous pouvez utiliser une classe Microsoft Edge (EdgeHTML) par défaut et des propriétés EdgeDriverService
Chromium dans la EdgeOptions
classe.For example, you may use a default Microsoft Edge (EdgeHTML) EdgeDriverService
class and Chromium properties in the EdgeOptions
class.La EdgeDriver
classe envoie une erreur pour empêcher l’utilisation de différentes versions.The EdgeDriver
class throws an error to prevent using different versions.
Lorsque vous utilisez Python, Edge
l’objet crée et gère le EdgeService
.When you use Python, the Edge
object creates and manages the EdgeService
.Pour configurer l’objet, passez des arguments supplémentaires à l’objet, comme EdgeService
indiqué dans le code Edge
suivant.To configure the EdgeService
, pass extra arguments to the Edge
object as indicated in the following code.
Utilisez la createDefaultService()
méthode pour créer une configuration pour Microsoft Edge EdgeDriverService
(Chromium).Use the createDefaultService()
method to create an EdgeDriverService
configured for Microsoft Edge (Chromium).Utilisez Java système pour personnaliser les services de pilotes dans Java.Use Java system properties to customize driver services in Java.Par exemple, le code suivant utilise la 'webdriver.edge.verboseLogging'
propriété pour activer la sortie détaillée du journal.For example, the following code uses the 'webdriver.edge.verboseLogging'
property to turn on verbose log output.
Lorsque vous utilisez JavaScript, créez et configurez un avec Service
la ServiceBuilder
classe.When you use JavaScript, create and configure a Service
with the ServiceBuilder
class.Si vous le souhaitez, vous pouvez transmettre l’objet à l’objet, qui Service
Driver
démarre (et arrête) le service pour vous.Optionally, you may pass the Service
object to the Driver
object, which starts (and stops) the service for you.
Pour configurer la Service
méthode , exécutez une autre méthode dans la ServiceBuilder
classe avant d’utiliser la build()
méthode.To configure the Service
, run another method in the ServiceBuilder
class before you use the build()
method.Passez ensuite le service
paramètre en tant que paramètre dans la Driver.createSession()
méthode.Then pass the service
as a parameter in the Driver.createSession()
method.
Utiliser les Chromium-Specific optionsUse Chromium-Specific Options
Si vous définissez la propriété sur , vous pouvez utiliser la classe pour accéder aux mêmes propriétés et méthodes spécifiques à Chromium que lorsque vous automatisez d’autres UseChromium
true
EdgeOptions
navigateurs Chromium. If you set the UseChromium
property to true
, you may use the EdgeOptions
class to access the same Chromium-specific properties and methods that are used when you automate other Chromium browsers.
Notes
Install Chromedriver Inside Docker Container
Si la propriété est définie sur , vous ne pouvez pas utiliser les propriétés et méthodes UseChromium
true
pour Microsoft Edge (EdgeHTML).If the UseChromium
property is set to true
, you are not able to use properties and methods for Microsoft Edge (EdgeHTML).
Autres options d’installation webDriverOther WebDriver installation options
ErzyChocolatey
Si vous utilisez Contrôley comme gestionnaire de package, exécutez la commande suivante pour installer le pilote Microsoft Edge.If you use Chocolatey as your package manager, run the following command to install the Microsoft Edge Driver.
Pour plus d’informations, accédez au pilote Edge Selenium Chromium sur Le Site.For more information, navigate to Selenium Chromium Edge Driver on Chocolatey.
DockerDocker
Si vous utilisez Docker,exécutez la commande suivante pour télécharger une image pré-configurée avec Microsoft Edge (Chromium) et le pilote Microsoft Edge préinstallé.If you use Docker, run the following command to download a pre-configured image with Microsoft Edge (Chromium) and Microsoft Edge Driver pre-installed.
Install Chromedriver In Docker Container Tracking
Pour plus d’informations, accédez au conteneur msedgedriver sur Docker Hub.For more information, navigate to the msedgedriver container on Docker Hub.
Étapes suivantesNext steps
Pour en savoir plus sur WebDriver et comment écrire des tests WebDriver automatisés à l’aide de Selenium, accédez à la documentation selenium.To learn more about WebDriver and how to write automated WebDriver tests using Selenium, navigate to the Selenium documentation.
Install Chromedriver In Docker Container Box
Contacter l’équipe DevTools MicrosoftEdgeGetting in touch with the Microsoft Edge DevTools team
Install Chromedriver In Docker Containers
L’équipe Microsoft Edge est impatiente de connaître vos commentaires sur l’utilisation de WebDriver, de Selenium et de Microsoft Edge.The Microsoft Edge team is eager to hear your feedback about using WebDriver, Selenium, and Microsoft Edge.Pour envoyer à l’équipe vos **** questions et commentaires, sélectionnez l’icône Envoyer des commentaires dans Microsoft Edge DevTools ou envoyez un tweet @EdgeDevTools.To send the team your questions and comments, choose the Send Feedback icon in the Microsoft Edge DevTools or send a tweet @EdgeDevTools.