enterprise-mini.page.ts 14 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426
  1. import { TIMEOUTS } from '../../utils/timeouts';
  2. import { Page, Locator, expect } from '@playwright/test';
  3. /**
  4. * 企业小程序 H5 URL
  5. */
  6. const MINI_BASE_URL = process.env.E2E_BASE_URL || 'http://localhost:8080';
  7. const MINI_LOGIN_URL = `${MINI_BASE_URL}/mini`;
  8. /**
  9. * 企业小程序 Page Object
  10. *
  11. * 用于企业小程序 E2E 测试
  12. * H5 页面路径: /mini
  13. *
  14. * 主要功能:
  15. * - 小程序登录(手机号 + 密码)
  16. * - Token 管理
  17. * - 页面导航和验证
  18. *
  19. * @example
  20. * ```typescript
  21. * const miniPage = new EnterpriseMiniPage(page);
  22. * await miniPage.goto();
  23. * await miniPage.login('13800138000', 'password123');
  24. * await miniPage.expectLoginSuccess();
  25. * ```
  26. */
  27. export class EnterpriseMiniPage {
  28. readonly page: Page;
  29. // ===== 页面级选择器 =====
  30. /** 登录页面容器 */
  31. readonly loginPage: Locator;
  32. /** 页面标题 */
  33. readonly pageTitle: Locator;
  34. // ===== 登录表单选择器 =====
  35. /** 手机号输入框 */
  36. readonly phoneInput: Locator;
  37. /** 密码输入框 */
  38. readonly passwordInput: Locator;
  39. /** 登录按钮 */
  40. readonly loginButton: Locator;
  41. // ===== 主页选择器(登录后) =====
  42. /** 用户信息显示区域 */
  43. readonly userInfo: Locator;
  44. /** 退出登录按钮 */
  45. readonly logoutButton: Locator;
  46. constructor(page: Page) {
  47. this.page = page;
  48. // 初始化登录页面选择器
  49. // Taro 组件在 H5 渲染时会传递 data-testid 到 DOM (使用 taro-view-core 等组件)
  50. this.loginPage = page.getByTestId('mini-login-page');
  51. this.pageTitle = page.getByTestId('mini-page-title');
  52. // 登录表单选择器 - 使用 data-testid
  53. this.phoneInput = page.getByTestId('mini-phone-input');
  54. this.passwordInput = page.getByTestId('mini-password-input');
  55. this.loginButton = page.getByTestId('mini-login-button');
  56. // 主页选择器(登录后可用)
  57. this.userInfo = page.getByTestId('mini-user-info');
  58. // 设置按钮
  59. this.settingsButton = page.getByText('设置').nth(1);
  60. // 退出登录按钮 - 使用 getByText 而非 getByRole
  61. this.logoutButton = page.getByText('退出登录');
  62. }
  63. // ===== 导航和基础验证 =====
  64. /**
  65. * 移除开发服务器的覆盖层 iframe(防止干扰测试)
  66. */
  67. private async removeDevOverlays(): Promise<void> {
  68. await this.page.evaluate(() => {
  69. // 移除 react-refresh-overlay 和 webpack-dev-server-client-overlay
  70. const overlays = document.querySelectorAll('#react-refresh-overlay, #webpack-dev-server-client-overlay');
  71. overlays.forEach(overlay => overlay.remove());
  72. // 移除 vConsole 开发者工具覆盖层
  73. const vConsole = document.querySelector('#__vconsole');
  74. if (vConsole) {
  75. vConsole.remove();
  76. }
  77. });
  78. }
  79. /**
  80. * 导航到企业小程序 H5 登录页面
  81. */
  82. async goto(): Promise<void> {
  83. await this.page.goto(MINI_LOGIN_URL);
  84. // 移除开发服务器的覆盖层
  85. await this.removeDevOverlays();
  86. // 使用 auto-waiting 机制,等待页面容器可见
  87. await this.expectToBeVisible();
  88. }
  89. /**
  90. * 验证登录页面关键元素可见
  91. */
  92. async expectToBeVisible(): Promise<void> {
  93. // 等待页面容器可见
  94. await this.loginPage.waitFor({ state: 'visible', timeout: TIMEOUTS.PAGE_LOAD });
  95. // 验证页面标题
  96. await this.pageTitle.waitFor({ state: 'visible', timeout: TIMEOUTS.ELEMENT_VISIBLE_SHORT });
  97. }
  98. // ===== 登录功能方法 =====
  99. /**
  100. * 填写手机号
  101. * @param phone 手机号(11位数字)
  102. *
  103. * 注意:使用 fill() 方法并添加验证步骤确保密码输入完整
  104. * Taro Input 组件需要完整的事件流才能正确更新 react-hook-form 状态
  105. */
  106. async fillPhone(phone: string): Promise<void> {
  107. // 先移除覆盖层,确保输入可操作
  108. await this.removeDevOverlays();
  109. // 点击聚焦,然后清空(使用 Ctrl+A + Backspace 模拟用户操作)
  110. await this.phoneInput.click();
  111. // 等待元素聚焦
  112. await this.page.waitForTimeout(100);
  113. // 使用 type 方法输入,会自动覆盖现有内容
  114. await this.phoneInput.type(phone, { delay: 50 });
  115. // 等待表单验证更新
  116. await this.page.waitForTimeout(200);
  117. }
  118. /**
  119. * 填写密码
  120. * @param password 密码(6-20位)
  121. *
  122. * 注意:taro-input-core 是 Taro 框架的自定义组件,不是标准 HTML 元素
  123. * 需要使用 evaluate() 直接操作 DOM 元素来设置值和触发事件
  124. */
  125. async fillPassword(password: string): Promise<void> {
  126. await this.removeDevOverlays();
  127. await this.passwordInput.click();
  128. await this.page.waitForTimeout(100);
  129. // taro-input-core 不是标准 input 元素,使用 JS 直接设置值并触发事件
  130. await this.passwordInput.evaluate((el, val) => {
  131. // 尝试找到内部的真实 input 元素
  132. const nativeInput = el.querySelector('input') || el;
  133. if (nativeInput instanceof HTMLInputElement) {
  134. nativeInput.value = val;
  135. nativeInput.dispatchEvent(new Event('input', { bubbles: true }));
  136. nativeInput.dispatchEvent(new Event('change', { bubbles: true }));
  137. } else {
  138. // 如果找不到 input 元素,设置 value 属性
  139. (el as any).value = val;
  140. el.dispatchEvent(new Event('input', { bubbles: true }));
  141. el.dispatchEvent(new Event('change', { bubbles: true }));
  142. }
  143. }, password);
  144. await this.page.waitForTimeout(300);
  145. }
  146. /**
  147. * 点击登录按钮
  148. */
  149. async clickLoginButton(): Promise<void> {
  150. // 使用 force: true 避免被开发服务器的覆盖层阻止
  151. await this.loginButton.click({ force: true });
  152. }
  153. /**
  154. * 执行登录操作(完整流程)
  155. * @param phone 手机号
  156. * @param password 密码
  157. */
  158. async login(phone: string, password: string): Promise<void> {
  159. await this.fillPhone(phone);
  160. await this.fillPassword(password);
  161. await this.clickLoginButton();
  162. }
  163. /**
  164. * 验证登录成功
  165. *
  166. * 登录成功后应该跳转到主页或显示用户信息
  167. */
  168. async expectLoginSuccess(): Promise<void> {
  169. // 使用 auto-waiting 机制,等待 URL 变化或用户信息显示
  170. // 小程序登录成功后会跳转到 dashboard 页面
  171. // 等待 URL 变化,使用 Promise.race 实现超时
  172. const urlChanged = await this.page.waitForURL(
  173. url => url.pathname.includes('/dashboard') || url.pathname.includes('/pages/yongren/dashboard'),
  174. { timeout: TIMEOUTS.PAGE_LOAD }
  175. ).then(() => true).catch(() => false);
  176. // 如果 URL 没有变化,检查 token 是否被存储
  177. if (!urlChanged) {
  178. const token = await this.getToken();
  179. if (!token) {
  180. throw new Error('登录失败:URL 未跳转且 token 未存储');
  181. }
  182. }
  183. }
  184. /**
  185. * 验证登录失败(错误提示显示)
  186. * @param expectedErrorMessage 预期的错误消息(可选)
  187. */
  188. async expectLoginError(expectedErrorMessage?: string): Promise<void> {
  189. // 等待一下,让后端响应或前端验证生效
  190. await this.page.waitForTimeout(1000);
  191. // 验证仍然在登录页面(未跳转)
  192. const currentUrl = this.page.url();
  193. expect(currentUrl).toContain('/mini');
  194. // 验证登录页面容器仍然可见
  195. await expect(this.loginPage).toBeVisible();
  196. // 如果提供了预期的错误消息,尝试验证
  197. if (expectedErrorMessage) {
  198. // 尝试查找错误消息(可能在 Toast、Modal 或表单验证中)
  199. const errorElement = this.page.getByText(expectedErrorMessage, { exact: false }).first();
  200. await errorElement.isVisible().catch(() => false);
  201. // 不强制要求错误消息可见,因为后端可能不会返回错误
  202. }
  203. }
  204. // ===== Token 管理方法 =====
  205. /**
  206. * 获取当前存储的 token
  207. * @returns token 字符串,如果不存在则返回 null
  208. *
  209. * 注意:Taro.getStorageSync 在 H5 环境下映射到 localStorage
  210. * Taro.setStorageSync 会将数据包装为 JSON 格式:{"data":"VALUE"}
  211. * 因此需要解析 JSON 并提取 data 字段
  212. *
  213. * Taro H5 可能使用以下键名格式:
  214. * - 直接键名: 'enterprise_token'
  215. * - 带前缀: 'taro_app_storage_key'
  216. * - 或者其他变体
  217. */
  218. async getToken(): Promise<string | null> {
  219. const result = await this.page.evaluate(() => {
  220. // 尝试各种可能的键名
  221. // 1. 直接键名 - Taro 的 setStorageSync 将数据包装为 {"data":"VALUE"}
  222. const token = localStorage.getItem('enterprise_token');
  223. if (token) {
  224. try {
  225. // Taro 格式: {"data":"JWT_TOKEN"}
  226. const parsed = JSON.parse(token);
  227. if (parsed.data) {
  228. return parsed.data;
  229. }
  230. return token;
  231. } catch {
  232. return token;
  233. }
  234. }
  235. // 2. 获取所有 localStorage 键,查找可能的 token
  236. const keys = Object.keys(localStorage);
  237. const prefixedKeys = keys.filter(k => k.includes('token') || k.includes('auth'));
  238. for (const key of prefixedKeys) {
  239. const value = localStorage.getItem(key);
  240. if (value) {
  241. try {
  242. // 尝试解析 Taro 格式
  243. const parsed = JSON.parse(value);
  244. if (parsed.data && parsed.data.length > 20) { // JWT token 通常很长
  245. return parsed.data;
  246. }
  247. } catch {
  248. // 不是 JSON 格式,直接使用
  249. if (value.length > 20) {
  250. return value;
  251. }
  252. }
  253. }
  254. }
  255. // 3. 其他常见键名
  256. const otherTokens = [
  257. localStorage.getItem('token'),
  258. localStorage.getItem('auth_token'),
  259. sessionStorage.getItem('token'),
  260. sessionStorage.getItem('auth_token')
  261. ].filter(Boolean);
  262. for (const t of otherTokens) {
  263. if (t) {
  264. try {
  265. const parsed = JSON.parse(t);
  266. if (parsed.data) return parsed.data;
  267. } catch {
  268. if (t.length > 20) return t;
  269. }
  270. }
  271. }
  272. return null;
  273. });
  274. return result;
  275. }
  276. /**
  277. * 设置 token(用于测试前置条件)
  278. * @param token token 字符串
  279. */
  280. async setToken(token: string): Promise<void> {
  281. await this.page.evaluate((t) => {
  282. localStorage.setItem('token', t);
  283. localStorage.setItem('auth_token', t);
  284. }, token);
  285. }
  286. /**
  287. * 清除所有认证相关的存储
  288. */
  289. async clearAuth(): Promise<void> {
  290. await this.page.evaluate(() => {
  291. // 清除企业小程序相关的认证数据
  292. localStorage.removeItem('enterprise_token');
  293. localStorage.removeItem('enterpriseUserInfo');
  294. // 清除其他常见 token 键
  295. localStorage.removeItem('token');
  296. localStorage.removeItem('auth_token');
  297. sessionStorage.removeItem('token');
  298. sessionStorage.removeItem('auth_token');
  299. });
  300. }
  301. // ===== 主页元素验证方法 =====
  302. /**
  303. * 验证主页元素可见(登录后)
  304. * 根据实际小程序主页结构调整
  305. */
  306. async expectHomePageVisible(): Promise<void> {
  307. // 使用 auto-waiting 机制,等待主页元素可见
  308. // 注意:此方法将在 Story 12.5 E2E 测试中使用,当前仅提供基础结构
  309. // 根据实际小程序主页的 data-testid 调整
  310. const dashboard = this.page.getByTestId('mini-dashboard');
  311. await dashboard.waitFor({ state: 'visible', timeout: TIMEOUTS.PAGE_LOAD });
  312. }
  313. /**
  314. * 获取用户信息显示的文本
  315. * @returns 用户信息文本
  316. */
  317. async getUserInfoText(): Promise<string | null> {
  318. const userInfo = this.userInfo;
  319. const count = await userInfo.count();
  320. if (count === 0) {
  321. return null;
  322. }
  323. return await userInfo.textContent();
  324. }
  325. // ===== 退出登录方法 =====
  326. /**
  327. * 退出登录
  328. *
  329. * 注意:企业小程序的退出登录按钮在设置页面中,需要先点击设置按钮
  330. */
  331. async logout(): Promise<void> {
  332. // 先点击设置按钮进入设置页面
  333. await this.settingsButton.click();
  334. await this.page.waitForTimeout(500);
  335. // 滚动到页面底部,确保退出登录按钮可见
  336. await this.page.evaluate(() => {
  337. window.scrollTo(0, document.body.scrollHeight);
  338. });
  339. await this.page.waitForTimeout(300);
  340. // 点击退出登录按钮(使用 JS 直接点击来绕过 Taro 组件的事件处理)
  341. await this.logoutButton.evaluate((el) => {
  342. // 查找包含该文本的可点击元素
  343. const button = el.closest('button') || el.closest('[role="button"]') || el;
  344. (button as HTMLElement).click();
  345. });
  346. // 等待确认对话框出现
  347. await this.page.waitForTimeout(1500);
  348. // 处理确认对话框 - Taro.showModal 会显示一个确认对话框
  349. // 使用更具体的选择器,因为对话框有两个按钮(取消/确定)
  350. const _confirmButton = this.page.locator('.taro-modal__footer').getByText('确定').first();
  351. // 尝试使用 JS 直接点击确定按钮
  352. const dialogClicked = await this.page.evaluate(() => {
  353. // 查找所有"确定"文本的元素
  354. const buttons = Array.from(document.querySelectorAll('*'));
  355. const confirmBtn = buttons.find(el => el.textContent === '确定' && el.textContent?.trim() === '确定');
  356. if (confirmBtn) {
  357. (confirmBtn as HTMLElement).click();
  358. return true;
  359. }
  360. return false;
  361. });
  362. if (!dialogClicked) {
  363. // 如果 JS 点击失败,尝试使用 Playwright 点击
  364. await this.page.getByText('确定').click({ force: true });
  365. }
  366. // 等待退出登录完成并跳转到登录页面
  367. await this.page.waitForTimeout(3000);
  368. }
  369. /**
  370. * 验证已退出登录(返回登录页面)
  371. */
  372. async expectLoggedOut(): Promise<void> {
  373. // 验证返回到登录页面
  374. await this.loginPage.waitFor({ state: 'visible', timeout: TIMEOUTS.PAGE_LOAD });
  375. }
  376. }