Объясни код, не могу понять логику теста, которую сам же и написал: test('Операционная…
- User
Объясни код, не могу понять логику теста, которую сам же и написал: test('Операционная система', async() => {
test.setTimeout(200 * 1000) // Получаем из API все данные по ОС const api = 'https://api.selectel.ru/servers/v2/pub/boot/template/os/new' const responseServer = await page.request.fetch(api) const dataServer = await responseServer.json() // читаем ответ в формате JSON const server = dataServer.result // Формируем массив из полученных данных в формате: ОС - имя и версия, uuid ОС const dataServersObject = [] for(const item of server) { const uuid = item.uuid const os_name = item.os_name const version_name = item.version_name.replace(' ', ' ') dataServersObject.push({ selected_OS: `${os_name} ${version_name}`, uuid: uuid }) } // Нажать на селектор ОС, получить все доступные ОС await page.locator(LOCATORS.os).click() const listOS = page.locator(LOCATORS.itemActiveSelector) const itemActiveSelectorCount = await listOS.count() // Взять все названия доступных ОС const allNameOs = await listOS.allInnerTexts() // Создаем объект Set для уникальных значений const uniqueNames = new Set(allNameOs) // Найти дубликаты const duplicates = allNameOs.filter((item, index) => allNameOs.indexOf(item) !== index) expect(uniqueNames.size, `${duplicates}`).toBe(allNameOs.length) // Закрыть селектор ОС await page.locator(LOCATORS.os).click() // Пройтись по каждой ОС, найти в массиве dataServersObject uuid ОС, получить список всех исключенных серверов for(let i = 1; i < itemActiveSelectorCount; i++){ await dedicatedServersPage.choiceValueCombobox(LOCATORS.os,LOCATORS.itemActiveSelector,i) const titleOs = await page.locator(LOCATORS.os).locator('[title]').innerText() const foundServer = dataServersObject.find(item => item.selected_OS === titleOs) const foundServerCount = dataServersObject.filter(item => item.selected_OS === titleOs) // console.log(foundServer) let excluded_services:string[] if (foundServer) { const filteredServer = dataServer.result.filter(server => server.uuid === foundServer.uuid) // Извлекаем значения id и service_uuid из отфильтрованного сервера const server = filteredServer[0] excluded_services = server.excluded_services } const hrefArray = [] // Получить все UUID из списка серверов на странице сайта const hrefCard = page.locator(LOCATORS.serverCardName).locator('a') // console.log(hrefCard) for(let i = 0; i < await hrefCard.count(); i++) { const href = await hrefCard.nth(i).getAttribute('href') const uuid = href.replace(/\/services\/dedicated\/config\/\?uuid=/g, '') hrefArray.push(uuid) } // Проверка на отсутсвие uuid с сайта в массиве с API excluded_services if(!titleOs.includes('Ubuntu')) { for(const checkOS of hrefArray) { expect.soft(excluded_services, `${titleOs}`).not.toContain(checkOS) } if(titleOs.includes('Oracle 8') || titleOs.includes('Rocky 9')) { expect.soft(foundServerCount.length, `${titleOs}`).toBeGreaterThan(1) }else{ expect.soft(foundServerCount.length, `${titleOs}`).toBe(1) } }else{ expect.soft(foundServerCount.length, `${titleOs}`).toBeGreaterThan(1) } } // Сбросить фильтры await page.locator(LOCATORS.resetFilterChips).click()})
- Assistant
Конечно! Давайте подробно разберём ваш тестовый скрипт, чтобы понять его логику и назначение. Ваш тест написан на языке JavaScript (или TypeScript) с использованием фреймворка тестирования, вероятно, Playwright или Jest с поддержкой асинхронных операций. Тест называется «Операционная система» и предназначен для проверки корректности отображения операционных систем (ОС) на веб-странице, сравнивая данные страницы с данными, полученными из API.
Вот пошаговое объяснение кода:
1. Назначение теста
Название теста: 'Операционная система'
Цель: Проверить, что список операционных систем на веб-странице соответствует данным из API, няма дубликатов, а также проверить наличие или отсутствие определённых сервисов для каждой ОС.2. Установка таймаута для теста
test.setTimeout(200 * 1000)Описание: Устанавливает максимальное время выполнения теста в 200 секунд (200 000 миллисекунд). Это делается для того, чтобы тест успел выполнить все асинхронные операции без прерывания из-за превышения времени ожидания.
3. Получение данных ОС из API
const api = 'https://api.selectel.ru/servers/v2/pub/boot/template/os/new' const responseServer = await page.request.fetch(api) const dataServer = await responseServer.json() // читаем ответ в формате JSON const server = dataServer.resultОписание:
- URL API:
'https://api.selectel.ru/servers/v2/pub/boot/template/os/new'– это адрес, с которого получаются данные об операционных системах. - Получение ответа:
page.request.fetch(api)отправляет HTTP-запрос к API и получает ответ. - Парсинг JSON:
await responseServer.json()преобразует ответ в формат JSON. - Извлечение данных:
dataServer.resultсодержит массив объектов с информацией об ОС.
4. Формирование массива объектов с необходимыми данными об ОС
const dataServersObject = [] for(const item of server) { const uuid = item.uuid const os_name = item.os_name const version_name = item.version_name.replace(' ', ' ') dataServersObject.push({ selected_OS: `${os_name} ${version_name}`, uuid: uuid }) }Описание:
- Инициализация массива:
dataServersObjectбудет содержать объекты с именами и UUID ОС. - Цикл по элементам данных: Для каждого объекта
itemизserver:- Извлекаются
uuid,os_nameиversion_name. - Убираются двойные пробелы в
version_nameс помощьюreplace. - Создаётся объект с ключами
selected_OS(сочетание имени и версии ОС) иuuid, который добавляется вdataServersObject.
- Извлекаются
Пример результата:
[ { selected_OS: "Ubuntu 20.04", uuid: "some-uuid-1" }, { selected_OS: "CentOS 7", uuid: "some-uuid-2" }, // ... другие ОС ]5. Взаимодействие с веб-страницей для получения списка доступных ОС
await page.locator(LOCATORS.os).click() const listOS = page.locator(LOCATORS.itemActiveSelector) const itemActiveSelectorCount = await listOS.count()Описание:
- Открытие селектора ОС: Клик по элементу, который отвечает за выбор ОС (
LOCATORS.os), чтобы открыть выпадающий список или селектор. - Получение списка ОС:
page.locator(LOCATORS.itemActiveSelector)находит все активные элементы в селекторе ОС. - Подсчёт количества ОС:
await listOS.count()возвращает количество доступных ОС в списке.
6. Получение имен всех доступных ОС и проверка на дубликаты
const allNameOs = await listOS.allInnerTexts() // Создаем объект Set для уникальных значений const uniqueNames = new Set(allNameOs) // Найти дубликаты const duplicates = allNameOs.filter((item, index) => allNameOs.indexOf(item) !== index) expect(uniqueNames.size, `${duplicates}`).toBe(allNameOs.length)Описание:
- Получение имен ОС:
await listOS.allInnerTexts()собирает текстовое содержимое всех элементов списка ОС. - Проверка уникальности:
- Создаётся
SetизallNameOs, который автоматически удаляет дубликаты. duplicatesсодержит элементы, которые встречаются более одного раза.- Ассерция: Проверяется, что количество уникальных имён (
uniqueNames.size) равно общему количеству элементов (allNameOs.length). Если есть дубликаты, тест упадёт с сообщением, содержащим дублирующиеся имена.
- Создаётся
Цель: Убедиться, что в селекторе ОС нет повторяющихся элементов.
7. Закрытие селектора ОС
await page.locator(LOCATORS.os).click()Описание: Клик по элементу выбора ОС ещё раз, чтобы закрыть выпадающий список или селектор.
8. Проверка каждой ОС на соответствие данным из API и наличие/отсутствие исключённых сервисов
for(let i = 1; i < itemActiveSelectorCount; i++){ await dedicatedServersPage.choiceValueCombobox(LOCATORS.os,LOCATORS.itemActiveSelector,i) const titleOs = await page.locator(LOCATORS.os).locator('[title]').innerText() const foundServer = dataServersObject.find(item => item.selected_OS === titleOs) const foundServerCount = dataServersObject.filter(item => item.selected_OS === titleOs) let excluded_services:string[] if (foundServer) { const filteredServer = dataServer.result.filter(server => server.uuid === foundServer.uuid) // Извлекаем значение excluded_services из отфильтрованного сервера const server = filteredServer[0] excluded_services = server.excluded_services } const hrefArray = [] // Получить все UUID из списка серверов на странице сайта const hrefCard = page.locator(LOCATORS.serverCardName).locator('a') for(let i = 0; i < await hrefCard.count(); i++) { const href = await hrefCard.nth(i).getAttribute('href') const uuid = href.replace(/\/services\/dedicated\/config\/\?uuid=/g, '') hrefArray.push(uuid) } // Проверка на отсутсвие uuid с сайта в массиве с API excluded_services if(!titleOs.includes('Ubuntu')) { for(const checkOS of hrefArray) { expect.soft(excluded_services, `${titleOs}`).not.toContain(checkOS) } if(titleOs.includes('Oracle 8') || titleOs.includes('Rocky 9')) { expect.soft(foundServerCount.length, `${titleOs}`).toBeGreaterThan(1) } else { expect.soft(foundServerCount.length, `${titleOs}`).toBe(1) } } else { expect.soft(foundServerCount.length, `${titleOs}`).toBeGreaterThan(1) } }Описание:
-
Цикл по каждой ОС:
- Начало цикла:
for(let i = 1; i < itemActiveSelectorCount; i++)– цикл начинается сi = 1, возможно, чтобы пропустить первый элемент (необходимо проверить, является ли это намеренным).
- Начало цикла:
-
Выбор ОС в селекторе:
await dedicatedServersPage.choiceValueCombobox(LOCATORS.os,LOCATORS.itemActiveSelector,i)Описание: Выбирает ОС по индексу
iв комбобоксе или селекторе. МетодchoiceValueComboboxскорее всего кликает по определённому пункту списка. -
Получение названия выбранной ОС:
const titleOs = await page.locator(LOCATORS.os).locator('[title]').innerText()Описание: Извлекает текст выбранной ОС, находя элемент с атрибутом
titleвнутри селектора ОС. -
Поиск соответствующей ОС в данных из API:
const foundServer = dataServersObject.find(item => item.selected_OS === titleOs) const foundServerCount = dataServersObject.filter(item => item.selected_OS === titleOs)Описание:
foundServerсодержит первый объект изdataServersObject, гдеselected_OSсовпадает сtitleOs.foundServerCountсодержит все объекты изdataServersObject, гдеselected_OSсовпадает сtitleOs(для проверки количества таких объектов).
-
Получение списка исключённых сервисов:
let excluded_services:string[] if (foundServer) { const filteredServer = dataServer.result.filter(server => server.uuid === foundServer.uuid) const server = filteredServer[0] excluded_services = server.excluded_services }Описание: Если соответствующая ОС найдена в
dataServersObject, фильтрует исходные данные из API поuuidи извлекает массивexcluded_services, который содержит UUID сервисов, исключённых для этой ОС. -
Сбор UUID из страницы:
const hrefArray = [] const hrefCard = page.locator(LOCATORS.serverCardName).locator('a') for(let i = 0; i < await hrefCard.count(); i++) { const href = await hrefCard.nth(i).getAttribute('href') const uuid = href.replace(/\/services\/dedicated\/config\/\?uuid=/g, '') hrefArray.push(uuid) }Описание:
- Находит все ссылки (
<a>) внутри элементов, определённыхLOCATORS.serverCardName, которые представляют серверные карты. - Из каждой ссылки извлекает
href, удаляет часть URL, оставляя толькоuuid, и добавляет его вhrefArray.
- Находит все ссылки (
-
Проверки соответствия и исключений:
if(!titleOs.includes('Ubuntu')) { for(const checkOS of hrefArray) { expect.soft(excluded_services, `${titleOs}`).not.toContain(checkOS) } if(titleOs.includes('Oracle 8') || titleOs.includes('Rocky 9')) { expect.soft(foundServerCount.length, `${titleOs}`).toBeGreaterThan(1) } else { expect.soft(foundServerCount.length, `${titleOs}`).toBe(1) } } else { expect.soft(foundServerCount.length, `${titleOs}`).toBeGreaterThan(1) }Описание:
-
Если ОС не Ubuntu:
- Проходится по каждому
uuidизhrefArrayи проверяет, что этотuuidне содержится вexcluded_services(то есть данные сервера на странице не должны включать исключённые сервисы). - Дополнительно:
- Если название ОС содержит «Oracle 8» или «Rocky 9», ожидается, что
foundServerCount.lengthбольше 1 (то есть такие ОС должны быть представлены более чем одним сервером). - В остальных случаях ожидается, что
foundServerCount.lengthравен 1 (только один сервер соответствует данной ОС).
- Если название ОС содержит «Oracle 8» или «Rocky 9», ожидается, что
- Проходится по каждому
-
Если ОС — Ubuntu:
- Ожидается, что
foundServerCount.lengthбольше 1, то есть для Ubuntu должно быть несколько серверов.
- Ожидается, что
Примечания:
- Используется
expect.soft, что означает "мягкие" утверждения. Если одно из них не проходит, тест продолжает выполнение и собирает все ошибки, вместо немедленного прерывания. - Проверки основаны на логике:
- Некоторым ОС не должны соответствовать определённые сервисы (исключения).
- Некоторые ОС должны иметь определённое количество серверов (одно или несколько).
-
9. Сброс фильтров после выполнения теста
await page.locator(LOCATORS.resetFilterChips).click()Описание: Нажимает на элемент, отвечающий за сброс фильтров (
resetFilterChips), чтобы вернуть интерфейс в исходное состояние после выполнения всех проверок.Итоговая логика теста
-
Получение и подготовка данных:
- Тест начинает с получения данных об операционных системах из внешнего API.
- Обрабатывает полученные данные, формируя массив объектов с именами и UUID ОС.
-
Проверка интерфейса страницы:
- Кликает по элементу выбора ОС на странице, чтобы открыть список доступных ОС.
- Собирает все названия ОС и проверяет, чтобы не было дубликатов.
-
Проверка каждой ОС:
- Для каждой операционной системы (кроме, возможно, первой):
- Выбирает ОС в списке.
- Сравнивает выбранную ОС с данными из API.
- Извлекает список исключённых сервисов для этой ОС.
- Собирает UUID сервисов, отображённых на странице.
- Проверяет, что эти UUID не содержатся в списке исключённых сервисов.
- Проверяет, что количество серверов для данной ОС соответствует ожиданиям (один или несколько, в зависимости от конкретной ОС).
- Для каждой операционной системы (кроме, возможно, первой):
-
Завершение:
- Сбрасывает все фильтры, чтобы вернуть страницу к исходному состоянию.
Возможные моменты для улучшения или проверки:
- Начало цикла с
i = 1: Это может быть сделано намеренно, чтобы пропустить пустой или неактивный первый элемент, но стоит убедиться, что это не приводит к пропуску важной ОС. - Обработка отсутствия
excluded_services: В текущей реализации, еслиfoundServerне найден,excluded_servicesбудетundefined, что может привести к ошибкам при проверкеnot.toContain(checkOS). Возможно, стоит добавить обработку случая, когдаexcluded_servicesотсутствует. - Комментирование кода: Хорошая практика добавлять более подробные комментарии, чтобы других разработчиков или вы сами в будущем могли легче понять логику.
Общий вывод
Ваш тестовый скрипт тщательно проверяет соответствие между данными из API и тем, что отображается на веб-странице. Он не только сравнивает названия ОС, но и проверяет, что определённые сервисы исключены для каждой ОС, а также количество серверов соответствует ожиданиям. Это помогает обеспечить, что интерфейс пользователя корректно отображает актуальные данные и соблюдает бизнес-логику приложения.
Если у вас остались конкретные вопросы или неясности по определённым частям кода, пожалуйста, уточните, и я смогу дать более детальное пояснение.
- URL API: