优化

client/web/e2e/cypress/.gitignore

@@ -0,0 +1,10 @@
+# 临时忽略， 这些是自动生成的代码
+cypress/integration
+cypress/fixtures
+
+# 未启用的代码
+cypress/screenshots
+cypress/snapshots
+
+# video
+cypress/videos

client/web/e2e/cypress/cypress.json

@@ -0,0 +1,6 @@
+{
+  "component": {
+    "testFiles": "**/*.test.{js,ts,jsx,tsx}",
+    "componentFolder": "./cypress/components/"
+  }
+}

client/web/e2e/cypress/cypress/components/antd.test.tsx

@@ -0,0 +1,38 @@
+import React from 'react';
+import { mount } from '@cypress/react';
+import { Button } from 'antd';
+import { TestWrapper } from './utils/TestWrapper';
+
+describe('antd dark', () => {
+  it('antd button', () => {
+    mount(
+      <TestWrapper>
+        <Button data-testid="default">默认</Button>
+        <Button type="primary" data-testid="primary">
+          主色
+        </Button>
+        <Button danger={true} type="primary" data-testid="primary-danger">
+          主危险
+        </Button>
+      </TestWrapper>
+    );
+
+    cy.get('[data-testid=default]')
+      .should('have.css', 'color', 'rgba(255, 255, 255, 0.65)')
+      .should('have.css', 'border-color', 'rgb(67, 67, 67)')
+      .should('have.css', 'background-color', 'rgba(0, 0, 0, 0)')
+      .matchImageSnapshot('default');
+
+    cy.get('[data-testid=primary]')
+      .should('have.css', 'color', 'rgb(255, 255, 255)')
+      .should('have.css', 'border-color', 'rgb(23, 125, 220)')
+      .should('have.css', 'background-color', 'rgb(23, 125, 220)')
+      .matchImageSnapshot('primary');
+
+    cy.get('[data-testid=primary-danger]')
+      .should('have.css', 'color', 'rgb(255, 255, 255)')
+      .should('have.css', 'border-color', 'rgb(166, 29, 36)')
+      .should('have.css', 'background-color', 'rgb(166, 29, 36)')
+      .matchImageSnapshot('primary-danger');
+  });
+});

client/web/e2e/cypress/cypress/components/utils/TestWrapper.tsx

@@ -0,0 +1,21 @@
+import React from 'react';
+import '../../../../src/styles';
+import clsx from 'clsx';
+
+export const TestWrapper: React.FC<{
+  theme?: 'dark' | 'light';
+}> = (props) => {
+  const { theme = 'dark' } = props;
+
+  return (
+    <div
+      className={clsx(theme, {
+        'bg-black': theme === 'dark',
+      })}
+      data-testid="test-wrapper"
+    >
+      {props.children}
+    </div>
+  );
+};
+TestWrapper.displayName = 'TestWrapper';

client/web/e2e/cypress/cypress/plugins/index.js

@@ -0,0 +1,36 @@
+/// <reference types="cypress" />
+// ***********************************************************
+// This example plugins/index.js can be used to load plugins
+//
+// You can change the location of this file or turn off loading
+// the plugins file with the 'pluginsFile' configuration option.
+//
+// You can read more here:
+// https://on.cypress.io/plugins-guide
+// ***********************************************************
+
+// This function is called when a project is opened or re-opened (e.g. due to
+// the project's config changing)
+
+const injectDevServer = require('./load-webpack');
+const path = require('path');
+const {
+  addMatchImageSnapshotPlugin,
+} = require('cypress-image-snapshot/plugin');
+
+/**
+ * @type {Cypress.PluginConfig}
+ */
+// eslint-disable-next-line no-unused-vars
+module.exports = (on, config) => {
+  // `on` is used to hook into various events Cypress emits
+  // `config` is the resolved Cypress config
+
+  injectDevServer(on, config, {
+    webpackFilename: path.resolve(__dirname, '../../../webpack.config.ts'),
+  });
+
+  addMatchImageSnapshotPlugin(on, config);
+
+  return config;
+};

client/web/e2e/cypress/cypress/plugins/load-webpack.js

@@ -0,0 +1,39 @@
+// @ts-check
+const path = require('path');
+const { startDevServer } = require('@cypress/webpack-dev-server');
+const tryLoadWebpackConfig = require('./utils/tryLoadWebpackConfig');
+
+/** @type {(config: Cypress.PluginConfigOptions, path: string) => string} */
+function normalizeWebpackPath(config, webpackConfigPath) {
+  return path.isAbsolute(webpackConfigPath)
+    ? webpackConfigPath
+    : path.resolve(config.projectRoot, webpackConfigPath);
+}
+
+/**
+ * Injects dev-server based on the webpack config file.
+ *
+ * **Important:** `webpackFilename` path is relative to the project root (cypress.json location)
+ * @type {(on: Cypress.PluginEvents, config: Cypress.PluginConfigOptions, options: { webpackFilename: string  }) => Cypress.PluginConfigOptions}
+ */
+function injectWebpackDevServer(on, config, { webpackFilename }) {
+  const webpackConfig = tryLoadWebpackConfig(
+    normalizeWebpackPath(config, webpackFilename)
+  );
+
+  if (!webpackConfig) {
+    throw new Error(
+      `Can not load webpack config from path ${webpackFilename}.`
+    );
+  }
+
+  on('dev-server:start', async (options) => {
+    return startDevServer({ options, webpackConfig });
+  });
+
+  config.env.reactDevtools = true;
+
+  return config;
+}
+
+module.exports = injectWebpackDevServer;

client/web/e2e/cypress/cypress/plugins/utils/tryLoadWebpackConfig.js

@@ -0,0 +1,40 @@
+// @ts-check
+const debug = require('debug')('@cypress/react');
+
+/** @type {(configPath: string) => null | import('webpack').Configuration } */
+module.exports = function tryLoadWebpackConfig(webpackConfigPath) {
+  debug('trying to load webpack config from %s', webpackConfigPath);
+  // Do this as the first thing so that any code reading it knows the right env.
+  const envName = 'test';
+
+  // @ts-expect-error override env is possible
+  process.env.NODE_ENV = envName;
+  process.env.BABEL_ENV = envName;
+
+  try {
+    let webpackOptions = require(webpackConfigPath);
+
+    if (webpackOptions.default) {
+      // we probably loaded TS file
+      debug('loaded webpack options has .default - taking that as the config');
+      webpackOptions = webpackOptions.default;
+    }
+
+    if (typeof webpackOptions === 'function') {
+      debug('calling webpack function with environment "%s"', envName);
+      webpackOptions = webpackOptions('development');
+    }
+
+    debug('webpack options: %o', webpackOptions);
+
+    return webpackOptions;
+  } catch (err) {
+    debug('could not load react-scripts webpack');
+    debug('error %s', err.message);
+    debug(err);
+
+    console.error(err);
+
+    return null;
+  }
+};

client/web/e2e/cypress/cypress/support/commands.ts

@@ -0,0 +1,31 @@
+// ***********************************************
+// This example commands.js shows you how to
+// create various custom commands and overwrite
+// existing commands.
+//
+// For more comprehensive examples of custom
+// commands please read more here:
+// https://on.cypress.io/custom-commands
+// ***********************************************
+//
+//
+// -- This is a parent command --
+// Cypress.Commands.add('login', (email, password) => { ... })
+//
+//
+// -- This is a child command --
+// Cypress.Commands.add('drag', { prevSubject: 'element'}, (subject, options) => { ... })
+//
+//
+// -- This is a dual command --
+// Cypress.Commands.add('dismiss', { prevSubject: 'optional'}, (subject, options) => { ... })
+//
+//
+// -- This will overwrite an existing command --
+// Cypress.Commands.overwrite('visit', (originalFn, url, options) => { ... })
+
+import { addMatchImageSnapshotCommand } from 'cypress-image-snapshot/command';
+
+// TODO: 一个同样的组件视觉 在runner中两次测试不通过
+// 不知道为什么，可能是cypress runner的问题
+addMatchImageSnapshotCommand();

client/web/e2e/cypress/cypress/support/index.ts

@@ -0,0 +1,20 @@
+// ***********************************************************
+// This example support/index.js is processed and
+// loaded automatically before your test files.
+//
+// This is a great place to put global configuration and
+// behavior that modifies Cypress.
+//
+// You can change the location of this file or turn off
+// automatically serving support files with the
+// 'supportFile' configuration option.
+//
+// You can read more here:
+// https://on.cypress.io/configuration
+// ***********************************************************
+
+// Import commands.js using ES2015 syntax:
+import './commands';
+
+// Alternatively you can use CommonJS syntax:
+// require('./commands')

client/web/e2e/cypress/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "tailchat-e2e",
+  "version": "1.0.0",
+  "main": "index.js",
+  "author": "moonrailgun",
+  "license": "MIT",
+  "private": true,
+  "scripts": {
+    "cypress:open": "cypress open",
+    "cypress:run": "cypress run",
+    "cypress:open-ct": "cypress open-ct",
+    "cypress:run-ct": "cypress run-ct"
+  },
+  "devDependencies": {
+    "@cypress/react": "^5.9.4",
+    "@cypress/webpack-dev-server": "^1.4.0",
+    "@types/cypress-image-snapshot": "^3.1.6",
+    "cypress": "^8.3.0",
+    "cypress-image-snapshot": "^4.0.1"
+  }
+}

client/web/e2e/playwright/.gitignore

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

client/web/e2e/playwright/.npmrc

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

client/web/e2e/playwright/package.json

@@ -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": {}
+}

client/web/e2e/playwright/playwright.config.ts

@@ -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;

client/web/e2e/playwright/tests/entry.spec.ts

@@ -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位');
+  });
+});

client/web/e2e/playwright/tests/example.spec.ts.skip

@@ -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);
+}

client/web/e2e/playwright/tests/main.spec.ts

@@ -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);
+    });
+  });
+});

client/web/e2e/playwright/tests/utils/user.ts

@@ -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();
+}