gz-laya-pilot 0.1.0

package/dist/replay.js

@@ -0,0 +1,152 @@
+import { openBrowser } from './browser.js';
+import { waitForReady } from './readiness.js';
+import { runAssertion } from './assertions.js';
+import { parseCase } from './schema.js';
+async function resolveTarget(page, target) {
+    await page.evaluate((selector) => document.querySelectorAll(selector).length, target.selector);
+    const locator = page.locator('css=' + target.selector);
+    await locator.waitFor({ state: 'attached' });
+    if ((await locator.count()) !== 1)
+        throw Error('目标不是唯一控件，请重新录制');
+    const metadata = await locator.evaluate((e) => {
+        const element = e;
+        const label = element.getAttribute('aria-label') ||
+            element.getAttribute('placeholder') ||
+            element.labels?.[0]?.textContent ||
+            element.textContent ||
+            element.tagName;
+        return {
+            label: label.trim().slice(0, 200),
+            private: Boolean(element.closest('[data-private],.rr-block,[data-research-assistant]')) ||
+                /password|passwd|token|secret|credential|验证码|密码|密钥|口令/i.test([element.type, element.name, element.id, element.autocomplete, label].join(' ')),
+        };
+    });
+    if (metadata.private)
+        throw Error('不回放敏感字段或小蜜自身控件');
+    if (target.role) {
+        const named = page.getByRole(target.role, {
+            name: target.label,
+            exact: true,
+        });
+        if ((await locator.and(named).count()) !== 1)
+            throw Error('控件语义已变化，请重新录制');
+    }
+    else if (metadata.label !== target.label)
+        throw Error('控件内容已变化，停止回放以避免误操作');
+    if (!(await locator.isVisible()))
+        await locator.locator('..').hover();
+    return locator;
+}
+/** Functions compose the execution path. No business route, login or data fixture is built in. */
+export async function runCase(value, options) {
+    const testCase = parseCase(value);
+    const origin = new URL(options.origin);
+    if (!['http:', 'https:'].includes(origin.protocol) || origin.username || origin.password)
+        throw Error('测试站点地址无效');
+    const destination = new URL(testCase.path, origin);
+    if (destination.origin !== origin.origin)
+        throw Error('用例入口超出测试站点');
+    const allowed = new Set([
+        origin.origin,
+        ...(options.allowedOrigins ?? []).map((url) => new URL(url).origin),
+    ]);
+    const assertions = [];
+    let status = {
+        state: 'running',
+        step: 0,
+        total: testCase.steps.length,
+        message: '正在启动浏览器',
+        assertions,
+    };
+    const report = (patch) => {
+        status = { ...status, ...patch, assertions: [...assertions] };
+        options.onProgress?.(status);
+    };
+    if (options.signal?.aborted)
+        return { ...status, state: 'stopped', message: '回放已停止' };
+    const { browser, page, context } = await openBrowser({
+        launch: options.launch,
+        context: options.context,
+    });
+    const stop = () => {
+        void browser.close().catch(() => { });
+    };
+    options.signal?.addEventListener('abort', stop, { once: true });
+    try {
+        if (options.signal?.aborted)
+            throw Error('已停止');
+        await context.route('**/*', (route) => allowed.has(new URL(route.request().url()).origin) ? route.continue() : route.abort());
+        await context.addInitScript(() => {
+            const mount = () => {
+                const style = document.createElement('style');
+                style.textContent = '[data-research-assistant],.research-assistant{display:none!important}';
+                document.documentElement.append(style);
+            };
+            if (document.documentElement)
+                mount();
+            else
+                document.addEventListener('DOMContentLoaded', mount, { once: true });
+        });
+        page.setDefaultNavigationTimeout(60000);
+        await page.goto(destination.href, { waitUntil: 'domcontentloaded' });
+        await waitForReady(page, { timeout: 45000 });
+        await options.beforeRun?.(page, context);
+        for (const [index, step] of testCase.steps.entries()) {
+            if (options.signal?.aborted)
+                throw Error('已停止');
+            report({ step: index + 1, message: `正在执行第 ${index + 1} 步：${step.kind}` });
+            if (options.delay)
+                await page.waitForTimeout(options.delay);
+            if (step.kind === 'assert' || step.kind === 'assert-text') {
+                const assertion = step.assertion ?? {
+                    name: step.value,
+                    source: 'page-text',
+                    operator: 'contains',
+                    expected: step.value,
+                    timeout: 10000,
+                };
+                const result = await runAssertion(page, assertion, index + 1, () => options.signal?.aborted === true);
+                assertions.push(result);
+                report({});
+                if (!result.passed)
+                    throw Error(`第 ${index + 1} 步断言失败：${assertion.name}`);
+            }
+            else {
+                if (step.kind === 'unsupported' || !step.target)
+                    throw Error('请先补充未支持的步骤');
+                const target = await resolveTarget(page, step.target);
+                if (step.kind === 'click')
+                    await target.click();
+                else if (step.kind === 'fill')
+                    await target.fill(step.value);
+                else if (step.kind === 'select')
+                    await target.selectOption(step.value);
+                else if (step.kind === 'check')
+                    await target.setChecked(step.checked);
+                else if (step.kind === 'press')
+                    await target.press(step.value);
+            }
+            await waitForReady(page, { timeout: 10000, minimum: 200 });
+        }
+        report({
+            state: assertions.length ? 'passed' : 'completed',
+            message: assertions.length
+                ? `回放完成，${assertions.length} 条断言全部通过`
+                : '操作回放完成；未设置断言，尚未验证业务结果',
+        });
+    }
+    catch (error) {
+        report({
+            state: options.signal?.aborted ? 'stopped' : 'failed',
+            message: options.signal?.aborted
+                ? '回放已停止'
+                : (error instanceof Error ? error.message : String(error)).slice(0, 1500),
+        });
+    }
+    finally {
+        options.signal?.removeEventListener('abort', stop);
+        await browser.close();
+    }
+    return status;
+}
+//# sourceMappingURL=replay.js.map

package/dist/replay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay.js","sourceRoot":"","sources":["../src/replay.ts"],"names":[],"mappings":"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"}

package/dist/schema.d.ts

@@ -0,0 +1,75 @@
+export interface Target {
+    selector: string;
+    label: string;
+    role?: string;
+}
+export interface Step {
+    kind: 'click' | 'fill' | 'select' | 'check' | 'press' | 'assert-text' | 'assert' | 'unsupported';
+    assertion?: Assertion;
+    target?: Target;
+    value?: string;
+    checked?: boolean;
+    sourceEventId?: number;
+    supplemented?: boolean;
+}
+export declare const assertionSources: {
+    readonly 'page-text': "页面文字";
+    readonly 'element-text': "元素文字";
+    readonly 'element-value': "输入框值";
+    readonly 'element-state': "元素可见性";
+    readonly 'element-count': "元素数量";
+};
+export declare const assertionOperators: {
+    readonly contains: "包含";
+    readonly 'not-contains': "不包含";
+    readonly equals: "等于";
+    readonly 'not-equals': "不等于";
+    readonly visible: "可见";
+    readonly hidden: "不可见或不存在";
+};
+export interface Assertion {
+    name: string;
+    source: keyof typeof assertionSources;
+    operator: keyof typeof assertionOperators;
+    selector?: string;
+    expected?: string;
+    timeout: number;
+}
+export declare function operatorsFor(source: Assertion['source']): Assertion['operator'][];
+export declare function parseAssertion(value: unknown): Assertion;
+export interface AssertionResult {
+    step: number;
+    name: string;
+    passed: boolean;
+    expected: string;
+    actual: string;
+    duration: number;
+}
+export interface TimelineEvidence {
+    id: number;
+    time: number;
+    kind: string;
+    title: string;
+    page: string;
+    actionId?: number;
+}
+export interface TestCase {
+    schema: 'zhidao-recorded-case';
+    version: 1;
+    name: string;
+    path: string;
+    steps: Step[];
+    timeline?: {
+        capturedAt: string;
+        events: TimelineEvidence[];
+    };
+}
+export interface RunStatus {
+    id?: string;
+    state: 'idle' | 'running' | 'passed' | 'completed' | 'failed' | 'stopped';
+    step: number;
+    total: number;
+    message: string;
+    assertions?: AssertionResult[];
+}
+export declare function parseCase(value: unknown): TestCase;

package/dist/schema.js

@@ -0,0 +1,162 @@
+export const assertionSources = {
+    'page-text': '页面文字',
+    'element-text': '元素文字',
+    'element-value': '输入框值',
+    'element-state': '元素可见性',
+    'element-count': '元素数量',
+};
+export const assertionOperators = {
+    contains: '包含',
+    'not-contains': '不包含',
+    equals: '等于',
+    'not-equals': '不等于',
+    visible: '可见',
+    hidden: '不可见或不存在',
+};
+export function operatorsFor(source) {
+    if (source === 'element-state')
+        return ['visible', 'hidden'];
+    if (source === 'element-count')
+        return ['equals', 'not-equals'];
+    return ['contains', 'not-contains', 'equals', 'not-equals'];
+}
+export function parseAssertion(value) {
+    const a = value;
+    if (!a || typeof a.name !== 'string' || !a.name.trim() || a.name.length > 100)
+        throw Error('请填写 1–100 字的断言名称');
+    if (!Object.hasOwn(assertionSources, a.source) || !operatorsFor(a.source).includes(a.operator))
+        throw Error('不支持的断言对象或条件');
+    if (!Number.isInteger(a.timeout) || a.timeout < 500 || a.timeout > 30000)
+        throw Error('断言等待时间应为 500–30,000 毫秒');
+    if (a.source !== 'page-text' &&
+        (typeof a.selector !== 'string' || !a.selector.trim() || a.selector.length > 2000))
+        throw Error('请填写有效的 CSS 定位信息');
+    if (a.source !== 'element-state' && (typeof a.expected !== 'string' || a.expected.length > 2000))
+        throw Error('请填写期望值，最多 2,000 字');
+    if (a.source !== 'element-state' && a.source !== 'element-value' && !a.expected?.trim())
+        throw Error('期望值不能为空');
+    if (a.source === 'element-count' && (!/^\d+$/.test(a.expected) || Number(a.expected) > 100000))
+        throw Error('元素数量应为 0–100,000 的整数');
+    return {
+        name: a.name.trim(),
+        source: a.source,
+        operator: a.operator,
+        timeout: a.timeout,
+        ...(a.source !== 'page-text' ? { selector: a.selector.trim() } : {}),
+        ...(a.source !== 'element-state' ? { expected: a.expected } : {}),
+    };
+}
+// Shared by the browser and local bridge. No executable JavaScript in case files.
+export function parseCase(value) {
+    const input = value;
+    if (!input || input.schema !== 'zhidao-recorded-case' || input.version !== 1)
+        throw Error('不是受支持的录制用例 JSON');
+    if (typeof input.name !== 'string' || !input.name.trim() || input.name.length > 100)
+        throw Error('用例名称应为 1–100 个字符');
+    if (typeof input.path !== 'string' ||
+        !input.path.startsWith('/') ||
+        input.path.startsWith('//') ||
+        /[\\\r\n]/.test(input.path) ||
+        input.path.length > 2000)
+        throw Error('用例入口必须是站点内的相对路径');
+    if (!Array.isArray(input.steps) || input.steps.length < 1 || input.steps.length > 100)
+        throw Error('用例需要 1–100 个步骤');
+    const steps = input.steps.map((step) => {
+        if (!step ||
+            ![
+                'click',
+                'fill',
+                'select',
+                'check',
+                'press',
+                'assert-text',
+                'assert',
+                'unsupported',
+            ].includes(step.kind))
+            throw Error('用例包含未知操作');
+        if (step.value !== undefined && (typeof step.value !== 'string' || step.value.length > 2000))
+            throw Error('步骤内容不能超过 2000 个字符');
+        if (step.kind === 'press' && !['Enter', 'Escape', 'Tab'].includes(step.value ?? ''))
+            throw Error('不支持该快捷键');
+        if (step.kind === 'assert-text' && !step.value?.trim())
+            throw Error('检查点文字不能为空');
+        if (step.kind === 'check' && typeof step.checked !== 'boolean')
+            throw Error('缺少勾选状态');
+        if (['fill', 'select'].includes(step.kind) && step.value === undefined)
+            throw Error('缺少输入值');
+        let target;
+        if (!['assert-text', 'assert', 'unsupported'].includes(step.kind)) {
+            if (!step.target ||
+                typeof step.target.selector !== 'string' ||
+                !step.target.selector ||
+                step.target.selector.length > 2000 ||
+                typeof step.target.label !== 'string' ||
+                step.target.label.length > 200)
+                throw Error('步骤缺少有效定位信息');
+            target = {
+                selector: step.target.selector,
+                label: step.target.label,
+                ...(typeof step.target.role === 'string' && /^[a-z]+$/.test(step.target.role)
+                    ? { role: step.target.role }
+                    : {}),
+            };
+        }
+        return {
+            kind: step.kind,
+            ...(step.kind === 'assert' ? { assertion: parseAssertion(step.assertion) } : {}),
+            ...(target ? { target } : {}),
+            ...(step.value !== undefined ? { value: step.value } : {}),
+            ...(step.kind === 'check' ? { checked: step.checked } : {}),
+            ...(Number.isSafeInteger(step.sourceEventId) && step.sourceEventId > 0
+                ? { sourceEventId: step.sourceEventId }
+                : {}),
+            ...(step.supplemented === true ? { supplemented: true } : {}),
+        };
+    });
+    let timeline;
+    if (input.timeline !== undefined) {
+        if (!input.timeline ||
+            typeof input.timeline.capturedAt !== 'string' ||
+            !Number.isFinite(Date.parse(input.timeline.capturedAt)) ||
+            !Array.isArray(input.timeline.events) ||
+            input.timeline.events.length > 300)
+            throw Error('时间线来源格式错误');
+        const ids = new Set();
+        const events = input.timeline.events.map((e) => {
+            if (!e ||
+                !Number.isSafeInteger(e.id) ||
+                e.id <= 0 ||
+                ids.has(e.id) ||
+                !Number.isFinite(e.time) ||
+                !['route', 'click', 'change', 'request', 'error', 'performance'].includes(e.kind) ||
+                typeof e.title !== 'string' ||
+                e.title.length > 200 ||
+                typeof e.page !== 'string' ||
+                e.page.length > 2000)
+                throw Error('时间线来源事件格式错误');
+            ids.add(e.id);
+            return {
+                id: e.id,
+                time: e.time,
+                kind: e.kind,
+                title: e.title,
+                page: e.page,
+                ...(Number.isSafeInteger(e.actionId) && e.actionId > 0 ? { actionId: e.actionId } : {}),
+            };
+        });
+        if (steps.some((s) => s.sourceEventId !== undefined && !ids.has(s.sourceEventId)))
+            throw Error('步骤引用的原始事件不存在');
+        timeline = { capturedAt: input.timeline.capturedAt, events };
+    }
+    else if (steps.some((s) => s.sourceEventId !== undefined))
+        throw Error('缺少步骤的原始时间线');
+    return {
+        schema: 'zhidao-recorded-case',
+        version: 1,
+        name: input.name.trim(),
+        path: input.path,
+        steps,
+        ...(timeline ? { timeline } : {}),
+    };
+}
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"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"}

package/dist/targets.d.ts

@@ -0,0 +1,13 @@
+import type { Target } from './schema.js';
+export declare const excluded = "[data-research-assistant],.research-assistant,[data-private],.rr-block";
+export declare const controls = "button,a[href],input,textarea,select,[role=\"button\"],[role=\"tab\"],[role=\"option\"],[role=\"menuitem\"],[role=\"checkbox\"],[role=\"combobox\"],summary";
+export declare const normalizeText: (value: string) => string;
+/** Accessible names follow the W3C AccName algorithm, including labelledby and label-for. */
+export declare function describeControl(element: Element): {
+    role: string | undefined;
+    label: string;
+    labelSource: string;
+    testId: string | undefined;
+};
+export declare function privateInput(element: Element): boolean;
+export declare function locate(element: Element): Target;

package/dist/targets.js

@@ -0,0 +1,49 @@
+import { computeAccessibleName, getRole } from 'dom-accessibility-api';
+export const excluded = '[data-research-assistant],.research-assistant,[data-private],.rr-block';
+export const controls = 'button,a[href],input,textarea,select,[role="button"],[role="tab"],[role="option"],[role="menuitem"],[role="checkbox"],[role="combobox"],summary';
+export const normalizeText = (value) => value.replace(/\s+/g, ' ').trim();
+/** Accessible names follow the W3C AccName algorithm, including labelledby and label-for. */
+export function describeControl(element) {
+    const role = getRole(element) ?? undefined;
+    const explicit = element.getAttribute('data-assistant-label');
+    const accessible = computeAccessibleName(element, { computedStyleSupportsPseudoElements: false });
+    const fallback = element.getAttribute('placeholder') ||
+        element.getAttribute('name') ||
+        role ||
+        element.tagName.toLowerCase();
+    return {
+        role,
+        label: normalizeText(explicit || accessible || fallback).slice(0, 200),
+        labelSource: explicit ? 'business-label' : accessible ? 'accessible-name' : 'attribute',
+        testId: element.getAttribute('data-testid') ?? undefined,
+    };
+}
+export function privateInput(element) {
+    return (Boolean(element.closest('[data-private],.rr-block')) ||
+        /password|passwd|token|secret|credential|验证码|密码|密钥|口令/i.test(['type', 'name', 'id', 'autocomplete', 'aria-label', 'placeholder']
+            .map((key) => element.getAttribute(key))
+            .join(' ') +
+            ' ' +
+            computeAccessibleName(element, { computedStyleSupportsPseudoElements: false })));
+}
+export function locate(element) {
+    const { label, role, labelSource } = describeControl(element);
+    const semantic = role && labelSource === 'accessible-name' ? { role } : {};
+    const doc = element.ownerDocument;
+    for (const attribute of ['data-testid', 'id', 'aria-label', 'placeholder', 'name']) {
+        const value = element.getAttribute(attribute);
+        const selector = `${element.tagName.toLowerCase()}[${attribute}=${JSON.stringify(value ?? '')}]`;
+        if (value && doc.querySelectorAll(selector).length === 1)
+            return { selector, label, ...semantic };
+    }
+    const path = [];
+    for (let current = element; current && current !== doc.body; current = current.parentElement) {
+        const parent = current.parentElement;
+        if (!parent)
+            break;
+        const index = [...parent.children].filter((e) => e.tagName === current.tagName).indexOf(current) + 1;
+        path.unshift(`${current.tagName.toLowerCase()}:nth-of-type(${index})`);
+    }
+    return { selector: `body > ${path.join(' > ')}`, label, ...semantic };
+}
+//# sourceMappingURL=targets.js.map

package/dist/targets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"targets.js","sourceRoot":"","sources":["../src/targets.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "gz-laya-pilot",
+  "version": "0.1.0",
+  "description": "Functional TypeScript browser testing runtime adapted from LayaPilot",
+  "type": "module",
+  "license": "MIT",
+  "files": [
+    "dist",
+    "src",
+    "NOTICE.md",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./schema": {
+      "types": "./dist/schema.d.ts",
+      "import": "./dist/schema.js"
+    },
+    "./browser": {
+      "types": "./dist/targets.d.ts",
+      "import": "./dist/targets.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepack": "npm run build",
+    "test": "node --test tests/*.test.mjs"
+  },
+  "dependencies": {
+    "playwright": "1.62.1",
+    "dom-accessibility-api": "^0.7.1"
+  },
+  "devDependencies": {
+    "typescript": "~5.9.3",
+    "@types/node": "^24.12.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}

package/src/assertions.ts

@@ -0,0 +1,116 @@
+import type { Page } from 'playwright';
+import type { Assertion, AssertionResult } from './schema.js';
+// Declarative browser assertions. Native CSS only; imported cases never execute scripts.
+export async function runAssertion(
+  page: Page,
+  assertion: Assertion,
+  step: number,
+  isStopped = () => false,
+): Promise<AssertionResult> {
+  const started = Date.now();
+  let actual = '尚未采样';
+  let passed = false;
+  let stableSince;
+  const names = {
+    contains: '包含',
+    'not-contains': '不包含',
+    equals: '等于',
+    'not-equals': '不等于',
+    visible: '可见',
+    hidden: '不可见或不存在',
+  };
+  while (Date.now() - started < assertion.timeout) {
+    if (isStopped()) throw Error('已停止');
+    const sample = await page.evaluate((a) => {
+      const normalize = (text: unknown) =>
+        String(text ?? '')
+          .replace(/\s+/g, ' ')
+          .trim();
+      const secret = (element: HTMLInputElement) =>
+        /password|passwd|token|secret|credential|验证码|密码|密钥|口令/i.test(
+          [
+            element.type,
+            element.name,
+            element.id,
+            element.autocomplete,
+            element.getAttribute('aria-label'),
+            element.getAttribute('placeholder'),
+            element.labels?.[0]?.textContent,
+          ].join(' '),
+        );
+      let value;
+      if (a.source === 'page-text') value = document.body.innerText;
+      else {
+        let elements;
+        try {
+          elements = [...document.querySelectorAll<HTMLElement>(a.selector!)].filter(
+            (e) => !e.closest('[data-research-assistant],.research-assistant'),
+          );
+        } catch {
+          return { fatal: 'CSS 定位语法无效' };
+        }
+        if (a.source === 'element-count') value = String(elements.length);
+        else if (!elements.length && a.source === 'element-state' && a.operator === 'hidden')
+          value = 'hidden';
+        else if (elements.length !== 1)
+          return { actual: `匹配到 ${elements.length} 个元素，要求唯一元素`, matched: false };
+        else {
+          const element = elements[0] as HTMLInputElement;
+          if (a.source === 'element-state') {
+            const rect = element.getBoundingClientRect();
+            const style = getComputedStyle(element);
+            value =
+              rect.width > 0 &&
+              rect.height > 0 &&
+              style.visibility !== 'hidden' &&
+              style.visibility !== 'collapse'
+                ? 'visible'
+                : 'hidden';
+          } else if (a.source === 'element-value') {
+            if (secret(element)) return { fatal: '不读取敏感字段的值' };
+            if (!element.matches('input,textarea,select'))
+              return { fatal: '输入框值断言只支持 input、textarea、select' };
+            value = element.value;
+          } else value = element.innerText ?? element.textContent;
+        }
+      }
+      // Text follows rendered whitespace; input values stay exact, including spaces.
+      const expected = a.source === 'element-value' ? (a.expected ?? '') : normalize(a.expected);
+      const current = a.source === 'element-value' ? String(value) : normalize(value);
+      const equal =
+        a.source === 'element-count' ? Number(current) === Number(expected) : current === expected;
+      const matched =
+        a.operator === 'contains'
+          ? current.includes(expected)
+          : a.operator === 'not-contains'
+            ? !current.includes(expected)
+            : a.operator === 'equals'
+              ? equal
+              : a.operator === 'not-equals'
+                ? !equal
+                : current === a.operator;
+      return { actual: current.slice(0, 500), matched };
+    }, assertion);
+    actual = sample.fatal ?? sample.actual ?? '';
+    if (sample.fatal) break;
+    if (sample.matched) {
+      stableSince ??= Date.now();
+      // Avoid accepting a transient match while a post-action view is settling.
+      if (Date.now() - stableSince >= 200) {
+        passed = true;
+        break;
+      }
+    } else stableSince = undefined;
+    await page.waitForTimeout(
+      Math.min(100, Math.max(1, assertion.timeout - (Date.now() - started))),
+    );
+  }
+  return {
+    step,
+    name: assertion.name,
+    passed,
+    expected: `${names[assertion.operator]}${assertion.expected === undefined ? '' : ` ${assertion.expected === '' ? '空字符串' : assertion.expected}`}`,
+    actual: actual === 'visible' ? '可见' : actual === 'hidden' ? '不可见或不存在' : actual,
+    duration: Date.now() - started,
+  };
+}