264 lines
15 KiB
TypeScript
264 lines
15 KiB
TypeScript
import { expect, test, type Page, type Route } from '@playwright/test';
|
|
import { mkdtemp, mkdir, rm, writeFile } from 'node:fs/promises';
|
|
import { tmpdir } from 'node:os';
|
|
import { dirname, join } from 'node:path';
|
|
import type { ManagedProjectView, UrdfFile } from '../src/api/types';
|
|
import { filterUrdfFiles } from '../src/components/project/urdfFiles';
|
|
|
|
const resources = [
|
|
'robot.URDF', 'meshes/base.STL', 'meshes/body.dae', 'meshes/arm.obj',
|
|
'materials/arm.mtl', 'meshes/sensor.gltf', 'meshes/sensor.bin',
|
|
'textures/base.PNG', 'textures/arm.ktx2',
|
|
];
|
|
const unrelated = [
|
|
'README.md', 'src/main.py', 'package.xml', 'config/settings.yaml', 'archive.zip',
|
|
'.git/backup.urdf', '.DS_Store', '__MACOSX/._base.stl', 'node_modules/example/mesh.obj',
|
|
];
|
|
const fixtureContent = (path: string) => /\.urdf$/i.test(path) ? '<robot name="test"/>' : 'test';
|
|
const fixtureDirectories = new Set<string>();
|
|
test.afterEach(async () => {
|
|
await Promise.all([...fixtureDirectories].map((directory) => rm(directory, { recursive: true, force: true })));
|
|
fixtureDirectories.clear();
|
|
});
|
|
|
|
test('URDF 不设独立单文件上限,合计允许 500 MiB 并拒绝多一个字节', async ({ page }) => {
|
|
await prepare(page, 'project');
|
|
const results = await page.evaluate(async () => {
|
|
const moduleUrl = '/src/components/project/UrdfDirPicker.tsx';
|
|
const { checkUrdf } = await import(moduleUrl);
|
|
const maximum = 500 * 1024 * 1024;
|
|
const file = (size: number, relativePath = 'robot.urdf') => ({ file: { size } as File, relativePath });
|
|
return [
|
|
checkUrdf([file(maximum)]),
|
|
checkUrdf([file(1), file(maximum - 1, 'meshes/body.glb')]),
|
|
checkUrdf([file(1), file(maximum, 'meshes/body.glb')]),
|
|
checkUrdf([file(maximum + 1)]),
|
|
checkUrdf([file(1), ...Array.from({ length: 500 }, (_, i) => file(0, `meshes/${i}.stl`))]),
|
|
];
|
|
});
|
|
expect(results[0]).toEqual([]);
|
|
expect(results[1]).toEqual([]);
|
|
expect(results[2][0]).toContain('超过 500 MiB');
|
|
expect(results[3][0]).toContain('超过 500 MiB');
|
|
expect(results[4][0]).toContain('最多 500 个');
|
|
});
|
|
|
|
const project: ManagedProjectView = {
|
|
project: {
|
|
projectCode: 'test-robot', name: '测试机器人', description: '', coverUrl: null,
|
|
urdfMainUrl: null, urdfBaseUrl: null, projectType: 'WHEELED',
|
|
owner: { userCode: null, nickname: '社区官方' }, repoStatus: 'READY', publishStatus: 'UNPUBLISHED',
|
|
publishedCommitSha: null, publishedAt: null, sourceProjectCode: null, sourceCommitSha: null,
|
|
likeCount: 0, commentCount: 0, liked: false, sourceRepositoryUrl: null, sourceLicense: null,
|
|
createdAt: '2026-10-27T00:00:00', updatedAt: '2026-10-27T00:00:00',
|
|
},
|
|
moderationStatus: 'NORMAL', moderationReason: null, deleted: false,
|
|
};
|
|
|
|
async function ok(route: Route, data: unknown) {
|
|
await route.fulfill({ json: { code: 'OK', message: '成功', data, requestId: null } });
|
|
}
|
|
|
|
async function prepare(page: Page, entry: 'project' | 'import') {
|
|
const signed: UrdfFile[][] = [];
|
|
const confirmed: UrdfFile[][] = [];
|
|
await page.addInitScript(() => localStorage.setItem('vibemake_admin_token', 'test-token'));
|
|
await page.addInitScript(() => {
|
|
const originalFetch = window.fetch.bind(window);
|
|
window.fetch = async (input, init) => {
|
|
const url = typeof input === 'string' ? input : input instanceof Request ? input.url : input.href;
|
|
if (new URL(url, window.location.href).pathname === '/mock-oss' && init?.body instanceof FormData) {
|
|
const fields = Object.fromEntries([...init.body.entries()].map(([key, value]) => [key, value instanceof File ? value.name : value]));
|
|
const file = init.body.get('file');
|
|
const fileContent = file instanceof File ? await file.text() : '';
|
|
const uploads = JSON.parse(localStorage.getItem('urdf_test_uploads') ?? '[]');
|
|
uploads.push({ ...fields, fileContent });
|
|
localStorage.setItem('urdf_test_uploads', JSON.stringify(uploads));
|
|
}
|
|
return originalFetch(input, init);
|
|
};
|
|
});
|
|
await page.route('https://fonts.googleapis.com/**', (route) => route.abort());
|
|
await page.route('**/mock-oss', async (route) => {
|
|
await route.fulfill({ status: 204 });
|
|
});
|
|
// 拦截全部管理 API 和 OSS,测试不会向真实后端上传或创建项目。
|
|
await page.route('**/admin-api/**', async (route) => {
|
|
const path = new URL(route.request().url()).pathname.replace('/admin-api', '');
|
|
if (path === '/auth/me') return ok(route, { userCode: 'admin', nickname: '测试管理员', role: 'ADMIN' });
|
|
if (path === '/projects/types') return ok(route, [{ code: 'WHEELED', name: '轮式机器人' }]);
|
|
if (path === '/projects/test-robot') return ok(route, project);
|
|
if (path.endsWith('/tree')) return ok(route, { commitSha: 'main-sha', path: '', entries: [] });
|
|
if (path === '/project-imports/preview') return ok(route, {
|
|
repositoryUrl: 'https://github.com/example/robot', defaultBranch: 'main', name: '测试机器人',
|
|
description: '', license: null, existingProjectCode: null,
|
|
});
|
|
if (path.endsWith('/urdf/signature')) {
|
|
const files = route.request().postDataJSON().files as UrdfFile[];
|
|
signed.push(files);
|
|
return ok(route, {
|
|
batchCode: 'test-batch', mainRelativePath: files[0].relativePath,
|
|
uploadUrl: 'http://127.0.0.1:5190/mock-oss',
|
|
files: files.map(({ relativePath }) => ({ relativePath, formFields: { key: relativePath } })),
|
|
});
|
|
}
|
|
if (path.endsWith('/urdf') && route.request().method() === 'PUT') {
|
|
confirmed.push(route.request().postDataJSON().files);
|
|
return ok(route, project.project);
|
|
}
|
|
if (path === '/project-imports' && route.request().method() === 'POST') {
|
|
confirmed.push(route.request().postDataJSON().urdf.files);
|
|
// 留在创建页,便于断言本次提交,避免进入任务轮询。
|
|
return route.fulfill({ status: 409, json: { code: 'DUPLICATE_SOURCE', message: '模拟重复来源', data: null } });
|
|
}
|
|
return ok(route, { items: [], page: 1, size: 20, total: 0 });
|
|
});
|
|
if (entry === 'project') {
|
|
await page.goto('/projects/test-robot');
|
|
await page.getByRole('tab', { name: 'URDF', exact: true }).click();
|
|
} else {
|
|
await page.goto('/imports/new');
|
|
await page.getByRole('textbox', { name: 'GitHub 仓库地址' }).fill('https://github.com/example/robot');
|
|
await page.getByRole('button', { name: /预\s*检/, exact: true }).click();
|
|
await page.getByRole('combobox', { name: '项目类型' }).click();
|
|
await page.getByText('轮式机器人', { exact: true }).click();
|
|
}
|
|
return { signed, confirmed };
|
|
}
|
|
|
|
async function chooseDirectory(page: Page, paths: string[], label = '选择 URDF 目录') {
|
|
const parent = await mkdtemp(join(tmpdir(), 'urdf-filter-'));
|
|
fixtureDirectories.add(parent);
|
|
const directory = join(parent, 'robot');
|
|
await Promise.all(paths.map(async (path) => {
|
|
const fullPath = join(directory, path);
|
|
await mkdir(dirname(fullPath), { recursive: true });
|
|
await writeFile(fullPath, fixtureContent(path));
|
|
}));
|
|
const chooser = page.waitForEvent('filechooser');
|
|
await page.getByRole('button', { name: new RegExp(label) }).click();
|
|
await (await chooser).setFiles(directory);
|
|
await expect(page.getByRole('button', { name: '重新选择目录' })).toBeVisible();
|
|
}
|
|
|
|
for (const entry of ['project', 'import'] as const) {
|
|
test(`${entry} URDF 目录仅签名、上传和绑定渲染资源,保留嵌套引用路径`, async ({ page }) => {
|
|
const requests = await prepare(page, entry);
|
|
await chooseDirectory(page, [...resources, ...unrelated]);
|
|
await expect(page.getByText(`已过滤 ${unrelated.length} 个无关文件`, { exact: false })).toBeVisible();
|
|
await expect(page.locator('.file-list-row')).toHaveCount(resources.length);
|
|
await expect(page.locator('.file-list-main')).toHaveText('robot.URDF');
|
|
|
|
const keepRoot = page.getByRole('checkbox', { name: '保留所选文件夹名称' });
|
|
await keepRoot.check();
|
|
await expect(page.locator('.file-list-main')).toHaveText('robot/robot.URDF');
|
|
if (entry === 'project') await keepRoot.uncheck();
|
|
const expected = resources.map((relativePath) => ({
|
|
relativePath: entry === 'import' ? `robot/${relativePath}` : relativePath,
|
|
sizeBytes: Buffer.byteLength(fixtureContent(relativePath)),
|
|
})).sort((a, b) => a.relativePath.localeCompare(b.relativePath));
|
|
await page.getByRole('button', { name: entry === 'project' ? '上传并绑定' : '创建迁移任务', exact: true }).click();
|
|
await expect.poll(() => requests.confirmed.length).toBe(1);
|
|
expect(requests.signed).toHaveLength(1);
|
|
expect([...requests.signed[0]].sort((a, b) => a.relativePath.localeCompare(b.relativePath))).toEqual(expected);
|
|
expect(requests.confirmed[0]).toEqual(requests.signed[0]);
|
|
await expect.poll(() => page.evaluate(() => JSON.parse(localStorage.getItem('urdf_test_uploads') ?? '[]').length)).toBe(expected.length);
|
|
const uploads = await page.evaluate(() => JSON.parse(localStorage.getItem('urdf_test_uploads') ?? '[]')) as Record<string, string>[];
|
|
expect(uploads.map(({ key }) => key).sort()).toEqual(expected.map((file) => file.relativePath).sort());
|
|
expect(uploads.map(({ file }) => file).sort()).toEqual(expected.map((file) => file.relativePath.split('/').at(-1)!).sort());
|
|
});
|
|
}
|
|
|
|
for (const entry of ['project', 'import'] as const) {
|
|
test(`${entry} 在签名前修正嵌套 ROS 包、跨包同名文件和大小写引用,按改写后的字节数上传`, async ({ page }) => {
|
|
const requests = await prepare(page, entry);
|
|
const result = await page.evaluate(async (entry) => {
|
|
const moduleUrl = '/src/api/index.ts';
|
|
const api = await import(moduleUrl);
|
|
const source = `<robot name="AlexBot"><link name="base"><visual><geometry><mesh filename="package://Alexbot_simple_urdf/meshes/base_link.STL"/></geometry><material name="body"><texture filename="package://Alexbot_simple_urdf/textures/body.PNG"/></material></visual><collision><geometry><mesh filename="package://camera/meshes/base_link.STL"/></geometry></collision></link></robot>`;
|
|
const main = 'urdf_pkg/Alexbot_simple_urdf/urdf/robot.urdf';
|
|
const selected = [
|
|
{ relativePath: main, file: new File([source], 'robot.urdf') },
|
|
{ relativePath: 'urdf_pkg/Alexbot_simple_urdf/meshes/base_link.STL', file: new File(['mesh'], 'base_link.STL') },
|
|
{ relativePath: 'urdf_pkg/Alexbot_simple_urdf/textures/body.png', file: new File(['image'], 'body.png') },
|
|
{ relativePath: 'camera/meshes/base_link.STL', file: new File(['camera'], 'base_link.STL') },
|
|
];
|
|
if (entry === 'project') await api.uploadUrdf('test-robot', selected);
|
|
else await api.uploadImportUrdf('https://github.com/example/robot', selected);
|
|
return { main, original: source, sourceAfter: await selected[0].file.text() };
|
|
}, entry);
|
|
expect(result.sourceAfter).toBe(result.original);
|
|
expect(requests.signed).toHaveLength(1);
|
|
const uploads = await page.evaluate(() => JSON.parse(localStorage.getItem('urdf_test_uploads') ?? '[]')) as Record<string, string>[];
|
|
const urdf = uploads.find(({ key }) => key === result.main)!;
|
|
expect(urdf.fileContent).toContain('filename="../meshes/base_link.STL"');
|
|
expect(urdf.fileContent).toContain('filename="../textures/body.png"');
|
|
expect(urdf.fileContent).toContain('filename="../../../camera/meshes/base_link.STL"');
|
|
expect(requests.signed[0].find(({ relativePath }) => relativePath === result.main)?.sizeBytes).toBe(Buffer.byteLength(urdf.fileContent));
|
|
expect(uploads.find(({ key }) => key.endsWith('/textures/body.png'))?.fileContent).toBe('image');
|
|
if (entry === 'project') expect(requests.confirmed[0]).toEqual(requests.signed[0]);
|
|
});
|
|
}
|
|
|
|
test('缺失和歧义资源在签名前报错,外部 URL 保留原值', async ({ page }) => {
|
|
const requests = await prepare(page, 'project');
|
|
const errors = await page.evaluate(async () => {
|
|
const moduleUrl = '/src/api/index.ts';
|
|
const api = await import(moduleUrl);
|
|
const errors: string[] = [];
|
|
for (const paths of [[], ['left/body.stl', 'right/body.stl']]) {
|
|
const selected = [
|
|
{ relativePath: 'robot.urdf', file: new File(['<robot name="test"><link name="body"><visual><geometry><mesh filename="package://robot/meshes/body.stl"/></geometry></visual></link></robot>'], 'robot.urdf') },
|
|
...paths.map((relativePath) => ({ relativePath, file: new File(['mesh'], 'body.stl') })),
|
|
];
|
|
try { await api.uploadUrdf('test-robot', selected); } catch (error) { errors.push((error as Error).message); }
|
|
}
|
|
return errors;
|
|
});
|
|
expect(errors).toHaveLength(2);
|
|
expect(errors.every((error) => error.includes('资源缺失或路径不唯一'))).toBe(true);
|
|
expect(requests.signed).toHaveLength(0);
|
|
expect(requests.confirmed).toHaveLength(0);
|
|
const unchanged = await page.evaluate(async () => {
|
|
const moduleUrl = '/src/utils/urdfPaths.ts';
|
|
const { normalizeUrdfSelection } = await import(moduleUrl);
|
|
const file = new File(['<robot name="test"><link name="body"><visual><geometry><mesh filename="https://example.com/body.stl?Signature=keep"/></geometry></visual></link></robot>'], 'robot.urdf');
|
|
const selected = [{ relativePath: 'robot.urdf', file }];
|
|
return (await normalizeUrdfSelection(selected))[0].file === file;
|
|
});
|
|
expect(unchanged).toBe(true);
|
|
});
|
|
|
|
test('过滤后仍校验多个或缺失的 URDF,全部过滤时阻止创建,清除后可继续', async ({ page }) => {
|
|
const requests = await prepare(page, 'import');
|
|
await chooseDirectory(page, ['first.urdf', 'second.URDF', 'README.md']);
|
|
await expect(page.getByText('目录中必须有且仅有一个 .urdf 文件(当前 2 个)', { exact: true })).toBeVisible();
|
|
await chooseDirectory(page, ['meshes/base.stl'], '重新选择目录');
|
|
await expect(page.getByText('目录中必须有且仅有一个 .urdf 文件(当前 0 个)', { exact: true })).toBeVisible();
|
|
await chooseDirectory(page, ['README.md', 'src/main.py'], '重新选择目录');
|
|
await expect(page.getByText('所选目录中没有可上传的 URDF 渲染资源,请重新选择目录或清除选择')).toBeVisible();
|
|
await expect(page.locator('.file-list-row')).toHaveCount(0);
|
|
await page.getByRole('button', { name: '创建迁移任务', exact: true }).click();
|
|
await expect(page.getByText('URDF 目录不符合要求,请重新选择或清除后再创建')).toBeVisible();
|
|
expect(requests.signed).toHaveLength(0);
|
|
expect(requests.confirmed).toHaveLength(0);
|
|
await page.getByRole('button', { name: /清\s*除/, exact: true }).click();
|
|
await expect(page.getByText('所选目录中没有可上传的 URDF 渲染资源,请重新选择目录或清除选择')).toHaveCount(0);
|
|
await expect(page.getByRole('button', { name: '选择 URDF 目录' })).toBeVisible();
|
|
});
|
|
|
|
test('扩展名大小写不敏感,保留材质和贴图数据,排除伪装扩展名和隐藏路径', () => {
|
|
const paths = [
|
|
'robot.URDF', 'meshes/arm.OBJ', 'materials/arm.MTL', 'textures/base.KTX2', 'mesh.bin',
|
|
'robot.urdf.bak', 'mesh.stl.zip', '.hidden.urdf', '.cache/mesh.stl',
|
|
'assets/.git/mesh.stl', '__MACOSX/mesh.stl', 'node_modules/pkg/model.glb',
|
|
];
|
|
const files = paths.map((path) => {
|
|
const file = new File(['test'], path.split('/').at(-1)!);
|
|
Object.defineProperty(file, 'webkitRelativePath', { value: `robot/${path}` });
|
|
return file;
|
|
});
|
|
expect(filterUrdfFiles(files)).toEqual(files.slice(0, 5));
|
|
expect(filterUrdfFiles([new File(['test'], 'standalone.STL')])).toHaveLength(1);
|
|
});
|