Le Projet d’Automatisation de Navigateur Selenium

Selenium est projet englobant un éventail d’outils et de librairies permettant l’automtisation des navigateurs internet.

Il fournit des extensions afin d'émuler des interactions utilisateur avec les navigateurs, un serveur de distribution permettant la mise à l'échelle de l’allocation de navigateur ainsi que l’infrastructure pour l’implémentation de la spécification W3C WebDriver permettant l'écriture de code interchangeable pour tous les principaux navigateurs.

Ce projet est rendu possible grâce au contributeurs volontaires ayant investi des milliers d’heures de leur temps et rendu le code source disponible librement à quiconque souhaitant l’utiliser et l’améliorer ou simplement s’amuser.

Selenium rassemble distributeurs de navigateur, ingénieurs et entousiastes pour favoriser une discussion ouverte autour de l’automatisation de la platerforme web. Le projet organise une conférence annuelle afin d’entretenir cette communauté.

Au coeur de Selenium se trouve WebDriver, une interface permettant d'écrire des instructions pouvant être exécutées indifférement par de nombreux navigateurs. Voici par exemple une des plus simples instructions disponibles:

Java Python C# Ruby JavaScript Kotlin


import org.openqa.selenium.By;
import org.openqa.selenium.Keys;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.WebElement;
import org.openqa.selenium.firefox.FirefoxDriver;
import org.openqa.selenium.support.ui.WebDriverWait;
import static org.openqa.selenium.support.ui.ExpectedConditions.presenceOfElementLocated;
import java.time.Duration;

public class HelloSelenium {

    public static void main(String[] args) {
        WebDriver driver = new FirefoxDriver();
        WebDriverWait wait = new WebDriverWait(driver, Duration.ofSeconds(10));
        try {
            driver.get("https://google.com/ncr");
            driver.findElement(By.name("q")).sendKeys("cheese" + Keys.ENTER);
            WebElement firstResult = wait.until(presenceOfElementLocated(By.cssSelector("h3>div")));
            System.out.println(firstResult.getAttribute("textContent"));
        } finally {
            driver.quit();
        }
    }
}


from selenium import webdriver
from selenium.webdriver.common.by import By
from selenium.webdriver.common.keys import Keys
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support.expected_conditions import presence_of_element_located

#This example requires Selenium WebDriver 3.13 or newer
with webdriver.Firefox() as driver:
    wait = WebDriverWait(driver, 10)
    driver.get("https://google.com/ncr")
    driver.find_element(By.NAME, "q").send_keys("cheese" + Keys.RETURN)
    first_result = wait.until(presence_of_element_located((By.CSS_SELECTOR, "h3>div")))
    print(first_result.get_attribute("textContent"))


using System;
using OpenQA.Selenium;
using OpenQA.Selenium.Firefox;
using OpenQA.Selenium.Support.UI;

class HelloSelenium {
  static void Main() {
    using(IWebDriver driver = new FirefoxDriver()) {
      WebDriverWait wait = new WebDriverWait(driver, TimeSpan.FromSeconds(10));
      driver.Navigate().GoToUrl("https://www.google.com/ncr");
      driver.FindElement(By.Name("q")).SendKeys("cheese" + Keys.Enter);
      wait.Until(driver =>driver.FindElement(By.CssSelector("h3>div")).Displayed);
      IWebElement firstResult = driver.FindElement(By.CssSelector("h3>div"));
      Console.WriteLine(firstResult.GetAttribute("textContent"));
    }
  }
}


require 'selenium-webdriver'

driver = Selenium::WebDriver.for :firefox
wait = Selenium::WebDriver::Wait.new(timeout: 10)

begin
  driver.get 'https://google.com/ncr'
  driver.find_element(name: 'q').send_keys 'cheese', :return
  first_result = wait.until { driver.find_element(css: 'h3>div') }
  puts first_result.attribute('textContent')
ensure
  driver.quit
end


const {Builder, By, Key, until} = require('selenium-webdriver');

(async function example() {
    let driver = await new Builder().forBrowser('firefox').build();
    try {
        // Navigate to Url
        await driver.get('https://www.google.com');

        // Enter text "cheese" and perform keyboard action "Enter"
        await driver.findElement(By.name('q')).sendKeys('cheese', Key.ENTER);

        let firstResult = await driver.wait(until.elementLocated(By.css('h3>div')), 10000);

        console.log(await firstResult.getAttribute('textContent'));
    }
    finally{
        driver.quit();
    }
})();


import org.openqa.selenium.By
import org.openqa.selenium.Keys
import org.openqa.selenium.firefox.FirefoxDriver
import org.openqa.selenium.support.ui.ExpectedConditions.presenceOfElementLocated
import org.openqa.selenium.support.ui.WebDriverWait
import java.time.Duration

fun main() {
    val driver = FirefoxDriver()
    val wait = WebDriverWait(driver, Duration.ofSeconds(10))
    try {
        driver.get("https://google.com/ncr")
        driver.findElement(By.name("q")).sendKeys("cheese" + Keys.ENTER)
        val firstResult = wait.until(presenceOfElementLocated(By.cssSelector("h3>div")))
        println(firstResult.getAttribute("textContent"))
    } finally {
        driver.quit()
    }
}

Suivez le Quick Tour pour une explication complète de ce qu’il se passe derrière ces exemples de code. Il est conseillé de poursuivre cette documentation narrative afin de voir comment installer et utiliser Selenium en tant qu’outil d’automatisation de test, ainsi que pour mettre à l’echelle l’exécution de tels tests sur de larges environnements distribués, avec de multiples navigateurs et des systèmes d’exploitation différents.

Getting started

Si Selenium est nouveau pour vous, nous vous proposons quelques ressources qui pourront vous aider à vous mettre à niveau très rapidement.

Tour rapide