This commit is contained in:
2026-04-25 16:36:34 +08:00
commit db90e7579b
1876 changed files with 189777 additions and 0 deletions

4
client/web/e2e/playwright/.gitignore vendored Normal file
View File

@@ -0,0 +1,4 @@
node_modules/
test-results/
playwright-report/
auth.json

View File

@@ -0,0 +1,2 @@
# https://npmmirror.com/
registry = https://registry.npmmirror.com

View File

@@ -0,0 +1,24 @@
{
"name": "tailchat-e2e-playwright",
"version": "1.0.0",
"main": "index.js",
"author": "moonrailgun",
"license": "MIT",
"private": true,
"scripts": {
"test": "playwright test --project=chromium",
"test:all": "playwright test",
"test:debug": "playwright test --debug",
"test:watch": "playwright-watch exec yarn test",
"install:chromium": "playwright install chromium",
"install:ci:deps": "playwright install-deps",
"open": "playwright open --load-storage auth.json http://localhost:11011",
"codegen": "playwright codegen --load-storage auth.json http://localhost:11011",
"trace": "playwright show-trace"
},
"devDependencies": {
"@playwright/test": "^1.19.2",
"playwright-watch": "^1.3.23"
},
"dependencies": {}
}

View File

@@ -0,0 +1,105 @@
import type { PlaywrightTestConfig } from '@playwright/test';
import { devices } from '@playwright/test';
/**
* Read environment variables from file.
* https://github.com/motdotla/dotenv
*/
// require('dotenv').config();
/**
* See https://playwright.dev/docs/test-configuration.
*/
const config: PlaywrightTestConfig = {
testDir: './tests',
/* Maximum time one test can run for. */
timeout: 30 * 1000,
expect: {
/**
* Maximum time expect() should wait for the condition to be met.
* For example in `await expect(locator).toHaveText();`
*/
timeout: 5000,
},
/* Fail the build on CI if you accidentally left test.only in the source code. */
forbidOnly: !!process.env.CI,
/* Retry on CI only */
retries: process.env.CI ? 2 : 0,
/* Opt out of parallel tests on CI. */
workers: process.env.CI ? 1 : undefined,
/* Reporter to use. See https://playwright.dev/docs/test-reporters */
// reporter: 'html',
reporter: 'line',
/* Shared settings for all the projects below. See https://playwright.dev/docs/api/class-testoptions. */
use: {
baseURL: 'http://localhost:11011',
/* Maximum time each action such as `click()` can take. Defaults to 0 (no limit). */
actionTimeout: 0,
/* Collect trace when retrying the failed test. See https://playwright.dev/docs/trace-viewer */
trace: process.env.CI ? 'on-first-retry' : 'retain-on-failure',
},
/* Configure projects for major browsers */
projects: [
{
name: 'chromium',
use: {
...devices['Desktop Chrome'],
},
},
{
name: 'firefox',
use: {
...devices['Desktop Firefox'],
},
},
{
name: 'webkit',
use: {
...devices['Desktop Safari'],
},
},
/* Test against mobile viewports. */
// {
// name: 'Mobile Chrome',
// use: {
// ...devices['Pixel 5'],
// },
// },
// {
// name: 'Mobile Safari',
// use: {
// ...devices['iPhone 12'],
// },
// },
/* Test against branded browsers. */
// {
// name: 'Microsoft Edge',
// use: {
// channel: 'msedge',
// },
// },
// {
// name: 'Google Chrome',
// use: {
// channel: 'chrome',
// },
// },
],
/* Folder for test artifacts such as screenshots, videos, traces, etc. */
// outputDir: 'test-results/',
/* Run your local dev server before starting the tests */
// webServer: {
// command: 'npm run start',
// port: 3000,
// },
};
export default config;

View File

@@ -0,0 +1,39 @@
import { test, expect } from '@playwright/test';
test.beforeEach(async ({ page }) => {
await page.goto('/');
});
test.describe('entry page', () => {
test('should auto jump to entry page', async ({ page }) => {
await expect(page).toHaveURL('/entry/login');
});
test('auto goto entry if not login', async ({ page }) => {
await page.goto('/main');
await expect(page).toHaveURL('/entry/login?redirect=%2Fmain'); // should with redirect
});
test('registry', async ({ page }) => {
await page.locator('text=注册账号').click();
await expect(page).toHaveURL('/entry/register');
await page.locator('button:has-text("注册账号")').click();
await expect(page.locator('p.text-red-500')).toHaveText('邮箱不能为空');
await page.locator('[name="reg-email"]').click();
await page.locator('[name="reg-email"]').fill('123456789');
await page.locator('button:has-text("注册账号")').click();
await expect(page.locator('p.text-red-500')).toHaveText('邮箱格式不正确');
await page.locator('[name="reg-email"]').click();
await page.locator('[name="reg-email"]').fill('test@moonrailgun.com');
await page.locator('button:has-text("注册账号")').click();
await expect(page.locator('p.text-red-500')).toHaveText('密码不能低于6位');
await page.locator('[name="reg-password"]').click();
await page.locator('[name="reg-password"]').fill('1234');
await page.locator('button:has-text("注册账号")').click();
await expect(page.locator('p.text-red-500')).toHaveText('密码不能低于6位');
});
});

View File

@@ -0,0 +1,425 @@
import { test, expect, Page } from '@playwright/test';
test.beforeEach(async ({ page }) => {
await page.goto('https://demo.playwright.dev/todomvc');
});
const TODO_ITEMS = [
'buy some cheese',
'feed the cat',
'book a doctors appointment',
];
test.describe('New Todo', () => {
test('should allow me to add todo items', async ({ page }) => {
// Create 1st todo.
await page.locator('.new-todo').fill(TODO_ITEMS[0]);
await page.locator('.new-todo').press('Enter');
// Make sure the list only has one todo item.
await expect(page.locator('.view label')).toHaveText([TODO_ITEMS[0]]);
// Create 2nd todo.
await page.locator('.new-todo').fill(TODO_ITEMS[1]);
await page.locator('.new-todo').press('Enter');
// Make sure the list now has two todo items.
await expect(page.locator('.view label')).toHaveText([
TODO_ITEMS[0],
TODO_ITEMS[1],
]);
await checkNumberOfTodosInLocalStorage(page, 2);
});
test('should clear text input field when an item is added', async ({
page,
}) => {
// Create one todo item.
await page.locator('.new-todo').fill(TODO_ITEMS[0]);
await page.locator('.new-todo').press('Enter');
// Check that input is empty.
await expect(page.locator('.new-todo')).toBeEmpty();
await checkNumberOfTodosInLocalStorage(page, 1);
});
test('should append new items to the bottom of the list', async ({
page,
}) => {
// Create 3 items.
await createDefaultTodos(page);
// Check test using different methods.
await expect(page.locator('.todo-count')).toHaveText('3 items left');
await expect(page.locator('.todo-count')).toContainText('3');
await expect(page.locator('.todo-count')).toHaveText(/3/);
// Check all items in one call.
await expect(page.locator('.view label')).toHaveText(TODO_ITEMS);
await checkNumberOfTodosInLocalStorage(page, 3);
});
test('should show #main and #footer when items added', async ({ page }) => {
await page.locator('.new-todo').fill(TODO_ITEMS[0]);
await page.locator('.new-todo').press('Enter');
await expect(page.locator('.main')).toBeVisible();
await expect(page.locator('.footer')).toBeVisible();
await checkNumberOfTodosInLocalStorage(page, 1);
});
});
test.describe('Mark all as completed', () => {
test.beforeEach(async ({ page }) => {
await createDefaultTodos(page);
await checkNumberOfTodosInLocalStorage(page, 3);
});
test.afterEach(async ({ page }) => {
await checkNumberOfTodosInLocalStorage(page, 3);
});
test('should allow me to mark all items as completed', async ({ page }) => {
// Complete all todos.
await page.locator('.toggle-all').check();
// Ensure all todos have 'completed' class.
await expect(page.locator('.todo-list li')).toHaveClass([
'completed',
'completed',
'completed',
]);
await checkNumberOfCompletedTodosInLocalStorage(page, 3);
});
test('should allow me to clear the complete state of all items', async ({
page,
}) => {
// Check and then immediately uncheck.
await page.locator('.toggle-all').check();
await page.locator('.toggle-all').uncheck();
// Should be no completed classes.
await expect(page.locator('.todo-list li')).toHaveClass(['', '', '']);
});
test('complete all checkbox should update state when items are completed / cleared', async ({
page,
}) => {
const toggleAll = page.locator('.toggle-all');
await toggleAll.check();
await expect(toggleAll).toBeChecked();
await checkNumberOfCompletedTodosInLocalStorage(page, 3);
// Uncheck first todo.
const firstTodo = page.locator('.todo-list li').nth(0);
await firstTodo.locator('.toggle').uncheck();
// Reuse toggleAll locator and make sure its not checked.
await expect(toggleAll).not.toBeChecked();
await firstTodo.locator('.toggle').check();
await checkNumberOfCompletedTodosInLocalStorage(page, 3);
// Assert the toggle all is checked again.
await expect(toggleAll).toBeChecked();
});
});
test.describe('Item', () => {
test('should allow me to mark items as complete', async ({ page }) => {
// Create two items.
for (const item of TODO_ITEMS.slice(0, 2)) {
await page.locator('.new-todo').fill(item);
await page.locator('.new-todo').press('Enter');
}
// Check first item.
const firstTodo = page.locator('.todo-list li').nth(0);
await firstTodo.locator('.toggle').check();
await expect(firstTodo).toHaveClass('completed');
// Check second item.
const secondTodo = page.locator('.todo-list li').nth(1);
await expect(secondTodo).not.toHaveClass('completed');
await secondTodo.locator('.toggle').check();
// Assert completed class.
await expect(firstTodo).toHaveClass('completed');
await expect(secondTodo).toHaveClass('completed');
});
test('should allow me to un-mark items as complete', async ({ page }) => {
// Create two items.
for (const item of TODO_ITEMS.slice(0, 2)) {
await page.locator('.new-todo').fill(item);
await page.locator('.new-todo').press('Enter');
}
const firstTodo = page.locator('.todo-list li').nth(0);
const secondTodo = page.locator('.todo-list li').nth(1);
await firstTodo.locator('.toggle').check();
await expect(firstTodo).toHaveClass('completed');
await expect(secondTodo).not.toHaveClass('completed');
await checkNumberOfCompletedTodosInLocalStorage(page, 1);
await firstTodo.locator('.toggle').uncheck();
await expect(firstTodo).not.toHaveClass('completed');
await expect(secondTodo).not.toHaveClass('completed');
await checkNumberOfCompletedTodosInLocalStorage(page, 0);
});
test('should allow me to edit an item', async ({ page }) => {
await createDefaultTodos(page);
const todoItems = page.locator('.todo-list li');
const secondTodo = todoItems.nth(1);
await secondTodo.dblclick();
await expect(secondTodo.locator('.edit')).toHaveValue(TODO_ITEMS[1]);
await secondTodo.locator('.edit').fill('buy some sausages');
await secondTodo.locator('.edit').press('Enter');
// Explicitly assert the new text value.
await expect(todoItems).toHaveText([
TODO_ITEMS[0],
'buy some sausages',
TODO_ITEMS[2],
]);
await checkTodosInLocalStorage(page, 'buy some sausages');
});
});
test.describe('Editing', () => {
test.beforeEach(async ({ page }) => {
await createDefaultTodos(page);
await checkNumberOfTodosInLocalStorage(page, 3);
});
test('should hide other controls when editing', async ({ page }) => {
const todoItem = page.locator('.todo-list li').nth(1);
await todoItem.dblclick();
await expect(todoItem.locator('.toggle')).not.toBeVisible();
await expect(todoItem.locator('label')).not.toBeVisible();
await checkNumberOfTodosInLocalStorage(page, 3);
});
test('should save edits on blur', async ({ page }) => {
const todoItems = page.locator('.todo-list li');
await todoItems.nth(1).dblclick();
await todoItems.nth(1).locator('.edit').fill('buy some sausages');
await todoItems.nth(1).locator('.edit').dispatchEvent('blur');
await expect(todoItems).toHaveText([
TODO_ITEMS[0],
'buy some sausages',
TODO_ITEMS[2],
]);
await checkTodosInLocalStorage(page, 'buy some sausages');
});
test('should trim entered text', async ({ page }) => {
const todoItems = page.locator('.todo-list li');
await todoItems.nth(1).dblclick();
await todoItems.nth(1).locator('.edit').fill(' buy some sausages ');
await todoItems.nth(1).locator('.edit').press('Enter');
await expect(todoItems).toHaveText([
TODO_ITEMS[0],
'buy some sausages',
TODO_ITEMS[2],
]);
await checkTodosInLocalStorage(page, 'buy some sausages');
});
test('should remove the item if an empty text string was entered', async ({
page,
}) => {
const todoItems = page.locator('.todo-list li');
await todoItems.nth(1).dblclick();
await todoItems.nth(1).locator('.edit').fill('');
await todoItems.nth(1).locator('.edit').press('Enter');
await expect(todoItems).toHaveText([TODO_ITEMS[0], TODO_ITEMS[2]]);
});
test('should cancel edits on escape', async ({ page }) => {
const todoItems = page.locator('.todo-list li');
await todoItems.nth(1).dblclick();
await todoItems.nth(1).locator('.edit').press('Escape');
await expect(todoItems).toHaveText(TODO_ITEMS);
});
});
test.describe('Counter', () => {
test('should display the current number of todo items', async ({ page }) => {
await page.locator('.new-todo').fill(TODO_ITEMS[0]);
await page.locator('.new-todo').press('Enter');
await expect(page.locator('.todo-count')).toContainText('1');
await page.locator('.new-todo').fill(TODO_ITEMS[1]);
await page.locator('.new-todo').press('Enter');
await expect(page.locator('.todo-count')).toContainText('2');
await checkNumberOfTodosInLocalStorage(page, 2);
});
});
test.describe('Clear completed button', () => {
test.beforeEach(async ({ page }) => {
await createDefaultTodos(page);
});
test('should display the correct text', async ({ page }) => {
await page.locator('.todo-list li .toggle').first().check();
await expect(page.locator('.clear-completed')).toHaveText(
'Clear completed'
);
});
test('should remove completed items when clicked', async ({ page }) => {
const todoItems = page.locator('.todo-list li');
await todoItems.nth(1).locator('.toggle').check();
await page.locator('.clear-completed').click();
await expect(todoItems).toHaveCount(2);
await expect(todoItems).toHaveText([TODO_ITEMS[0], TODO_ITEMS[2]]);
});
test('should be hidden when there are no items that are completed', async ({
page,
}) => {
await page.locator('.todo-list li .toggle').first().check();
await page.locator('.clear-completed').click();
await expect(page.locator('.clear-completed')).toBeHidden();
});
});
test.describe('Persistence', () => {
test('should persist its data', async ({ page }) => {
for (const item of TODO_ITEMS.slice(0, 2)) {
await page.locator('.new-todo').fill(item);
await page.locator('.new-todo').press('Enter');
}
const todoItems = page.locator('.todo-list li');
await todoItems.nth(0).locator('.toggle').check();
await expect(todoItems).toHaveText([TODO_ITEMS[0], TODO_ITEMS[1]]);
await expect(todoItems).toHaveClass(['completed', '']);
// Ensure there is 1 completed item.
checkNumberOfCompletedTodosInLocalStorage(page, 1);
// Now reload.
await page.reload();
await expect(todoItems).toHaveText([TODO_ITEMS[0], TODO_ITEMS[1]]);
await expect(todoItems).toHaveClass(['completed', '']);
});
});
test.describe('Routing', () => {
test.beforeEach(async ({ page }) => {
await createDefaultTodos(page);
// make sure the app had a chance to save updated todos in storage
// before navigating to a new view, otherwise the items can get lost :(
// in some frameworks like Durandal
await checkTodosInLocalStorage(page, TODO_ITEMS[0]);
});
test('should allow me to display active items', async ({ page }) => {
await page.locator('.todo-list li .toggle').nth(1).check();
await checkNumberOfCompletedTodosInLocalStorage(page, 1);
await page.locator('.filters >> text=Active').click();
await expect(page.locator('.todo-list li')).toHaveCount(2);
await expect(page.locator('.todo-list li')).toHaveText([
TODO_ITEMS[0],
TODO_ITEMS[2],
]);
});
test('should respect the back button', async ({ page }) => {
await page.locator('.todo-list li .toggle').nth(1).check();
await checkNumberOfCompletedTodosInLocalStorage(page, 1);
await test.step('Showing all items', async () => {
await page.locator('.filters >> text=All').click();
await expect(page.locator('.todo-list li')).toHaveCount(3);
});
await test.step('Showing active items', async () => {
await page.locator('.filters >> text=Active').click();
});
await test.step('Showing completed items', async () => {
await page.locator('.filters >> text=Completed').click();
});
await expect(page.locator('.todo-list li')).toHaveCount(1);
await page.goBack();
await expect(page.locator('.todo-list li')).toHaveCount(2);
await page.goBack();
await expect(page.locator('.todo-list li')).toHaveCount(3);
});
test('should allow me to display completed items', async ({ page }) => {
await page.locator('.todo-list li .toggle').nth(1).check();
await checkNumberOfCompletedTodosInLocalStorage(page, 1);
await page.locator('.filters >> text=Completed').click();
await expect(page.locator('.todo-list li')).toHaveCount(1);
});
test('should allow me to display all items', async ({ page }) => {
await page.locator('.todo-list li .toggle').nth(1).check();
await checkNumberOfCompletedTodosInLocalStorage(page, 1);
await page.locator('.filters >> text=Active').click();
await page.locator('.filters >> text=Completed').click();
await page.locator('.filters >> text=All').click();
await expect(page.locator('.todo-list li')).toHaveCount(3);
});
test('should highlight the currently applied filter', async ({ page }) => {
await expect(page.locator('.filters >> text=All')).toHaveClass('selected');
await page.locator('.filters >> text=Active').click();
// Page change - active items.
await expect(page.locator('.filters >> text=Active')).toHaveClass(
'selected'
);
await page.locator('.filters >> text=Completed').click();
// Page change - completed items.
await expect(page.locator('.filters >> text=Completed')).toHaveClass(
'selected'
);
});
});
async function createDefaultTodos(page: Page) {
for (const item of TODO_ITEMS) {
await page.locator('.new-todo').fill(item);
await page.locator('.new-todo').press('Enter');
}
}
async function checkNumberOfTodosInLocalStorage(page: Page, expected: number) {
return await page.waitForFunction((e) => {
return JSON.parse(localStorage['react-todos']).length === e;
}, expected);
}
async function checkNumberOfCompletedTodosInLocalStorage(
page: Page,
expected: number
) {
return await page.waitForFunction((e) => {
return (
JSON.parse(localStorage['react-todos']).filter((i) => i.completed)
.length === e
);
}, expected);
}
async function checkTodosInLocalStorage(page: Page, title: string) {
return await page.waitForFunction((t) => {
return JSON.parse(localStorage['react-todos'])
.map((i) => i.title)
.includes(t);
}, title);
}

View File

@@ -0,0 +1,124 @@
import { loginToDemoUser } from './utils/user';
import { test, expect, Page } from '@playwright/test';
test.beforeEach(async ({ page, context }) => {
await loginToDemoUser(page, context);
});
test.describe('Main Process', () => {
test('Check All Route', async ({ page }) => {
// Click text=已发送
await page.locator('text=已发送').click();
// Click text=待处理
await page.locator('text=待处理').click();
// Click text=添加好友
await page.locator('text=添加好友').click();
// Click [aria-label="Copy"]
await page.locator('[aria-label="Copy"]').click();
// Click text=插件中心
await page.locator('text=插件中心').click();
await expect(page).toHaveURL(
'http://localhost:11011/main/personal/plugins'
);
// Click text=已安装
await page.locator('text=已安装').click();
// Click text=手动安装
await page.locator('text=手动安装').click();
// Click svg[role="img"] >> nth=1
await page.locator('svg[role="img"]').nth(1).click();
// Click text=系统设置
await page.locator('text=系统设置').click();
// Click text=服务状态
await page.locator('text=服务状态').click();
// Click text=性能统计
await page.locator('text=性能统计').click();
// Click text=关于
await page.locator('text=关于').click();
// Click 关闭
await page.locator('.text-2xl.border-2').click();
});
test.describe('Group', () => {
/**
* 创建群组
*/
async function createGroup(page: Page) {
// Click [data-testid="create-group"]
await page.locator('[data-testid="create-group"]').click();
// Click text=默认群组
await page.locator('text=默认群组').click();
// Click input[type="text"]
await page.locator('input[type="text"]').click();
// Fill input[type="text"]
await page.locator('input[type="text"]').fill('Test');
// Press Enter
await page.locator('input[type="text"]').press('Enter');
// Click button:has-text("确认创建")
await page.locator('button:has-text("确认创建")').click();
await expect(page).toHaveURL(/\/main\/group\/\S{24}\/\S{24}/);
}
/**
* 删除测试群组
*/
async function deleteGroup(page: Page) {
// Click text=Test
await page.locator('[data-testid="group-header"]').click();
// Click text=退出群组
await page.locator('text=退出群组').click();
// Click button:has-text("OK")
await Promise.all([
page.waitForNavigation(/*{ url: 'http://localhost:11011/main/personal/friends' }*/),
page.locator('button:has-text("OK")').click(),
]);
}
test('Create Group', async ({ page }) => {
await createGroup(page);
await deleteGroup(page);
});
test('Group Profile', async ({ page }) => {
await createGroup(page);
await page.locator('[data-testid="group-header"]').click();
// Click text=查看详情
await page.locator('text=查看详情').click();
// Click text=群组名称Test >> button
await page.locator('text=群组名称Test >> button').click();
// Click text=T群组名称 >> input[type="text"]
await page.locator('text=T群组名称 >> input[type="text"]').click();
// Fill text=T群组名称 >> input[type="text"]
await page
.locator('text=T群组名称 >> input[type="text"]')
.fill('Test123');
// Click button >> nth=4
await page.locator('button').nth(4).click();
await expect(page.locator('[data-testid="toast"]')).toHaveText(
'修改群组名成功'
);
// Click text=面板
await page.locator('text=面板').click();
// Click button:has-text("创建面板")
await page.locator('button:has-text("创建面板")').click();
// Click input[name="name"]
await page.locator('input[name="name"]').click();
// Fill input[name="name"]
await page.locator('input[name="name"]').fill('Test');
// Click button:has-text("提 交")
await page.locator('button:has-text("提 交")').click();
// Click .ant-tree-treenode.ant-tree-treenode-switcher-open
await page
.locator('.ant-tree-treenode.ant-tree-treenode-switcher-open')
.click();
// Click [data-testid="full-modal-close"] svg[role="img"]
await page
.locator('[data-testid="full-modal-close"] svg[role="img"]')
.click();
await deleteGroup(page);
});
});
});

View File

@@ -0,0 +1,26 @@
import { BrowserContext, expect, Page } from '@playwright/test';
const storagePath = './auth.json';
/**
* 登录到测试账号
*
* 需要提前注册
*/
export async function loginToDemoUser(page: Page, context: BrowserContext) {
await page.goto('/entry/login');
await page
.locator('input[name="login-email"]')
.fill('tailchat-demo@msgbyte.com');
await page.locator('input[name="login-password"]').fill('tailchat-demo');
await page.locator('button:has-text("登录")').click();
await expect(page).toHaveURL('/main/personal/friends'); // should with redirect
await context.storageState({
path: storagePath,
});
// Click text=跳过引导
await page.locator('text=跳过引导').click();
}

File diff suppressed because it is too large Load Diff