Service Layer для бизнес-логики

Service Layer в контексте тестирования Playwright используется для изоляции и организации бизнес-логики, а также взаимодействия с внешними сервисами и API. Этот слой служит промежуточным звеном между тестами и приложением, обеспечивая абстракцию над более низкоуровневыми деталями реализации. Применение Service Layer помогает повысить читаемость тестов, улучшить их поддерживаемость и облегчить тестирование бизнес-логики без прямой привязки к UI.

Преимущества использования Service Layer

  1. Изоляция бизнес-логики: Сервисный слой позволяет отделить логику тестирования от логики интерфейса. Это приводит к тому, что изменения в пользовательском интерфейсе не требуют переработки всей тестовой инфраструктуры, если они не затрагивают бизнес-логику.
  2. Повторное использование кода: Код, который отвечает за работу с данными или API, может быть вынесен в сервисный слой, что позволяет использовать его в различных тестах без дублирования.
  3. Упрощение тестов: С сервисным слоем тесты становятся проще, так как они могут фокусироваться на проверке поведения, а не на взаимодействии с низкоуровневыми деталями, такими как запросы к серверу или работа с базой данных.

Структура Service Layer

В идеале Service Layer должен включать несколько компонентов, каждый из которых отвечает за конкретный аспект взаимодействия с приложением. В тестах с Playwright можно выделить следующие ключевые части:

  • API-обёртки: Обрабатывают HTTP-запросы и ответы, выполняют валидацию данных, преобразуют форматы данных и передают их в другие слои приложения.
  • Модели данных: Хранят структуру данных и помогают преобразовывать данные между форматами, необходимыми для работы с API или UI.
  • Бизнес-логика: Основные правила обработки данных, которые могут включать фильтрацию, агрегацию или другие сложные манипуляции с данными.

Пример реализации Service Layer

Для того чтобы продемонстрировать реализацию Service Layer в контексте тестирования Playwright, рассмотрим следующий пример. Допустим, есть приложение, которое позволяет создавать и управлять пользователями.

Шаг 1: Определение API-обёртки

class UserService {
  constructor(page) {
    this.page = page;
    this.baseUrl = 'https://example.com/api';
  }

  async createUser(name, email) {
    const response = await this.page.request.post(`${this.baseUrl}/users`, {
      data: {
        name,
        email
      }
    });
    return response.json();
  }

  async getUser(userId) {
    const response = await this.page.request.get(`${this.baseUrl}/users/${userId}`);
    return response.json();
  }

  async updateUser(userId, data) {
    const response = await this.page.request.put(`${this.baseUrl}/users/${userId}`, {
      data
    });
    return response.json();
  }

  async deleteUser(userId) {
    const response = await this.page.request.delete(`${this.baseUrl}/users/${userId}`);
    return response.status();
  }
}

В этом примере UserService инкапсулирует все взаимодействия с API для работы с пользователями. Этот класс содержит методы для создания, получения, обновления и удаления пользователей.

Шаг 2: Интеграция с Playwright тестами

В тестах Playwright можно использовать эту обёртку для упрощения взаимодействия с API и фокусировки на логике тестирования.

const { test, expect } = require('@playwright/test');
const UserService = require('./UserService');

test('Создание и удаление пользователя', async ({ page }) => {
  const userService = new UserService(page);

  // Создание пользователя
  const newUser = await userService.createUser('John Doe', 'john.doe@example.com');
  expect(newUser).toHaveProperty('id');

  // Проверка, что пользователь существует
  const user = await userService.getUser(newUser.id);
  expect(user.name).toBe('John Doe');
  
  // Удаление пользователя
  const status = await userService.deleteUser(newUser.id);
  expect(status).toBe(200);
});

Этот тест выполняет следующие шаги:

  1. Создаёт нового пользователя через API.
  2. Проверяет, что пользователь был успешно создан.
  3. Удаляет созданного пользователя и проверяет, что запрос на удаление прошёл успешно.

Тесты теперь изолированы от деталей взаимодействия с API, и вся логика обрабатывается через UserService.

Роль Service Layer в интеграционных и UI-тестах

В интеграционных тестах Service Layer помогает минимизировать зависимости от внешних сервисов, таких как базы данных или сторонние API. Это даёт возможность тестировать бизнес-логику без необходимости работы с реальными данными или взаимодействия с UI.

В UI-тестах Service Layer обеспечивает упрощённое взаимодействие с приложением. Например, если необходимо создать пользователя перед тестом, можно использовать сервисный слой для выполнения действий через API, а не через UI. Это позволяет ускорить тесты, устраняя шаги, которые не относятся непосредственно к тестируемому функционалу.

Взаимодействие с базой данных

Иногда для тестирования требуется взаимодействие с базой данных, например, чтобы настроить начальное состояние приложения или проверить, что после выполнения действия в приложении данные были правильно сохранены. В таких случаях Service Layer может включать методы для работы с базой данных.

class DatabaseService {
  async connect() {
    // Логика подключения к базе данных
  }

  async getUserById(userId) {
    // Логика получения пользователя из базы данных
  }

  async insertUser(user) {
    // Логика вставки нового пользователя в базу данных
  }
}

Используя такой сервис, можно изолировать работу с базой данных от тестов и минимизировать зависимости.

Применение моков и заглушек в Service Layer

Для эффективного тестирования в Playwright часто используется мокирование API-запросов и ответов, что позволяет избежать зависимости от внешних сервисов и ускорить выполнение тестов. В таком случае Service Layer может быть дополнен моками.

import { test, expect } from '@playwright/test';

test('Мокирование API-запроса', async ({ page }) => {
  await page.route('**/api/users', route => {
    route.fulfill({
      status: 200,
      body: JSON.stringify({ id: '123', name: 'John Doe' })
    });
  });

  const response = await page.request.get('/api/users');
  const user = await response.json();
  expect(user.name).toBe('John Doe');
});

В этом примере API-запрос на получение пользователей замещается на фиктивный ответ, что позволяет тестировать UI без реального обращения к серверу.

Заключение

Service Layer в Playwright тестах — это важная концепция для организации чистого и поддерживаемого кода. Он позволяет изолировать бизнес-логику, упрощая тесты и повышая их читаемость. С помощью сервисного слоя можно работать с API, моделями данных и бизнес-логикой, не беспокоясь о технических деталях реализации. Также, при необходимости, Service Layer позволяет интегрировать мокирование и заглушки, что ускоряет тестирование и снижает зависимость от внешних сервисов.

Оглавление