"""Optional browser integration QA. Requires locally installed Playwright + Chromium.
Run with an already running npm run dev/preview. All API responses are test fixtures.
"""
import argparse
import json
from pathlib import Path
from urllib.parse import urlparse
from playwright.sync_api import sync_playwright
parser = argparse.ArgumentParser()
parser.add_argument('--url', default='http://127.0.0.1:4176')
parser.add_argument('--artifacts', default='/tmp/vnox-web-qa')
args = parser.parse_args()
if urlparse(args.url).hostname not in {'127.0.0.1', 'localhost', '::1'}:
raise SystemExit('Browser fixture QA is restricted to a loopback preview.')
artifacts = Path(args.artifacts)
artifacts.mkdir(parents=True, exist_ok=True)
with sync_playwright() as p:
browser = p.chromium.launch(executable_path='/usr/bin/chromium', headless=True, args=['--no-sandbox'])
context = browser.new_context(viewport={'width': 1440, 'height': 1000}, locale='ru-RU')
mail = {'starts': [], 'verifies': [], 'start_status': 202, 'verify_status': 400, 'good_code': '12345678'}
state = {'info': {'capabilities': {'github_auth': 'enabled'}}, 'session': {'authenticated': False}, 'info_status': 200, 'session_status': 200, 'logout_status': 204}
logouts = []
def api(route):
path = urlparse(route.request.url).path
if path == '/v1/info': route.fulfill(status=state['info_status'], json=state['info'])
elif path == '/v1/auth/session': route.fulfill(status=state['session_status'], json=state['session'])
elif path == '/v1/auth/email/start':
body = json.loads(route.request.post_data or '{}')
mail['starts'].append({'body': body, 'headers': route.request.all_headers()})
route.fulfill(status=mail['start_status'], json={'status': 'code_requested', 'expires_in': 600, 'resend_after': 3} if mail['start_status'] == 202 else {'error': 'try_later'})
elif path == '/v1/auth/email/verify':
body = json.loads(route.request.post_data or '{}')
mail['verifies'].append(body)
if body.get('code') == mail['good_code']:
state['session'] = {'authenticated': True, 'csrf_token': 'email-csrf', 'user': {'user_id': 'email-id', 'handle': 'u_emailfixture', 'display_name': 'Vnox user', 'avatar_url': None}}
route.fulfill(status=200, json=state['session'])
else: route.fulfill(status=mail['verify_status'], json={'error': 'invalid_code'})
elif path == '/v1/auth/logout':
logouts.append({'method': route.request.method, 'headers': route.request.all_headers()})
route.fulfill(status=state['logout_status'], body='' if state['logout_status'] == 204 else '{}')
else: route.fulfill(status=404, json={'error': 'fixture_not_found'})
context.route('**/v1/**', api)
page = context.new_page()
errors = []
page.on('pageerror', lambda error: errors.append(str(error)))
page.goto(args.url)
page.locator('#service-status').filter(has_text='отвечает').wait_for()
page.screenshot(path=str(artifacts / 'desktop-hero.png'))
page.screenshot(path=str(artifacts / 'desktop-full.png'), full_page=True)
page.locator('#light').scroll_into_view_if_needed()
page.wait_for_function("document.querySelector('.count').textContent === '120'")
page.locator('[data-tab="voice"]').click()
assert page.locator('.voice-orbit').count() == 1
page.locator('[data-tab="voice"]').press('ArrowRight')
assert page.locator('[data-tab="theme"]').get_attribute('aria-selected') == 'true'
page.locator('[data-theme="light"]').click()
assert page.locator('.product-diagram').get_attribute('data-preview-theme') == 'light'
page.locator('[data-language="en"]').click()
assert page.locator('h1').inner_text() == 'Voice and text chat\non your own server.'
assert page.evaluate('document.documentElement.lang') == 'en'
assert page.title() == 'VNOX: voice and text chat on your own server'
assert page.locator('meta[property="og:title"]').get_attribute('content') == page.title()
assert '\u2014' not in page.content()
assert page.locator('[data-tab="theme"]').get_attribute('aria-selected') == 'true'
assert page.locator('[data-theme="light"]').get_attribute('aria-pressed') == 'true'
for locale in ['en', 'ru']:
page.locator(f'[data-language="{locale}"]').click()
for width in [320, 390, 768, 1440]:
page.set_viewport_size({'width': width, 'height': 844})
assert not page.evaluate('document.documentElement.scrollWidth > innerWidth'), (locale, width)
page.set_viewport_size({'width': 390, 'height': 844})
page.evaluate("document.querySelectorAll('.reveal').forEach(e => e.classList.add('in'))")
page.screenshot(path=str(artifacts / 'mobile-full.png'), full_page=True)
reduced = browser.new_context(viewport={'width': 390, 'height': 844}, reduced_motion='reduce')
rp = reduced.new_page()
rp.goto(args.url)
rp.locator('.light-section').wait_for()
assert not rp.evaluate("document.documentElement.classList.contains('motion')")
assert rp.locator('.count').inner_text() == '120'
assert rp.evaluate("getComputedStyle(document.querySelector('.reveal')).opacity") == '1'
reduced.close()
page.goto(args.url + '/account')
page.locator('.github-login[href="/v1/auth/github/start"]').wait_for()
assert page.locator('.github-login').get_attribute('aria-disabled') is None
page.screenshot(path=str(artifacts / 'account-login-mobile.png'), full_page=True)
state['info'] = {'capabilities': {'github_auth': 'not_enabled'}}
page.reload()
page.locator('#login-availability').filter(has_text='выключен').wait_for()
assert page.locator('.github-login').get_attribute('href') is None
# Email sign-in: hidden unless Hub reports email_auth enabled.
assert page.locator('#email-form').count() == 0
state['info'] = {'capabilities': {'github_auth': 'enabled', 'email_auth': 'not_enabled'}}
page.reload()
page.locator('.github-login').wait_for()
page.wait_for_timeout(300)
assert page.locator('#email-form').count() == 0
state['info'] = {'capabilities': {'github_auth': 'enabled', 'email_auth': 'enabled'}}
page.reload()
page.locator('#email-input').wait_for()
page.screenshot(path=str(artifacts / 'account-email-address.png'), full_page=True)
# Invalid address is caught in the browser, with focus and aria state.
page.locator('#email-input').fill('not-an-address')
page.locator('#email-input').press('Enter')
page.locator('#email-message').filter(has_text='Проверьте адрес').wait_for()
assert page.locator('#email-input').get_attribute('aria-invalid') == 'true'
assert page.evaluate("document.activeElement.id") == 'email-input'
assert page.locator('#email-message').get_attribute('role') == 'status'
assert not mail['starts']
# Server-side rate limit and outage are reported without leaving the step.
mail['start_status'] = 429
page.locator('#email-input').fill(' Person@Example.com ')
page.locator('#email-submit').click()
page.locator('#email-message').filter(has_text='Слишком много').wait_for()
mail['start_status'] = 503
page.locator('#email-submit').click()
page.locator('#email-message').filter(has_text='Не получилось').wait_for()
mail['start_status'] = 202
page.locator('#email-input').press('Enter')
page.locator('#code-input').wait_for()
assert page.evaluate("document.activeElement.id") == 'code-input'
sent = mail['starts'][-1]
assert sent['body'] == {'email': 'Person@Example.com', 'lang': 'ru'}, sent['body']
assert sent['headers']['origin'] == args.url
assert sent['headers']['content-type'] == 'application/json'
assert page.locator('#email-sent').inner_text().count('person@example.com') == 1
page.screenshot(path=str(artifacts / 'account-email-code.png'), full_page=True)
# Resend is locked by the timer (3 s fixture), then works.
assert page.locator('#resend').is_disabled()
assert 'через' in page.locator('#resend').inner_text()
page.locator('#resend:not([disabled])').wait_for(timeout=6000)
page.locator('#resend').click()
page.locator('#email-message').filter(has_text='Новый код отправлен').wait_for()
assert len(mail['starts']) == 4
# Language switch keeps the step and the typed address, and relabels the form.
page.locator('#code-input').fill('12ab34')
assert page.locator('#code-input').input_value() == '1234'
page.locator('[data-language="en"]').click()
assert page.locator('label[for="code-input"]').inner_text() == 'Code from the email'
assert page.locator('#code-input').input_value() == '1234'
page.locator('[data-language="ru"]').click()
# Short code, wrong code, then the right one.
page.locator('#email-submit').click()
page.locator('#email-message').filter(has_text='8 цифр').wait_for()
page.locator('#code-input').fill('00000000')
page.locator('#email-submit').click()
page.locator('#email-message').filter(has_text='не подошёл').wait_for()
assert page.locator('#code-input').get_attribute('aria-invalid') == 'true'
assert page.locator('#code-input').input_value() == ''
page.locator('#change-email').click()
assert page.locator('#email-input').input_value() == 'Person@Example.com'
page.locator('#email-submit').click()
page.locator('#code-input').wait_for()
for width in [320, 390, 768, 1440]:
page.set_viewport_size({'width': width, 'height': 844})
assert not page.evaluate('document.documentElement.scrollWidth > innerWidth'), ('email', width)
page.set_viewport_size({'width': 1440, 'height': 1000})
page.locator('#code-input').fill('12345678')
page.locator('#code-input').press('Enter')
page.locator('#profile-id').wait_for()
assert mail['verifies'][-1] == {'email': 'Person@Example.com', 'code': '12345678'}
assert page.locator('#email-form').count() == 0
assert page.evaluate('Object.keys(localStorage)') == ['vnox-web-language']
state['session'] = {'authenticated': False}
state['info'] = {'capabilities': {'github_auth': 'enabled'}}
state['info_status'] = 503
page.reload()
page.locator('#retry-info:not([hidden])').wait_for()
state['session_status'] = 503
page.reload()
page.locator('#retry-session').wait_for()
state['info_status'] = 200
state['session_status'] = 200
state['info'] = {'capabilities': {'github_auth': 'enabled'}}
state['session'] = {'authenticated': True, 'csrf_token': 'fixture-csrf-token', 'user': {'user_id': 'fixture-id', 'handle': '', 'display_name': '
', 'avatar_url': 'javascript:alert(1)'}}
page.locator('#retry-session').click()
page.locator('#profile-id').wait_for()
assert page.locator('#profile-name').inner_text() == state['session']['user']['display_name']
assert page.locator('#profile-name img, #profile-handle script, #profile-avatar img').count() == 0
assert page.evaluate('typeof window.__injected') == 'undefined'
assert page.evaluate('Object.keys(localStorage)') == ['vnox-web-language']
state['session']['user'] = {'user_id': 'c11ca6c3-296a-40f6-a420-8a097d401e26', 'handle': 'u_preview', 'display_name': 'VNOX Preview', 'avatar_url': None}
page.reload()
page.locator('#profile-id').wait_for()
page.set_viewport_size({'width': 1440, 'height': 1000})
page.screenshot(path=str(artifacts / 'account-profile-desktop.png'))
for locale in ['ru', 'en']:
page.locator(f'[data-language="{locale}"]').click()
for width in [320,390,768,1440]:
page.set_viewport_size({'width':width,'height':844})
assert not page.evaluate('document.documentElement.scrollWidth > innerWidth'), ('account',locale,width)
page.locator('#logout').click()
page.locator('.github-login').wait_for()
assert logouts[-1]['method'] == 'POST'
assert logouts[-1]['headers']['x-csrf-token'] == 'fixture-csrf-token'
assert logouts[-1]['headers']['origin'] == args.url
assert page.evaluate('sessionStorage.length') == 0
state['logout_status'] = 401
page.reload()
page.locator('#profile-id').wait_for()
page.locator('#logout').click()
page.locator('.github-login').wait_for()
assert not errors, errors
browser.close()
print(json.dumps({'result':'passed','assertions':'tabs, theme, RU/EN, 320/390/768/1440 layout, login enabled/disabled/errors, email code flow with fixtures, session/profile XSS safety, CSRF logout/expired session, no persisted secrets','artifacts':str(artifacts)}))