Налаштування Selenium-тестів для 1С-Бітрікс

Налаштування Selenium-тестів для 1С-Бітрікс

Ручне тестування регресій після кожного релізу — дорого. Форма замовлення зламалась, фільтр каталогу не працює на третій сторінці, кошик втрачає товари після авторизації — ці сценарії можна виявити за допомогою Selenium до того, як їх виявить покупець. Для сайтів на 1С-Бітрікс, де бізнес-логіка розкидана по PHP-компонентах і JavaScript, Selenium — найбільш підходящий інструмент: він тестує реальний браузер, а не моки.

Налаштування Selenium-тестів для 1С-Бітрікс

Інфраструктура Selenium для Бітрікс

Selenium WebDriver з Java або Python — класичний стек. Для PHP-проєктів краще використовувати PHP-обгортки: php-webdriver/webdriver (Facebook PHP WebDriver) або Codeception з модулем WebDriver.

Мінімальна інфраструктура:

Тести (PHP/Python) → Selenium WebDriver → ChromeDriver/GeckoDriver → Браузер → Сайт на 1С-Бітрікс

Для CI/CD — Selenium Grid або Selenium Standalone у Docker:

# docker-compose.selenium.yml
services:
  selenium-chrome:
    image: selenium/standalone-chrome:latest
    ports:
      - "4444:4444"
    environment:
      - SE_NODE_MAX_SESSIONS=3
    shm_size: 2g

Конфігурація для тестування середовища Бітрікс

// tests/selenium/SeleniumTestCase.php
use Facebook\WebDriver\Remote\RemoteWebDriver;
use Facebook\WebDriver\Remote\DesiredCapabilities;
use Facebook\WebDriver\WebDriverBy;
use Facebook\WebDriver\WebDriverExpectedCondition;

abstract class BitrixSeleniumTest extends PHPUnit\Framework\TestCase
{
    protected RemoteWebDriver $driver;
    protected string $baseUrl = 'https://test.site.ru';

    protected function setUp(): void
    {
        $caps = DesiredCapabilities::chrome();
        $caps->setCapability('goog:chromeOptions', [
            'args' => ['--headless', '--no-sandbox', '--disable-dev-shm-usage'],
        ]);

        $this->driver = RemoteWebDriver::create(
            'http://localhost:4444/wd/hub',
            $caps,
            30000, // таймаут підключення
            30000  // таймаут запиту
        );
        $this->driver->manage()->window()->setSize(
            new \Facebook\WebDriver\WebDriverDimension(1280, 900)
        );
    }

    protected function tearDown(): void
    {
        $this->driver->quit();
    }

    protected function waitForElement(string $selector, int $seconds = 10): \Facebook\WebDriver\WebDriverElement
    {
        return $this->driver->wait($seconds)->until(
            WebDriverExpectedCondition::visibilityOfElementLocated(
                WebDriverBy::cssSelector($selector)
            )
        );
    }

    protected function loginAsAdmin(): void
    {
        $this->driver->get($this->baseUrl . '/bitrix/admin/');
        $this->driver->findElement(WebDriverBy::name('USER_LOGIN'))->sendKeys('admin');
        $this->driver->findElement(WebDriverBy::name('USER_PASSWORD'))->sendKeys(getenv('BITRIX_ADMIN_PASS'));
        $this->driver->findElement(WebDriverBy::cssSelector('[type=submit]'))->click();
    }
}

Тест критичних користувацьких сценаріїв

// tests/selenium/CheckoutFlowTest.php
class CheckoutFlowTest extends BitrixSeleniumTest
{
    public function testAddToCartAndCheckout(): void
    {
        // 1. Відкриваємо картку товару
        $this->driver->get($this->baseUrl . '/catalog/tools/drills/bosch-gsh/');

        // 2. Чекаємо завантаження кнопки та натискаємо
        $addBtn = $this->waitForElement('[data-action="add-to-cart"]');
        $addBtn->click();

        // 3. Чекаємо оновлення лічильника кошика
        $counter = $this->waitForElement('.cart-counter');
        $this->assertSame('1', $counter->getText());

        // 4. Переходимо до кошика
        $this->driver->get($this->baseUrl . '/cart/');

        // 5. Перевіряємо, що товар у кошику
        $cartItem = $this->waitForElement('.cart-item');
        $this->assertStringContainsString('Bosch GSH', $cartItem->getText());

        // 6. Натискаємо оформити замовлення
        $this->driver->findElement(
            WebDriverBy::cssSelector('.checkout-btn')
        )->click();

        // 7. Чекаємо сторінки чекауту
        $this->waitForElement('#checkout-form');
        $this->assertStringContainsString('/order/', $this->driver->getCurrentURL());
    }
}

Тест розумного фільтра каталогу

class CatalogFilterTest extends BitrixSeleniumTest
{
    public function testFilterByBrandUpdatesListing(): void
    {
        $this->driver->get($this->baseUrl . '/catalog/tools/');

        // Чекаємо завантаження фільтра
        $this->waitForElement('.catalog-filter');

        // Клікаємо чекбокс фільтра «Bosch»
        $brandCheckbox = $this->driver->findElement(
            WebDriverBy::cssSelector('[data-filter="brand"][value="bosch"]')
        );
        $brandCheckbox->click();

        // Чекаємо AJAX-оновлення списку товарів
        $this->driver->wait(10)->until(
            WebDriverExpectedCondition::invisibilityOfElementLocated(
                WebDriverBy::cssSelector('.catalog-loading')
            )
        );

        // Перевіряємо, що URL змінився (ЧПУ-фільтр)
        $this->assertStringContainsString('brand=bosch', $this->driver->getCurrentURL());

        // Перевіряємо, що всі картки містять «Bosch»
        $cards = $this->driver->findElements(
            WebDriverBy::cssSelector('.product-card .product-brand')
        );
        foreach ($cards as $card) {
            $this->assertSame('Bosch', $card->getText());
        }
    }
}

Терміни