Методы

Методы языка Testoid

acceptAlert

Нажимает на кнопку "ok" в alert

Возвращаемые значения
отсутствуют

Пример

acceptAlert();

assertCountElementsEquals

Проверяет, что количество элементов равно count

Список параметров
element — элемент
count — количество дочерних элементов

Возвращаемые значения
отсутствуют

Пример

// Количество карточек равно 1
assertCountElementsEquals(xpath("//a[contains(@class, \"horizontal-filters__link_active\")]"), "1");

assertCountElementsGreater

Проверяет, что количество элементов больше count

Список параметров
element — элемент
count — количество дочерних элементов

Возвращаемые значения
отсутствуют

Пример

// Количество карточек больше 3
assertCountElementsGreater(xpath(collection_card), "3");

assertCountElementsLess

Проверяет, что количество элементов меньше count

Список параметров
element — элемент
count — количество дочерних элементов

Возвращаемые значения
отсутствуют

Пример

assertCountElementsLess(xpath("//a[contains(@class, \"horizontal-filters__link_active\")]"), 1);

assertValuesEquals

Проверяет, что value1 равно value2

Список параметров
value1, value2 — два значения

Возвращаемые значения
отсутствуют

Пример

assertValuesEquals(smaller_value, current_value);

assertValuesGreater

Проверяет, что value1 больше value2

Список параметров
value1, value2 — два значения

Возвращаемые значения
отсутствуют

Пример

assertValuesGreater(unread_mes_count, 1);

assertValuesGreaterOrEquals

Проверяет, что value1 больше или равно value2

Список параметров
value1, value2 — два значения

Возвращаемые значения
отсутствуют

Пример

assertValuesGreaterOrEquals(unread_mes_count, 1);

assertValuesLess

Проверяет, что value1 меньше value2

Список параметров
value1, value2 — два значения

Возвращаемые значения
отсутствуют

Пример

assertValuesLess("//span[@class='value']", 1000);

assertValuesLessOrEquals

Проверяет, что value1 меньше или равно value2

Список параметров
value1, value2 — два значения

Возвращаемые значения
отсутствуют

Пример

assertValuesLessOrEquals("//span[@class='value']", "1000");

assertValuesNotEquals

Проверяет, что value1 и value2 не равны

Список параметров
value1, value2 — два значения

Возвращаемые значения
отсутствуют

Пример

Value поля "До" не  содержит текст
assertValuesNotEquals(text_value, current_value);

changeSelect

Выбирает в элементе <select> значение value

Список параметров
element — элемент
value — значение элемента

Возвращаемые значения
отсутствуют

Пример

changeSelect(xpath("//select[@name=\"answer\"]"), "Кострома");

click

Нажать на элемент element

Список параметров
element — элемент

Возвращаемые значения
отсутствуют

Пример

element = xpath("//*[@id=\"button\"]")
click(element);

confirm

Выбор значения в confirm

Список параметров
value — значение в confirm, true — ok, false - cancel

Возвращаемые значения
отсутствуют

Пример

confirm(true);

downloadFile

Скачать файл

Список параметров
element — элемент

Возвращаемые значения
filename - имя файла

Пример

filename = downloadFile(xpath("//a"));

elementIsNotPresent

Проверяет, что элемента нет на странице

Список параметров
element — элемент

Возвращаемые значения
отсутствуют

Пример

elementIsNotPresent(xpath("//div[@class=\"b-lk-order-row__col\"]"));

elementIsNotVisible

Проверяет, что элемент не виден на странице

Список параметров
element — элемент

Возвращаемые значения
отсутствуют

Пример

elementIsNotVisible(xpath("//form[@id=\"login-form\"]"));

elementIsPresent

Проверка, что элемент есть на странице

Список параметров
element — элемент

Возвращаемые значения
отсутствуют

Пример

element = xpath("//*[@id=\"text\"]");
elementIsPresent(element);

elementIsVisible

Проверка, что элемент виден на странице

Список параметров
element — элемент

Возвращаемые значения
отсутствуют

Пример

elementIsVisible(xpath("//span[contains(text(),'В сравнение')]"));

elementTextContain

Проверка, что элемент содержит текст

Список параметров
element — элемент
text — текст для сравнения

Возвращаемые значения
отсутствуют

Пример

elementTextContain(xpath("//span[contains(text(),'В сравнение')]"));
Элемент должен быть виден

elementTextEqual

Проверка, что текст в element равен text

Список параметров
element — элемент
text — текст для сравнения

Возвращаемые значения
отсутствуют

Пример

elementTextEqual(xpath("//div[@class=\"b-order-table__variations-name\"]"), front_color);

elementTextNotContain

Проверка, что element не содержит text

Список параметров
element — элемент
text — текст для сравнения

Возвращаемые значения
отсутствуют

Пример

elementTextNotContain(xpath("//div[@class=\"body—price\"]"), viewed_price);

elementTextNotEmpty

Проверка, что текст в element не пустой

Список параметров
element — элемент

Возвращаемые значения
отсутствуют

Пример

elementTextNotEmpty(xpath("//div[@class=\"p-order-b-order-info—row\"][2]/div[2]"));

elementTextNotEqual

Проверка, что text в element не равен text

Список параметров
element — элемент
text — текст для сравнения

Возвращаемые значения
отсутствуют

Пример

elementTextNotEqual(xpath("//span[@id='vstov5']"), "3 000");

executeDeferredTest

Запустить отложенный тест

Список параметров
testId — id теста, строка после id игнорируется. строка "1-unit" интерпретируется в значение 1
time — время через которое будет запущен тест в формате "hh:mm"

Возвращаемые значения
отсутствуют

Пример
Запустить тест c id=1 через 45 минут.

executeDeferredTest("1-Unit тесты. Проверка в браузере v3", "00:45");

executeJs

Выполнить javascript в запущенном браузере. Чтобы функция вернула значение javascript должен содержать return.

Список параметров
javascript — текст программы.

Возвращаемые значения
отсутствуют

Пример

valueOfFloor = executeJs("return Math.floor(1.5)");

executeTest

Запустить тест

Список параметров
testId — id теста, строка после id игнорируется. строка "1-unit" интерпретируется в значение 1

Возвращаемые значения
отсутствуют

Пример

executeTest("13123-Выбор случайного продукта с ценой на странице категории");

executeTestForElements

Запустить тест для дочерних элементов

Список параметров
element - родительский элемент
testId — id теста, строка после id игнорируется. строка "1-unit" интерпретируется в значение 1

Возвращаемые значения
отсутствуют

Пример

executeTestForElements(xpath("//div[@class=\"b-order-table__items\"]"), "13233-Удаление из корзины"));

getCookie

Получить все cookies в текущей сессии браузера

Список параметров
отсутствуют

Возвращаемые значения
cookies - массив

Пример

cookie = getCookie();

h1Contains

Проверяет, что на странице есть тег h1 и содержит text

Список параметров
text - текст которые должен содержать тег h1

Возвращаемые значения
отсутствуют

Пример

h1Contains("Все пансионаты для пожилых людей в Голицыно");

inputText

Ввести текст. Текст в поле полностью заменяется

Список параметров
element - элемент страницы
text - текст

Возвращаемые значения
отсутствуют

Пример
Ввести в элемент element текст Проверка ввода

element = xpath("//*[@id=\"text\"]");
inputText(element, "Проверка ввода");

inputTextToExistValue

Ввести текст. Существующий текст в поле не удаляется

Список параметров
element - элемент страницы
text - текст

Возвращаемые значения
отсутствуют

Пример
Ввести в элемент element текст +79112223344

element = xpath("//input[@type=\"tel\"]", "+79112223344")
inputTextToExistValue(element);

jsReturnTrue

Выполнить javascript в запущенном браузере. Javascript должен содержать return

Список параметров
javascript — текст программы.

Возвращаемые значения
отсутствуют

Пример

jsReturnTrue("return 1 == 1");

metaDescriptionContains

Проверяет, что на странице есть тег <meta name="description"> и content равен text

Список параметров
text - текст которые должен содержать content тега meta

Возвращаемые значения
отсутствуют

Пример

metaDescriptionContains("Москве и Московской области");

metaKeywordsContains

Проверяет, что на странице есть тег и content равен text

Список параметров
text - текст которые должен содержать content тега meta

Возвращаемые значения
отсутствуют

Пример

metaKeywordsContains("дом престарелых, пансионат для пожилых");

mouseToElement

Навести курсор мыши на элемент element

Список параметров
element — элемент

Возвращаемые значения
отсутствуют

Пример

element = xpath("//*[@id=\"button\"]")
mouseToElement(element);

Перейти на страницу

Список параметров
url — адрес страницы. Url должен содержать протокол, например: https://

Возвращаемые значения
отсутствуют

Пример

navigate("https://testoid.io/");

Загрузить предыдущий url из списка истории браузера. Это тоже самое, что нажать кнопку "назад" в браузере

Список параметров
отсутствует

Возвращаемые значения
отсутствуют

Пример

navigateBack();

Загрузить следующий url из списка истории браузера. Это тоже самое, что нажать кнопку "вперед" в браузере

Список параметров
отсутствует

Возвращаемые значения
отсутствуют

Пример

navigateForward();

pressKey

Нажатие клавиши.

Список параметров
key - Клавиша. Допустимые значения key: "enter", "escape", "tab" element - Элемент. Необязательный параметр. Если не задан, то нажатие происходит на body.

Возвращаемые значения
отсутствуют

Пример

element = xpath("//*[@id=\"button\"]");
pressKey("tab", element);

Если отсутствует element, то нажатие производится на элемент body

refresh

Перезагрузить страницу

Список параметров
отсутствует

Возвращаемые значения
отсутствуют

Пример

refresh();

setVariableFromElement

Вернуть значение атрибута у элемента

Список параметров
element - Элемент страницы attribute - Атрибут элемента

Возвращаемые значения
значение атрибута - строка

Пример

book_id = setVariableFromElement(xpath("//a/" + random_button), "data-book-id");

setVariableFromJs

Вернуть результат выполнения javascript.

Список параметров
javascript - Текст программы. Должен содержать return.

Возвращаемые значения
результат работы javascript - строка

Пример

var = setVariableFromJs("return Math.round(1.12)");

setVariableFromSmsWithText

Получить текст sms

Список параметров
phone - номер телефона на который должна прийти СМС. Номер выдается при регистрации text - текст который должен содержаться в СМС

Возвращаемые значения
sms - строка

Пример

sms = setVariableFromSmsWithText("+79587629592", "Ваш пароль:");

setVariableRandElement

Получить порядковый номер случайного, дочернего элемента

Список параметров
element — родительский элемент

Возвращаемые значения id - число

Пример

rand_cat = setVariableRandElement(xpath("//div[@class=\"popular-category\" and position() >13]"));

switchToFrame

Переключиться во фрейм

Список параметров
element — элемент фрейма

Возвращаемые значения
отсутствуют

Пример

switchToFrame(xpath("//iframe[@src=\"" + video_url + "\"]"));

titleContains

Проверяет, что на странице есть тег title и тег содержит text

Список параметров
text — текст который должен содержать тег title

Возвращаемые значения
отсутствуют

Пример

titleContains("Пансионаты для пожилых людей");

uploadFile

Загрузить файл

Список параметров
element — элемент тега input filename - имя файла, который загружен через функцию downloadFile

Возвращаемые значения
отсутствуют

Пример

uploadFile(xpath("//input[@name=\"sf_file\"]"), filename);

urlContains

Проверяет, что URL страницы содержит text

Список параметров
text — текст который должен содержать URL

Возвращаемые значения
отсутствуют

Пример

urlContains("[filters][categories][]=" + filter_id);

urlEqual

Проверяет, что URL страницы равен text

Список параметров
text — текст которому должен равен URL

Возвращаемые значения
отсутствуют

Пример

urlEqual("https://m.chitai-gorod.ru/actions/");