import { useEffect, useRef, useState } from 'react'; import { ArrowDownToLine, Check, FileText, Image, LoaderCircle, Monitor, Play, Plus, Square, Trash2 } from 'lucide-react'; import { api, browserImageBlob, downloadArtifact, downloadBlob } from './api'; import { Modal, Status } from './components'; import type { ArtifactPreview, BrowserJob, BrowserPlan, BrowserStep, Session } from './types'; import './BrowserPanel.css'; const actions: Record = { assert_visible: '验证可见', assert_text: '验证文字', assert_count: '验证数量', click: '点击', fill: '填写', select: '选择选项' }; const active = ['queued', 'snapshotting', 'launching', 'running', 'closing']; const viewports = { desktop: { width: 1280, height: 900 }, mobile: { width: 390, height: 844 } }; const clock = (value: string) => new Date(value).toLocaleTimeString('zh-CN', { hour: '2-digit', minute: '2-digit', second: '2-digit' }); const describe = (step: BrowserStep) => actions[step.action] + ' · ' + step.selector + (step.text !== undefined ? ' → ' + step.text : step.count !== undefined ? ' → ' + step.count : step.value !== undefined ? ' → ' + step.value : step.visible === false ? ' → 不可见' : ''); export function BrowserPanel({ session, busy, onSession, onError }: { session: Session; busy: boolean; onSession: (session: Session) => void; onError: (error: unknown) => void }) { const task = session.execution?.task, plans = session.execution?.browserPlans ?? [], jobs = session.execution?.browserJobs ?? [], latest = plans.at(-1); const [available, setAvailable] = useState<{ status: string; message?: string; playwrightVersion: string } | null>(null); const [builds, setBuilds] = useState([]), [buildDirectory, setBuildDirectory] = useState('dist'), [pathname, setPathname] = useState('/'); const [viewport, setViewport] = useState('desktop'), [steps, setSteps] = useState([]); const [planning, setPlanning] = useState(false), [starting, setStarting] = useState(false), [confirm, setConfirm] = useState(null); const [preview, setPreview] = useState(null), [loadingRecord, setLoadingRecord] = useState(false), [recordJob, setRecordJob] = useState(null); const [image, setImage] = useState<{ url: string; blob: Blob; job: BrowserJob; image: BrowserJob['screenshots'][number] } | null>(null), [loadingImage, setLoadingImage] = useState(''); const identity = session.id + ':' + (task?.id ?? ''), owner = useRef(identity), scope = useRef(0), request = useRef(0), imageRequest = useRef(0), imageUrl = useRef(''), mutation = useRef(false); owner.current = identity; const stillHere = (stamp: number) => owner.current === identity && scope.current === stamp; const route = '/sessions/' + session.id; const running = jobs.some(job => active.includes(job.status)), currentPending = latest && !jobs.some(job => job.planId === latest.id); useEffect(() => { const stamp = ++scope.current; request.current++; imageRequest.current++; setAvailable(null); setBuilds([]); setConfirm(null); setPreview(null); setImage(null); setSteps([]); setBuildDirectory('dist'); setPathname('/'); setViewport('desktop'); setPlanning(false); setStarting(false); setLoadingRecord(false); setLoadingImage(''); mutation.current = false; if (imageUrl.current) { URL.revokeObjectURL(imageUrl.current); imageUrl.current = ''; } if (task) api<{ availability: { status: string; message?: string; playwrightVersion: string }; builds: string[] }>(route + '/browser').then(value => { if (stillHere(stamp)) { setAvailable(value.availability); setBuilds(value.builds); if (value.builds[0]) setBuildDirectory(value.builds[0]); } }).catch(error => { if (stillHere(stamp)) onError(error); }); return () => { scope.current++; request.current++; imageRequest.current++; if (imageUrl.current) URL.revokeObjectURL(imageUrl.current); imageUrl.current = ''; }; }, [identity]); async function mutate(action: string, input: unknown) { if (mutation.current) return; mutation.current = true; const stamp = scope.current; try { const value = await api(route + action, input); if (stillHere(stamp)) { onSession(value); setConfirm(null); } } catch (error) { if (stillHere(stamp)) onError(error); } finally { if (stillHere(stamp)) { mutation.current = false; setPlanning(false); setStarting(false); } } } function plan(event: React.FormEvent) { event.preventDefault(); if (mutation.current) return; setPlanning(true); void mutate('/browser-plans', { build_directory: buildDirectory, path: pathname, viewport: viewports[viewport], steps }); } function changeStep(index: number, patch: Partial) { setSteps(values => values.map((step, i) => i === index ? { ...step, ...patch } : step)); } function changeAction(index: number, action: BrowserStep['action']) { setSteps(values => values.map((step, i) => i !== index ? step : { action, selector: step.selector, ...(['fill', 'select'].includes(action) ? { value: '' } : action === 'assert_text' ? { text: '' } : action === 'assert_count' ? { count: 1 } : action === 'assert_visible' ? { visible: true } : {}) })); } async function openRecord(job: BrowserJob, offset = 0) { const id = ++request.current, stamp = scope.current; setLoadingRecord(true); try { const value = await api(route + '/browser-jobs/' + job.id + '/record?offset=' + offset + '&limit=8000'); if (request.current === id && stillHere(stamp)) { setPreview(value); setRecordJob(job); } } catch (error) { if (request.current === id && stillHere(stamp)) onError(error); } finally { if (request.current === id && stillHere(stamp)) setLoadingRecord(false); } } async function openImage(job: BrowserJob, entry: BrowserJob['screenshots'][number]) { const id = ++imageRequest.current, stamp = scope.current; setLoadingImage(entry.artifactId); try { const blob = await browserImageBlob(session.id, job.id, entry.artifactId); if (imageRequest.current === id && stillHere(stamp)) { if (imageUrl.current) URL.revokeObjectURL(imageUrl.current); const url = URL.createObjectURL(blob); imageUrl.current = url; setImage({ url, blob, job, image: entry }); } } catch (error) { if (imageRequest.current === id && stillHere(stamp)) onError(error); } finally { if (imageRequest.current === id && stillHere(stamp)) setLoadingImage(''); } } if (!task) return null; return

页面验收

{available?.status === 'available' ? 'Edge · 实际浏览器' : '检测浏览器环境'}

操作当前构建的实际页面,核对交互与结果。每次检查保留页面记录和原始截图。

{available?.status === 'missing' &&

{available.message}

} {!builds.length && !plans.length &&

当前工程没有dist、build或out页面构建。先构建Web工程,或填写已有构建目录。

}
准备页面检查
检查步骤 {steps.length}/20
{!steps.length &&

先读取页面与截图,再根据实际元素添加交互和断言。

} {steps.map((step, index) =>
{index + 1} changeStep(index, { selector: event.target.value })} /> {['fill', 'select'].includes(step.action) && changeStep(index, { value: event.target.value })} />} {step.action === 'assert_text' && changeStep(index, { text: event.target.value })} />} {step.action === 'assert_count' && changeStep(index, { count: Number(event.target.value) })} />} {step.action === 'assert_visible' && } {step.action === 'click' && 点击唯一元素}
)}
{latest &&
已封存计划{latest.fingerprint.slice(0, 12)}

{latest.build.directory}{latest.path} · {latest.viewport.width}×{latest.viewport.height} · {latest.build.files} 个构建文件 · {latest.steps.length} 个步骤

查看封存步骤{latest.steps.length ?
    {latest.steps.map((step, index) =>
  1. {describe(step)}
  2. )}
:

读取实际DOM并保存截图;尚未设置验收断言。

}
{!currentPending && 原结果已保存;调整后封存新计划。}
} {!!jobs.length &&

原页面结果 · {jobs.length} 次

{jobs.slice().reverse().map(job =>
页面检查 · {clock(job.startedAt)}

{job.summary}

Task {job.taskId.slice(0, 8)}Run {job.runId.slice(0, 8)}构建 {job.buildSha256.slice(0, 10)}

实际断言 {job.assertions?.passed ?? 0}/{job.assertions?.total ?? 0}{job.cleanup?.exited ? ' · 浏览器已退出' : ''}{job.requiresVerification ? ' · 结束状态待核对' : ''}

{!!job.steps.length &&
实际步骤结果
    {job.steps.map((step, index) =>
  1. {describe(step)}{step.error && {step.error}}
  2. )}
}
{active.includes(job.status) && } {job.resultArtifactId && <> } {job.screenshots.map(entry => )} {job.requiresVerification && }
)}
} {confirm && setConfirm(null)}>
{confirm.build.directory}{confirm.path}

{confirm.viewport.width}×{confirm.viewport.height} · {confirm.build.files} 个文件

构建 SHA256 {confirm.build.sha256} {confirm.steps.length ?
    {confirm.steps.map((step, index) =>
  1. {describe(step)}
  2. )}
:

读取页面与截图,尚未设置验收断言。

}
} {preview && recordJob && { request.current++; setPreview(null); setLoadingRecord(false); }}>
{preview.content}
字符 {preview.offset}–{preview.offset + preview.content.length} / {preview.totalCharacters}
} {image && { imageRequest.current++; setImage(null); if (imageUrl.current) URL.revokeObjectURL(imageUrl.current); imageUrl.current = ''; }}>
当前任务原始页面截图
}
; }