0 Fork 0

mirror of https://github.com/jokob-sk/NetAlertX.git synced 2026-10-07 05:25:16 -04:00

Files

T

Alexander Shevchenko 1aceeae218 test(frontend): cover network topology rendering and interactions

Add a standalone fixture using the real topology renderer and styles.
Check painted pixels in WebKit, Chromium and Firefox because DOM bounds
can remain correct when WebKit paints foreignObject content incorrectly.

Exercise node clicks, collapse/expand, wheel zoom and drag pan, including
assertions that pointer gestures change the SVG transform.

Document dependency installation and execution separately from pytest.
The regression fails with the original frontend and passes with the fix.

2026-10-04 16:45:29 +02:00

fixtures

test(frontend): cover network topology rendering and interactions

2026-10-04 16:45:29 +02:00

__init__.py

feat(api): MCP, OpenAPI & Dynamic Introspection

2026-01-18 18:16:18 +00:00

conftest.py

refactor UI backend calls to python endpoints

2026-01-10 03:06:02 +00:00

README.md

refactor UI backend calls to python endpoints

2026-01-10 03:06:02 +00:00

run_all_tests.py

Coderabbit fixes:

2026-01-19 01:12:48 +00:00

run_ui_tests.sh

refactor UI backend calls to python endpoints

2026-01-10 03:06:02 +00:00

test_chromium_setup.py

refactor UI backend calls to python endpoints

2026-01-10 03:06:02 +00:00

test_helpers.py

feat(api): MCP, OpenAPI & Dynamic Introspection

2026-01-18 18:16:18 +00:00

test_network_topology.cjs

test(frontend): cover network topology rendering and interactions

2026-10-04 16:45:29 +02:00

test_ui_dashboard.py

feat(api): MCP, OpenAPI & Dynamic Introspection

2026-01-18 18:16:18 +00:00

test_ui_devices.py

Coderabbit fixes:

2026-01-19 01:12:48 +00:00

test_ui_login.py

Enhance device MAC address handling in tests to ensure lowercase normalization and skip tests when web protection is disabled

2026-03-02 10:42:36 +00:00

test_ui_maintenance.py

Fix over-broad page source assertion in test_export_csv_button_works

2026-07-01 06:08:36 +00:00

test_ui_multi_edit.py

feat(api): MCP, OpenAPI & Dynamic Introspection

2026-01-18 18:16:18 +00:00

test_ui_network.py

feat(api): MCP, OpenAPI & Dynamic Introspection

2026-01-18 18:16:18 +00:00

test_ui_notifications.py

feat(api): MCP, OpenAPI & Dynamic Introspection

2026-01-18 18:16:18 +00:00

test_ui_plugins.py

feat(api): MCP, OpenAPI & Dynamic Introspection

2026-01-18 18:16:18 +00:00

test_ui_settings.py

feat(api): MCP, OpenAPI & Dynamic Introspection

2026-01-18 18:16:18 +00:00

test_ui_translations.py

Refactor cache handling for plugins: update pluginsData initialization and improve fetch logic; enhance UI tests for translation loading

2026-07-02 04:32:01 +00:00

test_ui_waits.py

Update test suite configuration and enhance test assertions

2026-07-01 05:54:05 +00:00

test_ui_xss_devname.py

Refine documentation and enhance XSS prevention measures in device details and test scripts

2026-05-21 00:36:59 +00:00

TESTING_GUIDE.md

test(frontend): cover network topology rendering and interactions

2026-10-04 16:45:29 +02:00

README.md

UI Testing Setup

Selenium Tests

The UI test suite uses Selenium with Chrome/Chromium for browser automation and comprehensive testing.

First Time Setup (Devcontainer)

The devcontainer includes Chromium and chromedriver. If you need to reinstall:

# Install Chromium and chromedriver
apk add --no-cache chromium chromium-chromedriver nss freetype harfbuzz ca-certificates ttf-freefont font-noto

# Install Selenium
pip install selenium

Running Tests

# Run all UI tests
pytest test/ui/

# Run specific test file
pytest test/ui/test_ui_dashboard.py

# Run specific test
pytest test/ui/test_ui_dashboard.py::test_dashboard_loads

# Run with verbose output
pytest test/ui/ -v

# Run and stop on first failure
pytest test/ui/ -x

What Gets Tested

✅ API Backend endpoints - All Flask API endpoints work correctly
✅ Page loads - All pages load without fatal errors (Dashboard, Devices, Network, Settings, etc.)
✅ Dashboard metrics - Charts and device counts display
✅ Device operations - Add, edit, delete devices via UI
✅ Network topology - Device relationship visualization
✅ Multi-edit bulk operations - Bulk device editing
✅ Maintenance tools - CSV export/import, database cleanup
✅ Settings configuration - Settings page loads and saves
✅ Notification system - User notifications display
✅ JavaScript error detection - No console errors on page loads

Test Organization

Tests are organized by page/feature:

test_ui_dashboard.py - Dashboard metrics and charts
test_ui_devices.py - Device listing and CRUD operations
test_ui_network.py - Network topology visualization
test_ui_maintenance.py - Database tools and CSV operations
test_ui_multi_edit.py - Bulk device editing
test_ui_settings.py - Settings configuration
test_ui_notifications.py - Notification system
test_ui_plugins.py - Plugin management

Troubleshooting

"Could not start Chromium"

Ensure Chromium is installed: which chromium
Check chromedriver: which chromedriver
Verify versions match: chromium --version and chromedriver --version

"API token not available"

Check /data/config/app.conf exists and contains API_TOKEN=
Restart backend services if needed

Tests skip with "Chromium browser not available"

Chromium not installed or not in PATH
Run: apk add chromium chromium-chromedriver

Writing New Tests

See TESTING_GUIDE.md for comprehensive examples of:

Button click testing
Form submission
AJAX request verification
File download testing
Multi-step workflows

Browser launch fails

Alpine Linux uses system Chromium
Make sure chromium package is installed: apk info chromium

Tests timeout

Increase timeout in test functions
Check if backend is running: ps aux | grep python3
Verify frontend is accessible: curl http://localhost:20211