feat: 重构测试框架 — 覆盖 6 端 (管理端 + 小程序 + 4 个移动端)
目录结构: tests/web/admin/ 管理端 (Playwright) tests/web/mini_program/ 司机端小程序 (Playwright/微信 WebView) tests/app/driver_android/ 司机安卓 (Appium) tests/app/shipper_android/ 货主安卓 (Appium) tests/app/driver_ios/ 司机苹果 (Appium) tests/app/shipper_ios/ 货主苹果 (Appium) 公共模块: tests/app/_shared.py driver+ensure_logged_in 工厂 tests/app/_base_page.py App Page Object 基类 配置: test_config.yaml 拆分为 6 个独立 section + 货主账号
This commit is contained in:
xst
@@ -0,0 +1,126 @@
|
||||
"""管理端 fixture — Playwright 浏览器实例 + 登录态复用。
|
||||
|
||||
核心机制:
|
||||
skip_login: true → 加载 storage_state，跳过验证码
|
||||
skip_login: false → 执行完整 UI 登录
|
||||
|
||||
初始化:
|
||||
python tests/web/admin/save_auth.py
|
||||
"""
|
||||
|
||||
from datetime import datetime
|
||||
from pathlib import Path
|
||||
|
||||
import pytest
|
||||
from playwright.sync_api import sync_playwright, Page
|
||||
|
||||
SCREENSHOTS_DIR = Path("output/screenshots")
|
||||
|
||||
|
||||
@pytest.fixture(params=["chromium", "firefox"])
|
||||
def browser_name(admin_config, request):
|
||||
"""每个浏览器执行一轮。"""
|
||||
browsers = admin_config.get("browsers", ["chromium", "firefox"])
|
||||
request.param = browsers[len(getattr(request, "_index", 0))]
|
||||
return request.param
|
||||
|
||||
|
||||
@pytest.fixture
|
||||
def page(admin_config, browser_name, request) -> Page:
|
||||
"""Playwright Page，加载登录态，失败自动截图。"""
|
||||
viewport = admin_config.get("viewport", {"width": 1920, "height": 1080})
|
||||
timeout = admin_config.get("timeout_seconds", 120) * 1000
|
||||
skip_login = admin_config.get("skip_login", True)
|
||||
storage_state_dir = Path(admin_config.get("storage_state_dir", "tests/web/auth"))
|
||||
|
||||
with sync_playwright() as p:
|
||||
browser_launcher = getattr(p, browser_name)
|
||||
browser = browser_launcher.launch(headless=True)
|
||||
|
||||
context_kwargs = {
|
||||
"viewport": {"width": viewport["width"], "height": viewport["height"]},
|
||||
"locale": "zh-CN",
|
||||
}
|
||||
|
||||
loaded_role = None
|
||||
if skip_login:
|
||||
loaded_role = _load_auth_state(context_kwargs, storage_state_dir, browser_name)
|
||||
|
||||
context = browser.new_context(**context_kwargs)
|
||||
page = context.new_page()
|
||||
page.set_default_timeout(timeout)
|
||||
page._auth_role = loaded_role
|
||||
|
||||
yield page
|
||||
|
||||
if hasattr(request.node, "rep_call") and request.node.rep_call.failed:
|
||||
scenario_dir = SCREENSHOTS_DIR / request.node.name
|
||||
scenario_dir.mkdir(parents=True, exist_ok=True)
|
||||
ts = datetime.now().strftime("%Y%m%d_%H%M%S")
|
||||
path = str(scenario_dir / f"FAIL_{browser_name}_{ts}.png")
|
||||
page.screenshot(path=path, full_page=True)
|
||||
|
||||
context.close()
|
||||
browser.close()
|
||||
|
||||
|
||||
@pytest.fixture
|
||||
def ensure_login(admin_config, page, config):
|
||||
"""确保管理端已登录。"""
|
||||
|
||||
def _ensure_login(role: str = "super_admin") -> None:
|
||||
account = config["accounts"].get(role)
|
||||
if not account:
|
||||
raise ValueError(f"未知角色 '{role}'，可用: {list(config['accounts'].keys())}")
|
||||
|
||||
base_url = admin_config["base_url"]
|
||||
skip_login = admin_config.get("skip_login", True)
|
||||
|
||||
if skip_login:
|
||||
auth_role = getattr(page, "_auth_role", None)
|
||||
if auth_role == role:
|
||||
page.goto(base_url)
|
||||
page.wait_for_timeout(2000)
|
||||
if "#/login" not in page.url and "/login" not in page.url:
|
||||
return
|
||||
raise RuntimeError(
|
||||
f"登录态已过期！请运行: python tests/web/admin/save_auth.py --role {role}"
|
||||
)
|
||||
if auth_role and auth_role != role:
|
||||
raise RuntimeError(
|
||||
f"当前 storage_state 角色为 '{auth_role}'，请求 '{role}'。\n"
|
||||
f"请运行: python tests/web/admin/save_auth.py --role {role}"
|
||||
)
|
||||
raise RuntimeError(
|
||||
f"未找到角色 '{role}' 的登录态文件！请运行:\n"
|
||||
f" python tests/web/admin/save_auth.py --role {role}"
|
||||
)
|
||||
|
||||
# skip_login: false
|
||||
page.goto(f"{base_url}/#/login")
|
||||
page.get_by_placeholder("请输入用户名").fill(account["phone"])
|
||||
page.get_by_placeholder("请输入密码").fill(account["password"])
|
||||
page.get_by_role("button", name="登录").click()
|
||||
page.wait_for_timeout(3000)
|
||||
if "#/login" in page.url or "/login" in page.url:
|
||||
raise RuntimeError(
|
||||
"登录失败！可能存在图形验证码。请改为手动登录: python tests/web/admin/save_auth.py"
|
||||
)
|
||||
|
||||
return _ensure_login
|
||||
|
||||
|
||||
def _load_auth_state(context_kwargs: dict, storage_dir: Path, browser: str) -> str | None:
|
||||
auth_files = list(storage_dir.glob(f"*_{browser}.json")) if storage_dir.exists() else []
|
||||
if not auth_files:
|
||||
return None
|
||||
auth_file = auth_files[0]
|
||||
context_kwargs["storage_state"] = str(auth_file)
|
||||
return auth_file.stem.replace(f"_{browser}", "")
|
||||
|
||||
|
||||
@pytest.hookimpl(tryfirst=True, hookwrapper=True)
|
||||
def pytest_runtest_makereport(item, call):
|
||||
outcome = yield
|
||||
rep = outcome.get_result()
|
||||
setattr(item, f"rep_{rep.when}", rep)
|
||||
@@ -0,0 +1,76 @@
|
||||
"""Page Object 基类 — 封装所有页面共享的通用操作。
|
||||
|
||||
每个具体页面应继承 BasePage，在 __init__ 中声明所有定位器。
|
||||
|
||||
Usage:
|
||||
class LoginPage(BasePage):
|
||||
def __init__(self, page):
|
||||
super().__init__(page)
|
||||
self.phone_input = page.get_by_placeholder("请输入用户名")
|
||||
self.login_btn = page.get_by_role("button", name="登录")
|
||||
"""
|
||||
|
||||
from datetime import datetime
|
||||
from pathlib import Path
|
||||
from typing import Optional
|
||||
|
||||
from playwright.sync_api import Page, Locator, expect
|
||||
|
||||
SCREENSHOTS_DIR = Path("output/screenshots")
|
||||
|
||||
|
||||
class BasePage:
|
||||
"""Page Object 基类。"""
|
||||
|
||||
def __init__(self, page: Page, timeout_ms: int = 30_000):
|
||||
self.page = page
|
||||
self.timeout = timeout_ms
|
||||
|
||||
# ── 通用等待 ──
|
||||
|
||||
def wait_visible(self, locator: Locator, timeout_ms: Optional[int] = None) -> None:
|
||||
"""等待元素可见。"""
|
||||
expect(locator).to_be_visible(timeout=timeout_ms or self.timeout)
|
||||
|
||||
def wait_hidden(self, locator: Locator, timeout_ms: Optional[int] = None) -> None:
|
||||
"""等待元素消失（如 Loading 遮罩）。"""
|
||||
expect(locator).to_be_hidden(timeout=timeout_ms or self.timeout)
|
||||
|
||||
def wait_for_text(self, text: str, timeout_ms: Optional[int] = None) -> None:
|
||||
"""等待页面上出现指定文本。"""
|
||||
expect(self.page.get_by_text(text)).to_be_visible(timeout=timeout_ms or self.timeout)
|
||||
|
||||
# ── 通用操作 ──
|
||||
|
||||
def fill_field(self, locator: Locator, value: str) -> None:
|
||||
"""安全填写输入框（先等待可见，再清空后填写）。"""
|
||||
self.wait_visible(locator)
|
||||
locator.clear()
|
||||
locator.fill(value)
|
||||
|
||||
def click_when_ready(self, locator: Locator) -> None:
|
||||
"""安全点击（等待可见 + 可操作）。"""
|
||||
self.wait_visible(locator)
|
||||
locator.click()
|
||||
|
||||
def get_text(self, locator: Locator) -> str:
|
||||
"""获取元素的 inner text。"""
|
||||
self.wait_visible(locator)
|
||||
return locator.inner_text()
|
||||
|
||||
# ── 截图 ──
|
||||
|
||||
def screenshot(self, name: str, full_page: bool = False) -> str:
|
||||
"""关键节点截图，返回文件路径。"""
|
||||
scenario_dir = SCREENSHOTS_DIR / self.__class__.__name__
|
||||
scenario_dir.mkdir(parents=True, exist_ok=True)
|
||||
ts = datetime.now().strftime("%Y%m%d_%H%M%S")
|
||||
path = str(scenario_dir / f"{name}_{ts}.png")
|
||||
self.page.screenshot(path=path, full_page=full_page)
|
||||
return path
|
||||
|
||||
# ── 导航 ──
|
||||
|
||||
def navigate(self, url: str) -> None:
|
||||
"""导航到指定 URL 并等待页面加载完成。"""
|
||||
self.page.goto(url, wait_until="domcontentloaded")
|
||||
@@ -0,0 +1,53 @@
|
||||
"""导航栏公共组件。
|
||||
|
||||
跨页面复用的顶部/侧边导航操作。
|
||||
|
||||
Usage:
|
||||
from tests.web.admin.pages.components.navbar import NavBar
|
||||
|
||||
navbar = NavBar(page)
|
||||
navbar.go_to("运输管理")
|
||||
"""
|
||||
|
||||
from playwright.sync_api import Page, expect
|
||||
|
||||
from tests.web.admin.pages.base_page import BasePage
|
||||
|
||||
|
||||
class NavBar(BasePage):
|
||||
"""侧边导航栏组件。"""
|
||||
|
||||
def __init__(self, page: Page):
|
||||
super().__init__(page)
|
||||
# ⚠️ 以下定位器需要根据实际 DOM 调整
|
||||
self.sidebar = page.locator(".ant-layout-sider")
|
||||
self.logout_btn = page.get_by_text("退出登录")
|
||||
|
||||
def go_to(self, menu_name: str) -> None:
|
||||
"""点击侧边栏菜单项展开/跳转。
|
||||
|
||||
Args:
|
||||
menu_name: 菜单名称文本（如 "运输管理"、"基础信息"）
|
||||
"""
|
||||
menu_item = self.page.get_by_text(menu_name).first
|
||||
self.click_when_ready(menu_item)
|
||||
|
||||
def go_to_submenu(self, parent_menu: str, sub_menu: str) -> None:
|
||||
"""点击父级菜单后，点击子菜单项。
|
||||
|
||||
Args:
|
||||
parent_menu: 父级菜单文本（如 "整车运输"）
|
||||
sub_menu: 子菜单文本（如 "运单管理"）
|
||||
"""
|
||||
self.go_to(parent_menu)
|
||||
sub_item = self.page.get_by_text(sub_menu).first
|
||||
self.click_when_ready(sub_item)
|
||||
|
||||
def logout(self) -> None:
|
||||
"""退出登录。"""
|
||||
self.click_when_ready(self.logout_btn)
|
||||
expect(self.page).to_have_url("#/login", timeout=10_000)
|
||||
|
||||
def is_expanded(self) -> bool:
|
||||
"""检查侧边栏是否展开。"""
|
||||
return self.sidebar.is_visible()
|
||||
@@ -0,0 +1,54 @@
|
||||
"""登录页面 — Page Object。
|
||||
|
||||
Usage:
|
||||
from tests.web.admin.pages.login_page import LoginPage
|
||||
|
||||
login_page = LoginPage(page)
|
||||
login_page.login(phone="super_admin", password="951260684NiAn..")
|
||||
"""
|
||||
|
||||
from playwright.sync_api import Page, expect
|
||||
|
||||
from tests.web.admin.pages.base_page import BasePage
|
||||
|
||||
|
||||
class LoginPage(BasePage):
|
||||
"""运八管理端登录页。"""
|
||||
|
||||
def __init__(self, page: Page):
|
||||
super().__init__(page)
|
||||
# ── 定位器声明 ──
|
||||
self.username_input = page.get_by_placeholder("请输入用户名")
|
||||
self.password_input = page.get_by_placeholder("请输入密码")
|
||||
self.login_btn = page.get_by_role("button", name="登录")
|
||||
self.error_tip = page.locator(".ant-form-item-explain-error")
|
||||
|
||||
def login(self, phone: str, password: str, expect_success: bool = True) -> None:
|
||||
"""执行登录流程。
|
||||
|
||||
Args:
|
||||
phone: 用户名/手机号
|
||||
password: 密码
|
||||
expect_success: True=预期成功跳转，False=预期留在登录页并有错误提示
|
||||
"""
|
||||
self.fill_field(self.username_input, phone)
|
||||
self.fill_field(self.password_input, password)
|
||||
self.click_when_ready(self.login_btn)
|
||||
|
||||
if expect_success:
|
||||
# 等待登录成功后页面跳转（hash 路由模式）
|
||||
self.page.wait_for_timeout(3000)
|
||||
assert "/#/login" not in self.page.url and "/login" not in self.page.url, \
|
||||
"登录失败，仍在登录页"
|
||||
else:
|
||||
# 预期登录失败，停留在当前页
|
||||
expect(self.page).to_have_url("**/login**", timeout=5_000)
|
||||
|
||||
def get_error_message(self) -> str:
|
||||
"""获取登录失败时的错误提示文本。"""
|
||||
self.wait_visible(self.error_tip)
|
||||
return self.error_tip.inner_text()
|
||||
|
||||
def is_on_login_page(self) -> bool:
|
||||
"""检查是否仍在登录页（兼容 hash 路由）。"""
|
||||
return "/login" in self.page.url or "/#/login" in self.page.url
|
||||
@@ -0,0 +1,99 @@
|
||||
#!/usr/bin/env python3
|
||||
"""手动登录并保存浏览器登录态（cookies + localStorage）。
|
||||
|
||||
目的: 绕过图形验证码——人工完成一次验证码登录后，
|
||||
cookies + localStorage 序列化到 JSON 文件，后续用例自动复用。
|
||||
|
||||
用法:
|
||||
python tests/web/admin/save_auth.py
|
||||
|
||||
流程:
|
||||
1. 脚本打开浏览器到登录页
|
||||
2. 你在浏览器中手动输入账号、密码、完成验证码并点击登录
|
||||
3. 登录成功后按 Enter 键，脚本自动保存登录态
|
||||
4. 后续 pytest 用例自动复用
|
||||
|
||||
生成的 auth 文件:
|
||||
tests/web/auth/super_admin_chromium.json
|
||||
"""
|
||||
|
||||
import argparse
|
||||
import sys
|
||||
from pathlib import Path
|
||||
|
||||
sys.path.insert(0, str(Path(__file__).parent.parent.parent))
|
||||
|
||||
from tests.config.test_config import load_config
|
||||
|
||||
|
||||
def main():
|
||||
parser = argparse.ArgumentParser(
|
||||
description="手动登录并保存浏览器登录态（绕过图形验证码）"
|
||||
)
|
||||
parser.add_argument(
|
||||
"--role",
|
||||
default="super_admin",
|
||||
help="登录角色（默认: super_admin），会体现在文件名中",
|
||||
)
|
||||
parser.add_argument(
|
||||
"--browser",
|
||||
default="chromium",
|
||||
choices=["chromium", "firefox", "webkit"],
|
||||
help="浏览器类型（默认: chromium）",
|
||||
)
|
||||
args = parser.parse_args()
|
||||
|
||||
config = load_config()
|
||||
web_config = config["admin"]
|
||||
base_url = web_config["base_url"]
|
||||
login_url = f"{base_url}/#/login"
|
||||
|
||||
from playwright.sync_api import sync_playwright
|
||||
|
||||
with sync_playwright() as p:
|
||||
browser_launcher = getattr(p, args.browser)
|
||||
browser = browser_launcher.launch(headless=False)
|
||||
context = browser.new_context(
|
||||
viewport={"width": 1920, "height": 1080},
|
||||
locale="zh-CN",
|
||||
)
|
||||
page = context.new_page()
|
||||
|
||||
print(f"\n🔗 打开登录页: {login_url}")
|
||||
page.goto(login_url)
|
||||
|
||||
print(f"\n{'='*60}")
|
||||
print(f"👤 角色: {args.role}")
|
||||
print(f" 请在浏览器中手动完成登录（输入账号密码 + 验证码）")
|
||||
print(f" 登录成功后回到此处按 Enter 键保存登录态...")
|
||||
print(f"{'='*60}\n")
|
||||
|
||||
input(">>> 按 Enter 保存登录态...")
|
||||
|
||||
# 检查是否真的登录成功了
|
||||
current = page.url
|
||||
if "/login" in current or "/#/login" in current:
|
||||
print(f"\n⚠️ 当前仍在登录页: {current}")
|
||||
print(" 要保存吗？(y/n): ", end="")
|
||||
choice = input().strip().lower()
|
||||
if choice != "y":
|
||||
print("已取消。")
|
||||
browser.close()
|
||||
sys.exit(0)
|
||||
|
||||
print(f"\n✅ 当前页面: {current}")
|
||||
|
||||
auth_dir = Path(web_config.get("storage_state_dir", "tests/web/auth"))
|
||||
auth_dir.mkdir(parents=True, exist_ok=True)
|
||||
auth_file = auth_dir / f"{args.role}_{args.browser}.json"
|
||||
|
||||
context.storage_state(path=str(auth_file))
|
||||
print(f"💾 登录态已保存到: {auth_file}")
|
||||
|
||||
browser.close()
|
||||
|
||||
print(f"\n🎉 现在可以跑了: pytest tests/web/admin/ -m p0")
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
main()
|
||||
@@ -0,0 +1,74 @@
|
||||
"""管理端登录测试用例。
|
||||
|
||||
标记:
|
||||
pytest -m admin # 仅管理端用例
|
||||
pytest -m p0 # P0 冒烟
|
||||
pytest -m smoke # 冒烟
|
||||
"""
|
||||
|
||||
import pytest
|
||||
from playwright.sync_api import Page
|
||||
|
||||
pytestmark = [pytest.mark.admin]
|
||||
|
||||
|
||||
class TestAdminSmoke:
|
||||
"""管理端冒烟 — 验证预登录态。"""
|
||||
|
||||
@pytest.mark.p0
|
||||
@pytest.mark.smoke
|
||||
def test_admin_access_with_saved_auth(self, page: Page, admin_config, ensure_login):
|
||||
"""验证预登录态可直接访问管理后台。"""
|
||||
ensure_login("super_admin")
|
||||
page.goto(admin_config["base_url"])
|
||||
page.wait_for_timeout(2000)
|
||||
assert "#/login" not in page.url and "/login" not in page.url, (
|
||||
"预登录态失效！请运行: python tests/web/admin/save_auth.py"
|
||||
)
|
||||
|
||||
@pytest.mark.p0
|
||||
@pytest.mark.smoke
|
||||
def test_team_leader_access(self, page: Page, admin_config, ensure_login):
|
||||
"""验证车队长预登录态有效。"""
|
||||
ensure_login("team_leader")
|
||||
page.goto(admin_config["base_url"])
|
||||
page.wait_for_timeout(2000)
|
||||
assert "#/login" not in page.url and "/login" not in page.url
|
||||
|
||||
@pytest.mark.p0
|
||||
@pytest.mark.smoke
|
||||
def test_dashboard_loads(self, page: Page, admin_config, ensure_login):
|
||||
"""验证首页可正常加载。"""
|
||||
ensure_login("super_admin")
|
||||
page.goto(admin_config["base_url"])
|
||||
assert page.title(), "首页应显示页面标题"
|
||||
|
||||
|
||||
class TestLoginPage:
|
||||
"""登录页交互验证。"""
|
||||
|
||||
@pytest.mark.p1
|
||||
def test_login_page_accessible(self, page: Page, admin_config):
|
||||
"""验证登录页可正常访问。"""
|
||||
page.goto(f"{admin_config['base_url']}/#/login")
|
||||
assert page.get_by_placeholder("请输入用户名").is_visible()
|
||||
|
||||
@pytest.mark.p1
|
||||
def test_login_page_elements(self, page: Page, admin_config):
|
||||
"""验证登录页元素完整。"""
|
||||
page.goto(f"{admin_config['base_url']}/#/login")
|
||||
assert page.get_by_placeholder("请输入用户名").is_visible()
|
||||
assert page.get_by_placeholder("请输入密码").is_visible()
|
||||
assert page.get_by_role("button", name="登录").is_visible()
|
||||
|
||||
@pytest.mark.p1
|
||||
def test_session_redirect(self, page: Page, admin_config, ensure_login):
|
||||
"""验证已登录用户访问登录页被重定向。"""
|
||||
ensure_login("super_admin")
|
||||
page.goto(admin_config["base_url"])
|
||||
page.wait_for_timeout(2000)
|
||||
assert "#/login" not in page.url
|
||||
|
||||
page.goto(f"{admin_config['base_url']}/#/login")
|
||||
page.wait_for_timeout(2000)
|
||||
assert "#/login" not in page.url and "/login" not in page.url
|
||||
Reference in New Issue
Block a user