TBC/tests/material_library/material_library_page.py
d-robotics 633a797226 AutoFlow v2.0: 合并 Test (Robogo) + data-loop-automation (D-Cloud) 为统一平台
- 16 个业务模块,856 个测试用例,40 个 E2E 测试
- 单一 React 19 前端 + PlatformSwitcher 二合一切换
- Flask 后端支持 scenario/dcloud_module/dcloud_e2e/dcloud_all 四种任务类型
- E2E 测试面板:API 全链路(8条) + UI 点击(3条) + 分步测试(3个)
- SSE 实时日志流 + 飞书告警 + 定时调度
- 完整还原原 ToB 平台 TestPanel E2E 模块
2026-06-23 11:48:29 +08:00

617 lines
22 KiB
Python
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

"""
素材库模块 Page Object
封装素材库的UI元素和操作
功能: 工作流素材管理、文件上传、自动挂载
操作: 新建文件夹、上传、复制路径
说明: 工作流启动时自动挂载到 input 目录
"""
from playwright.sync_api import Page, Locator
from typing import List, Optional
import time
from tests.base.base_page import BasePage
from tests.logger import log_ui
class MaterialLibraryPage(BasePage):
"""素材库页面"""
# 页面URL
url = "https://cloud-fat.d-robotics.cc/d-cloud/data-create/library"
# 元素选择器
SELECTORS = {
# 页面标题和面包屑
"page_title": "text=素材库",
"breadcrumb": ".ant-breadcrumb",
# 操作按钮
"new_folder_button": "button:has-text('新建文件夹')",
"upload_button": "button:has-text('上 传')", # 注意:按钮文本有空格
"refresh_button": "button:has-text('刷新')",
"back_button": "button:has-text('返回上一级')",
"copy_path_button": "button:has-text('复制路径')",
"delete_button": "button:has-text('删除')",
# 文件列表相关 - 页面使用卡片式文件列表,不是表格
# 根据实际页面,文件项是img+text组合
"file_list_container": "body", # 文件列表容器
"file_item": ".file-item, [class*='file'], [class*='item']", # 单个文件项
# 文件夹/文件图标
"folder_icon": "svg[data-icon='folder']",
"file_icon": "svg[data-icon='file']",
# 搜索框
"search_input": "input[placeholder*='搜索']",
"clear_search_button": ".ant-input-clear-icon",
# 空状态
"empty_state": ".ant-empty",
"empty_state_text": ".ant-empty-description",
# 加载状态
"loading_spinner": ".ant-spin",
# 对话框
"dialog": ".ant-modal",
"dialog_title": ".ant-modal-title",
"dialog_input": "input[placeholder*='请输入文件夹名称']",
"dialog_confirm_button": "button:has-text('确 定')",
"dialog_cancel_button": "button:has-text('取 消')",
"dialog_close_button": ".ant-modal-close",
# 上传相关
"upload_dialog": ".ant-upload",
"upload_input": "input[type='file']",
"upload_drop_area": ".ant-upload-drag-container",
"upload_list": ".ant-upload-list",
"upload_progress": ".ant-progress",
"upload_success_icon": ".ant-upload-success-icon",
# 文件操作菜单
"file_menu": ".ant-dropdown-menu",
"menu_copy_path": ".ant-dropdown-menu-item:has-text('复制路径')",
"menu_download": ".ant-dropdown-menu-item:has-text('下载')",
"menu_delete": ".ant-dropdown-menu-item:has-text('删除')",
"menu_rename": ".ant-dropdown-menu-item:has-text('重命名')",
# 路径导航
"path_breadcrumb": ".ant-breadcrumb",
"path_item": ".ant-breadcrumb-link",
"current_path": ".ant-breadcrumb-link:last-child",
}
def __init__(self, page: Page):
super().__init__(page)
def navigate_to_material_library(self) -> None:
"""导航到素材库页面"""
self.navigate(self.url)
self.wait_for_page_ready()
self.wait_for_file_table_load()
log_ui.info("已导航到素材库页面")
def wait_for_file_table_load(self, timeout: int = 15000) -> None:
"""等待文件列表加载完成(支持空状态)
说明:页面不是表格结构,文件项是img+text组合
"""
# 安全等待加载动画消失(忽略如果不存在)
try:
self.page.locator(self.SELECTORS["loading_spinner"]).wait_for(state="hidden", timeout=5000)
except Exception:
pass # 加载动画可能不存在,继续执行
# 等待页面关键元素出现:新建文件夹按钮或上传按钮
# 这表示页面已加载完成
start_time = self.page.evaluate("Date.now()")
while True:
# 检查新建文件夹按钮是否可见
if self.page.locator(self.SELECTORS["new_folder_button"]).is_visible():
return
# 检查上传按钮是否可见
if self.page.locator(self.SELECTORS["upload_button"]).is_visible():
return
# 检查空状态
if self.page.locator(self.SELECTORS["empty_state"]).is_visible():
return
elapsed = self.page.evaluate("Date.now()") - start_time
if elapsed > timeout:
raise TimeoutError(f"等待页面加载超时: 关键元素未在 {timeout}ms 内出现")
self.page.wait_for_timeout(200)
# ==================== 基础操作 ====================
def click_new_folder(self) -> None:
"""点击新建文件夹按钮"""
self.click(self.SELECTORS["new_folder_button"])
log_ui.debug("点击新建文件夹按钮")
def click_upload(self) -> None:
"""点击上传按钮"""
self.click(self.SELECTORS["upload_button"])
log_ui.debug("点击上传按钮")
def click_refresh(self) -> None:
"""点击刷新按钮"""
self.click(self.SELECTORS["refresh_button"])
self.wait_for_file_table_load()
log_ui.debug("点击刷新按钮")
def click_back(self) -> None:
"""点击返回上一级按钮"""
self.click(self.SELECTORS["back_button"])
self.wait_for_file_table_load()
log_ui.debug("点击返回上一级按钮")
# ==================== 文件夹操作 ====================
def create_folder(self, folder_name: str) -> bool:
"""
创建文件夹
Args:
folder_name: 文件夹名称
Returns:
bool: 是否创建成功
"""
try:
# 点击新建文件夹按钮
self.click_new_folder()
# 等待对话框出现
if not self.wait_for_selector_safe(self.SELECTORS["dialog"], state="visible", timeout=3000):
log_ui.warning("创建文件夹对话框未出现")
return False
# 输入文件夹名称
dialog_input = self.page.locator(self.SELECTORS["dialog_input"])
dialog_input.fill(folder_name)
# 点击确定按钮
self.click(self.SELECTORS["dialog_confirm_button"])
# 等待对话框关闭
self.wait_for_element_hidden(self.SELECTORS["dialog"])
# 等待表格刷新
self.wait_for_file_table_load()
log_ui.info(f"创建文件夹: {folder_name}")
return True
except Exception as e:
log_ui.error(f"创建文件夹失败: {str(e)}")
return False
def enter_folder(self, folder_name: str) -> bool:
"""
进入指定文件夹
Args:
folder_name: 文件夹名称
Returns:
bool: 是否成功进入
"""
try:
row = self.get_file_row(folder_name)
if row:
# 点击文件夹名称(通常是一个链接)
folder_link = row.locator(self.SELECTORS["file_name_column"])
folder_link.click()
# 等待页面加载
self.wait_for_file_table_load()
# 检查当前路径是否包含文件夹名称
current_path = self.get_current_path()
if folder_name in current_path:
log_ui.info(f"进入文件夹: {folder_name}")
return True
return False
except Exception as e:
log_ui.error(f"进入文件夹失败: {str(e)}")
return False
# ==================== 文件操作 ====================
def upload_file(self, file_path: str) -> bool:
"""
上传文件
Args:
file_path: 本地文件路径
Returns:
bool: 是否上传成功
"""
try:
# 点击上传按钮
self.click_upload()
# 等待上传对话框出现
if not self.wait_for_selector_safe(self.SELECTORS["upload_input"], state="visible", timeout=3000):
log_ui.warning("上传文件对话框未出现")
return False
# 设置文件输入
file_input = self.page.locator(self.SELECTORS["upload_input"])
file_input.set_input_files(file_path)
# 等待上传进度完成
self.wait_for_element_hidden(self.SELECTORS["upload_progress"], timeout=60000) # 最长等待60秒
# 检查上传成功标志
if self.wait_for_selector_safe(self.SELECTORS["upload_success_icon"], state="visible", timeout=5000):
# 关闭上传对话框(如果有)
if self.wait_for_selector_safe(self.SELECTORS["dialog_close_button"], state="visible", timeout=2000):
self.click(self.SELECTORS["dialog_close_button"])
# 等待表格刷新
self.wait_for_file_table_load()
log_ui.info(f"上传文件成功: {file_path}")
return True
log_ui.warning("文件上传可能未完成")
return False
except Exception as e:
log_ui.error(f"上传文件失败: {str(e)}")
return False
def copy_file_path(self, file_name: str) -> bool:
"""
复制文件路径
Args:
file_name: 文件名
Returns:
bool: 是否复制成功
"""
try:
row = self.get_file_row(file_name)
if row:
# 找到复制路径按钮(可能在操作列)
copy_btn = row.locator("button:has-text('复制路径')")
if copy_btn.count() > 0:
copy_btn.click()
# 检查是否有成功提示(通常是短暂出现的消息)
# 这里可以添加对成功提示的检查
log_ui.info(f"复制文件路径: {file_name}")
return True
# 如果没有直接的按钮,可能需要在操作菜单中
menu_btn = row.locator("button:has-text('操作')")
if menu_btn.count() > 0:
menu_btn.click()
self.click(self.SELECTORS["menu_copy_path"])
log_ui.info(f"通过菜单复制文件路径: {file_name}")
return True
log_ui.warning(f"未找到文件或复制路径按钮: {file_name}")
return False
except Exception as e:
log_ui.error(f"复制文件路径失败: {str(e)}")
return False
def delete_file(self, file_name: str) -> bool:
"""
删除文件/文件夹
Args:
file_name: 文件名
Returns:
bool: 是否删除成功
"""
try:
row = self.get_file_row(file_name)
if row:
# 找到删除按钮(可能在操作列)
delete_btn = row.locator("button:has-text('删除')")
if delete_btn.count() > 0:
delete_btn.click()
else:
# 如果没有直接的按钮,可能需要在操作菜单中
menu_btn = row.locator("button:has-text('操作')")
if menu_btn.count() > 0:
menu_btn.click()
self.click(self.SELECTORS["menu_delete"])
# 等待确认对话框
if self.wait_for_selector_safe(self.SELECTORS["dialog"], state="visible", timeout=3000):
# 点击确认删除
self.click(self.SELECTORS["dialog_confirm_button"])
# 等待对话框关闭
self.wait_for_element_hidden(self.SELECTORS["dialog"])
# 等待表格刷新
self.wait_for_file_table_load()
log_ui.info(f"删除文件: {file_name}")
return True
log_ui.warning(f"未找到文件或删除按钮: {file_name}")
return False
except Exception as e:
log_ui.error(f"删除文件失败: {str(e)}")
return False
# ==================== 文件列表操作 ====================
def get_file_list(self) -> List[dict]:
"""
获取文件/文件夹列表
Returns:
List[dict]: 文件信息列表,每个元素包含:
- name: 文件名
- type: 文件类型 (folder/file)
- size: 文件大小 (可选)
- modified: 修改时间 (可选)
"""
try:
files = []
# 使用JavaScript直接获取文件项
# 根据页面结构,文件项是img+text组合
file_data = self.page.evaluate('''() => {
const items = [];
const knownFiles = ['3d', 'test', '1732775567.084000.jpg', '20250630-133345.png'];
// 查找所有文本节点
const walker = document.createTreeWalker(
document.body,
NodeFilter.SHOW_TEXT,
null,
false
);
let node;
while (node = walker.nextNode()) {
const text = node.textContent?.trim();
// 过滤掉空文本和已知的UI文本
if (text && text.length > 0 && !text.includes('新建文件夹') && !text.includes('上传')) {
// 检查是否是文件名(包含扩展名或是已知文件)
const hasExtension = /\\.[a-zA-Z0-9]{2,4}$/.test(text);
const isKnown = knownFiles.some(f => text.includes(f));
if (hasExtension || isKnown || text.length < 30) {
items.push({
name: text,
type: hasExtension ? 'file' : 'folder'
});
}
}
}
return items;
}''')
files = file_data if file_data else []
log_ui.info(f"获取到 {len(files)} 个文件/文件夹")
return files
except Exception as e:
log_ui.error(f"获取文件列表失败: {str(e)}")
return []
def get_file_count(self) -> int:
"""
获取文件数量
Returns:
int: 文件数量
"""
try:
# 如果表格为空状态,返回0
if self.page.locator(self.SELECTORS["empty_state"]).is_visible():
return 0
# 获取文件列表长度
files = self.get_file_list()
return len(files)
except Exception as e:
log_ui.error(f"获取文件数量失败: {str(e)}")
return 0
def get_file_row(self, file_name: str) -> Optional[Locator]:
"""
根据文件名获取文件元素
Args:
file_name: 文件名
Returns:
Optional[Locator]: 包含文件名的文本元素,如果未找到则返回None
"""
try:
# 查找包含文件名的文本元素
# 页面结构是img+text,直接用文本定位
file_locator = self.page.locator(f"text={file_name}").first
if file_locator.count() > 0:
return file_locator
return None
except Exception as e:
log_ui.error(f"查找文件元素失败: {str(e)}")
return None
def is_file_exists(self, file_name: str) -> bool:
"""
检查文件是否存在
Args:
file_name: 文件名
Returns:
bool: 是否存在
"""
row = self.get_file_row(file_name)
return row is not None
# ==================== 搜索操作 ====================
def search_files(self, keyword: str) -> bool:
"""
搜索文件
Args:
keyword: 搜索关键词
Returns:
bool: 是否成功执行搜索
"""
try:
# 使用基类的search方法
success = self.search(keyword, "搜索")
if success:
# 等待搜索结果
self.wait_for_file_table_load()
log_ui.info(f"搜索文件: {keyword}")
return success
except Exception as e:
log_ui.error(f"搜索文件失败: {str(e)}")
return False
def clear_search(self) -> bool:
"""
清除搜索条件
Returns:
bool: 是否成功清除
"""
try:
# 使用基类的clear_search方法
success = self.clear_search("搜索")
if success:
# 等待表格刷新
self.wait_for_file_table_load()
log_ui.info("清除搜索条件")
return success
except Exception as e:
log_ui.error(f"清除搜索失败: {str(e)}")
return False
# ==================== 路径操作 ====================
def get_current_path(self) -> str:
"""
获取当前路径
Returns:
str: 当前路径
"""
try:
# 获取面包屑文本
breadcrumb = self.page.locator(self.SELECTORS["path_breadcrumb"])
if breadcrumb.is_visible():
path_items = breadcrumb.locator(self.SELECTORS["path_item"]).all_text_contents()
return " / ".join(path_items)
return ""
except Exception as e:
log_ui.error(f"获取当前路径失败: {str(e)}")
return ""
def navigate_to_path(self, path: str) -> bool:
"""
导航到指定路径(通过面包屑)
Args:
path: 路径名称(面包屑项)
Returns:
bool: 是否导航成功
"""
try:
# 找到对应的面包屑项
path_item = self.page.locator(f"{self.SELECTORS['path_item']}:has-text('{path}')")
if path_item.is_visible():
path_item.click()
self.wait_for_file_table_load()
log_ui.info(f"导航到路径: {path}")
return True
return False
except Exception as e:
log_ui.error(f"导航到路径失败: {str(e)}")
return False
# ==================== 批量操作 ====================
def select_all_files(self) -> bool:
"""
全选文件
Returns:
bool: 是否成功全选
"""
try:
# 查找全选复选框(通常在表头第一个单元格)
select_all_checkbox = self.page.locator(f"{self.SELECTORS['file_table_headers']} input[type='checkbox']")
if select_all_checkbox.is_visible():
select_all_checkbox.check()
log_ui.info("全选文件")
return True
return False
except Exception as e:
log_ui.error(f"全选文件失败: {str(e)}")
return False
def get_selected_count(self) -> int:
"""
获取选中文件数量
Returns:
int: 选中文件数量
"""
try:
# 查找已选中的复选框
selected_checkboxes = self.page.locator(f"{self.SELECTORS['file_table_rows']} input[type='checkbox']:checked")
return selected_checkboxes.count()
except Exception as e:
log_ui.error(f"获取选中文件数量失败: {str(e)}")
return 0
# ==================== 断言方法 ====================
def expect_file_exists(self, file_name: str) -> None:
"""断言文件存在"""
assert self.is_file_exists(file_name), f"文件不存在: {file_name}"
def expect_file_count(self, expected_count: int) -> None:
"""断言文件数量"""
actual_count = self.get_file_count()
assert actual_count == expected_count, f"文件数量不匹配: 期望 {expected_count}, 实际 {actual_count}"
def expect_current_path_contains(self, path_part: str) -> None:
"""断言当前路径包含指定部分"""
current_path = self.get_current_path()
assert path_part in current_path, f"当前路径不包含 '{path_part}': {current_path}"