""" 素材库模块 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}"