Thucydides — открытие страницы

Для работы со страницей Thucydides предоставляет класс PageObject, от которого должны быть унаследованы все Ваши страницы в проекте. В качестве своеобразной фабрики страниц выступает класс Pages, который играет роль кеша и содержит методы для доступа и создания страниц.

Как получить страницу

Для того, чтобы получить объект страницы внутри библиотеки шагов нужно обратиться к фабрике страниц и запросить необходимый Вам класс:

LoginPage page = getPages().get(LoginPage.class);

Этот метод сам по себе всегда будет создавать новый экземпляр страницы. Возвращаемая страница при этом помещается в кеш. Для того чтобы не создавать объект страницы по-новой, если Вы итак уже находитесь на ней, можно обратиться к кешу и попытаться получить доступ к странице из него:

LoginPage page = getPages().onSamePage().get(LoginPage.class);

Если последняя созданная страница совпадает по классу с запрашиваемой, то вернется текущий объект страницы, если нет, то создаться новый.

Третий способ получения страницы позволяет не только получить экземпляр страницы, но и проверить текущий URL в браузере:

LoginPage page = getPages().currentPageAt(LoginPage.class);

Проверка URL проходит основываясь на URL паттерне определенном в аннотации @At в PageObject:

@At("http://www.site.org/login")
public class LoginPage extends PageObject {
    ...
}

@At поддерживает также использование регулярных выражений и шаблонов, игнорирует наличие параметров в URL и позволяет задать несколько url-ов для сравнения. Например,

// #HOST любой адрес сервера
// любые символы после index
@At("#HOST/catalog/index.*")
public class CatalogItemPage extends PageObject {
    ...
}

// одна страница для создания и редактирования
@At(urls = {
		"#HOST/catalog/item/create", 
		"#HOST/catalog/item/edit.*" 
		})
public class CatalogItemPage extends PageObject {
    ...
}

// одна страница для создания и редактирования
@At("#HOST/catalog/item/(create|edit.*)")
public class CatalogItemPage extends PageObject {
    ...
}

Если при проверке URL не совпадает с приведенным в аннотации, то Thucydides генерирует исключение WrongPageError и тест завершается неудачей. Аннотация @At не является обязательной и может быть опущена, тогда проверка просто не будет выполняться.

Как открыть страницу

Для того, чтобы открыть страницу в браузере используется метод open().
Объекты страниц, как правило, предназначены для работы с определенными веб-страницами. При вызове метода open() браузер будет открыт по URL-у, представленному в аннотации @DefaultUrl.

@DefaultUrl("http://www.site.org/login")
public class LoginPage extends PageObject {
    ...
}

Однако в целом, HOST-часть в @DefaultUrl всегда будет переопределяться свойством webdriver.base.url. Это позволяет установить базовый URL повсеместно для всех Ваших тестов, и упрощает запуск тестов на различных серверах простым изменением значения этого свойства. Например, в примере выше, установка webdriver.base.url в http://yandex.ru приведет к открытию страницы по адресу http://yandex.ru/login.

Пример метода в библиотеке шагов для получения объекта страницы и открытия URL только в том случае, если Вы находитесь на другой странице:

/**
 * Открыть страницу. Проверка текущей страницы:
 * если находимся на другой странице, 
 * то открываем необходимую
 * 
 * @param pageObjectClass - класс страницы PageObject
 * @return T extends {@link PageObject}
 */
public  T open(final Class pageObjectClass) {
	T page = null;
	try {
		page = getPages().onSamePage().currentPageAt(pageObjectClass);
	} catch (WrongPageError e) {
		page = getPages().get(pageObjectClass);
		page.open();
	}
	return page;
}

Страницу также можно открывать с передачей параметров с помощью метода open(final String... parameterValues), параметры в URL должны быть представлены в виде {1},{2} и т.д.

@DefaultUrl("/catalog/item/edit/{1}")
public class CatalogItemPage extends PageObject {
    ...
}

Вызов происходит следующим образом:

catalogPage.open("123374");

Вы также можете определить имена URL-адресов, которые могут быть использованы для открытия веб-страницы:

@DefaultUrl("/catalog/item/{1}")
@NamedUrls(
		  {
		    @NamedUrl(name = "create", url = "/catalog/item/create"),
		    @NamedUrl(name = "edit", url = "/catalog/item/edit/{1}"),
		  }
		)
public class CatalogItemPage extends PageObject {
    ...
}

catalogPage.open("edit", new String[] {"123374"});

Если Вам нужно, чтобы страница выполняла какие-то действия во время загрузки, например, дожидалась появления какого-либо динамического элемента, используйте аннотацию @WhenPageOpens. Методы в PageObject, помеченные этой аннотацией, будут вызваны (в произвольном порядке) после того как URL был открыт.

@DefaultUrl("/catalog/list}")
public class CatalogListPage extends PageObject {
	
	@FindBy(id="items-list");
	WebElement list;

	@WhenPageOpens
	public void waitUntilListLoaded() {
		element(list).waitUntilVisible();
	}
}