Testy funkcjonalne w Selenium

Budowanie aplikacje przy wykorzystaniu TDD ( ang. Test Drivent Development) staje się nie tyle coraz popularniejsze, co wygodne (zwłaszcza przy dużych projektach), bowiem pozwala wyeliminować wiele błędów, które pojawiłyby się przy pominięciu tworzenia testów jednostkowych i funkcjonalnych budowanych aplikacji. Książka, które niezwykle ciekawie przedstawia proces TDD w praktyce jest Test-Driven Development with Python, w której na przykładzie języka Python oraz framework’a Django autor pokazał jak tworzyć testy jednostkowe oraz testy funkcjonalne w Selenium.

Przykłady omawiane w książce dostępne są w GitHub, które można pobrać i wykorzystać do nauki nie tylko samego Django i Python’a, ale przede wszystkim podejścia TDD i testów w Selenium. Poniżej przedstawiony został przykładowy test w Selenium wraz z komentarzami zbudowany właśnie na podstawie lektury wspomnianej książki.

from django.contrib.staticfiles.testing import StaticLiveServerTestCase
from selenium import webdriver
from selenium.webdriver.common.keys import Keys

class NewVisitorTest(StaticLiveServerTestCase):

    def setUp(self):
        # wykorzystanie sterownika dla Chrome (wcześniej pobranego i umieszczonego w odpowiednim katalogu)
        self.browser = webdriver.Chrome('/Users/seba/Projects/python/drivers/chromedriver')
        # odczekanie 3 sekund po uruchomieniu przeglądarki w celu całkowitego załadownia strony
        self.browser.implicitly_wait(3)

    def tearDown(self):
        # zamknięcie przeglądarki
        self.browser.quit()

    def check_for_row_in_list_table(self, row_text):
        # pobranie tabeli
        table = self.browser.find_element_by_id('id_list_table')
        # pobranie wierszy z tabeli
        rows = table.find_elements_by_tag_name('tr')
        # sprawdzenie czy w którymś z wierszy znajduje się poszukiwany fragment tekstu
        self.assertIn(row_text, [row.text for row in rows])

    def test_can_start_a_list_and_retrieve_it_later(self):
        # uruchomienie w przeglądarce adresu URL, pod którym dostępna jest testowana aplikacja
        self.browser.get(self.live_server_url)

        # sprawdzenie, czy w tytule strony oraz nagłówku h1 jest nazwa aplikacji 'To-Do'
        self.assertIn('To-Do', self.browser.title)
        header_text = self.browser.find_element_by_tag_name('h1').text
        self.assertIn('To-Do', header_text)

        # znalezienie na wyświetlonej stronie elementu o identyfikatorze 'id_new_item'
        inputbox = self.browser.find_element_by_id('id_new_item')
        self.assertEqual(
                inputbox.get_attribute('placeholder'),
                'Wpisz zadanie'
        )

        # wpisanie w polu tekstowym wartości 'sprzatanie mieszkania'
        inputbox.send_keys('sprzatanie mieszkania')

        # wciśniecię klawisza ENTER by zakończyć wprowadzanie nowego zadania
        inputbox.send_keys(Keys.ENTER)

        # sprawdzenie, czy nowy adres URL zawiera słowo 'lists'
        user1_list_url = self.browser.current_url
        self.assertRegex(edith_list_url, '/lists/.+')

        # sprawdzenie czy w liście zadań jest dodane 'sprzatanie mieszkania'
        self.check_for_row_in_list_table('1: sprzatanie mieszkania')

        # dodanie kolejnego zadania 'zrob zakupy'
        inputbox = self.browser.find_element_by_id('id_new_item')
        inputbox.send_keys('zrob zakupy')
        inputbox.send_keys(Keys.ENTER)

        # sprawdzenie czy oba zadania są wyświetlane na stronie
        self.check_for_row_in_list_table('2: zrob zakupy')
        self.check_for_row_in_list_table('1: sprzatanie mieszkania')

        # zamknięcie przeglądarki wraz z sesją użytkownika, który dodał 2 zadania
        self.browser.quit()

        # ponowne uruchomienie przeglądarki
        self.browser = webdriver.Chrome('/Users/seba/Projects/python/drivers/chromedriver')

        # ponowne uruchomienie witryny z testowaną aplikacją
        self.browser.get(self.live_server_url)

        # sprawdzenie czy zadania dodane przez inne użytkownika nie są wyświetlane
        page_text = self.browser.find_element_by_tag_name('body').text
        self.assertNotIn('zrob zakupy', page_text)
        self.assertNotIn('sprzatanie mieszkania', page_text)

        # dodanie pierwszego zadania przez innego użytkownika
        inputbox = self.browser.find_element_by_id('id_new_item')
        inputbox.send_keys('mycie samochodu')
        inputbox.send_keys(Keys.ENTER)

        # sprawdzenie, czy nowy adres URL zawiera słowo 'lists'
        user2_list_url = self.browser.current_url
        self.assertRegex(francis_list_url, '/lists/.+')

        # sprawdzenie czy URL listy 1 i 2 użytkownika są różne
        self.assertNotEqual(user1_list_url, user2_list_url)

        # sprawdzenie czy zadanie 1 użytkownika nie są widoczne, a 2 użytkownika - są wyświetlane
        page_text = self.browser.find_element_by_tag_name('body').text
        self.assertNotIn('zrob zakupy', page_text)
        self.assertIn('mycie samochodu', page_text)