惯性聚合 高效追踪和阅读你感兴趣的博客、新闻、科技资讯
阅读原文 在惯性聚合中打开

推荐订阅源

酷 壳 – CoolShell
酷 壳 – CoolShell
aimingoo的专栏
aimingoo的专栏
P
Proofpoint News Feed
宝玉的分享
宝玉的分享
MyScale Blog
MyScale Blog
The GitHub Blog
The GitHub Blog
钛媒体:引领未来商业与生活新知
钛媒体:引领未来商业与生活新知
月光博客
月光博客
量子位
博客园 - 司徒正美
V
V2EX
I
InfoQ
奇客Solidot–传递最新科技情报
奇客Solidot–传递最新科技情报
Vercel News
Vercel News
H
Hackread – Cybersecurity News, Data Breaches, AI and More
美团技术团队
N
Netflix TechBlog - Medium
L
LangChain Blog
IT之家
IT之家
Blog — PlanetScale
Blog — PlanetScale
Cyber Security Advisories - MS-ISAC
Cyber Security Advisories - MS-ISAC
Stack Overflow Blog
Stack Overflow Blog
A
About on SuperTechFans
Microsoft Azure Blog
Microsoft Azure Blog

Recent Commits to openclaw:main

test: merge chat side-result checks · openclaw/openclaw@ddd2c2a test: merge cron history checks · openclaw/openclaw@f7eb746 test: merge responsive navigation shell checks · openclaw/openclaw@c2e4b47 docs(changelog): add codex oauth fixes · openclaw/openclaw@628e6cd test: merge navigation routing cases · openclaw/openclaw@5d8cecb Tests: mock channel registry bundled fallback · openclaw/openclaw@2b08233 Secrets: avoid broad web search discovery for single plugin config · openclaw/openclaw@a464f59 test: merge config view browser checks · openclaw/openclaw@20cf511 fix(status): align oauth health with runtime · openclaw/openclaw@eed7116 feat: add macOS screen snapshots for monitor preview (#67954) thanks … · openclaw/openclaw@f377db1 fix: report shared auth scopes in hello-ok (#67810) thanks @BunsDev · openclaw/openclaw@0b6c39b Auto-reply: avoid eager bundled route fallback · openclaw/openclaw@3ea1bf4 Tests: narrow session binding contract setup · openclaw/openclaw@54e4e16 fix(macOS): enable undo/redo in webchat composer text input (#34962) · openclaw/openclaw@00951dc Tests: speed up channel setup promotion · openclaw/openclaw@82b529a Docs: refresh agent instructions · openclaw/openclaw@5775fe2 fix(auth): serialize OAuth refresh across agents to fix #26322 (#67876) · openclaw/openclaw@8e79080 test: allow ollama public surface boundary test · openclaw/openclaw@7d4f1a6 Docs: add test performance guardrails · openclaw/openclaw@89706d3 Tests: restore context-engine usage proof · openclaw/openclaw@e4c4f95 Tests: slim context engine runtime coverage · openclaw/openclaw@74c198f ci: retry failed custom checkouts · openclaw/openclaw@0ee5baf test: trim duplicate provider auth onboarding cases · openclaw/openclaw@1ffc02e matrix: fix sessions_spawn --thread subagent session spawning (#67643) · openclaw/openclaw@1ce2596 test: reduce auth choice fixture churn · openclaw/openclaw@857b9cd test: mock health status config boundaries · openclaw/openclaw@9d5ab4a test: mock onboard config io boundary · openclaw/openclaw@299694d test: mock legacy state plugin boundaries · openclaw/openclaw@2713089 test: mock channel install boundaries · openclaw/openclaw@b945248 test: mock doctor preview channel boundaries · openclaw/openclaw@b1a3ad4
refactor: share browser snapshot helpers · openclaw/openc...
vincentkoc · 2026-05-29 · via Recent Commits to openclaw:main

@@ -4,8 +4,8 @@ import {

44

normalizeOptionalString,

55

} from "openclaw/plugin-sdk/string-coerce-runtime";

66

import type { Page } from "playwright-core";

7-

import { ACT_MAX_VIEWPORT_DIMENSION } from "./act-policy.js";

87

import type { SsrFPolicy } from "../infra/net/ssrf.js";

8+

import { ACT_MAX_VIEWPORT_DIMENSION } from "./act-policy.js";

99

import { type AriaSnapshotNode, formatAriaSnapshot, type RawAXNode } from "./cdp.js";

1010

import {

1111

assertBrowserNavigationAllowed,

@@ -30,11 +30,7 @@ import {

3030

storeRoleRefsForTarget,

3131

} from "./pw-session.js";

3232

import { markBackendDomRefsOnPage, withPageScopedCdpClient } from "./pw-session.page-cdp.js";

33-34-

type SnapshotUrlEntry = {

35-

text: string;

36-

url: string;

37-

};

33+

import { appendSnapshotUrls, type SnapshotUrlEntry } from "./snapshot-urls.js";

38343935

function resolveBoundedTimeoutMs(

4036

timeoutMs: number | undefined,

@@ -89,14 +85,6 @@ async function collectSnapshotUrls(page: Page): Promise<SnapshotUrlEntry[]> {

8985

return Array.isArray(urls) ? urls : [];

9086

}

918792-

function appendSnapshotUrls(snapshot: string, urls: SnapshotUrlEntry[]): string {

93-

if (urls.length === 0) {

94-

return snapshot;

95-

}

96-

const lines = urls.map((entry, index) => `${index + 1}. ${entry.text} -> ${entry.url}`);

97-

return `${snapshot}\n\nLinks:\n${lines.join("\n")}`;

98-

}

99-10088

function buildStoredAriaRefs(

10189

nodes: AriaSnapshotNode[],

10290

markedRefs: Set<string>,

@@ -164,14 +152,11 @@ export async function storeAriaSnapshotRefsViaPlaywright(opts: {

164152

});

165153

}

166154167-

export async function snapshotAriaViaPlaywright(opts: {

155+

async function prepareSnapshotPageViaPlaywright(opts: {

168156

cdpUrl: string;

169157

targetId?: string;

170-

limit?: number;

171-

timeoutMs?: number;

172158

ssrfPolicy?: SsrFPolicy;

173-

}): Promise<{ nodes: AriaSnapshotNode[] }> {

174-

const limit = resolveIntegerOption(opts.limit, 500, { min: 1, max: 2000 });

159+

}): Promise<Page> {

175160

const page = await getPageForTargetId({

176161

cdpUrl: opts.cdpUrl,

177162

targetId: opts.targetId,

@@ -186,6 +171,22 @@ export async function snapshotAriaViaPlaywright(opts: {

186171

targetId: opts.targetId,

187172

});

188173

}

174+

return page;

175+

}

176+177+

export async function snapshotAriaViaPlaywright(opts: {

178+

cdpUrl: string;

179+

targetId?: string;

180+

limit?: number;

181+

timeoutMs?: number;

182+

ssrfPolicy?: SsrFPolicy;

183+

}): Promise<{ nodes: AriaSnapshotNode[] }> {

184+

const limit = resolveIntegerOption(opts.limit, 500, { min: 1, max: 2000 });

185+

const page = await prepareSnapshotPageViaPlaywright({

186+

cdpUrl: opts.cdpUrl,

187+

targetId: opts.targetId,

188+

ssrfPolicy: opts.ssrfPolicy,

189+

});

189190

const ariaTimeoutMs =

190191

typeof opts.timeoutMs === "number" && Number.isFinite(opts.timeoutMs) && opts.timeoutMs > 0

191192

? Math.max(500, Math.min(60_000, Math.floor(opts.timeoutMs)))

@@ -238,20 +239,11 @@ export async function snapshotAiViaPlaywright(opts: {

238239

urls?: boolean;

239240

ssrfPolicy?: SsrFPolicy;

240241

}): Promise<{ snapshot: string; truncated?: boolean; refs: RoleRefMap }> {

241-

const page = await getPageForTargetId({

242+

const page = await prepareSnapshotPageViaPlaywright({

242243

cdpUrl: opts.cdpUrl,

243244

targetId: opts.targetId,

245+

ssrfPolicy: opts.ssrfPolicy,

244246

});

245-

ensurePageState(page);

246-

if (opts.ssrfPolicy) {

247-

await assertPageNavigationCompletedSafely({

248-

cdpUrl: opts.cdpUrl,

249-

page,

250-

response: null,

251-

ssrfPolicy: opts.ssrfPolicy,

252-

targetId: opts.targetId,

253-

});

254-

}

255247256248

let snapshot = await page.ariaSnapshot({

257249

mode: "ai",

@@ -282,6 +274,37 @@ export async function snapshotAiViaPlaywright(opts: {

282274

return truncated ? { snapshot, truncated, refs: built.refs } : { snapshot, refs: built.refs };

283275

}

284276277+

async function finalizeRoleSnapshotViaPlaywright(params: {

278+

page: Page;

279+

cdpUrl: string;

280+

targetId?: string;

281+

frameSelector?: string;

282+

mode: "aria" | "role";

283+

built: { snapshot: string; refs: RoleRefMap };

284+

urls?: boolean;

285+

}): Promise<{

286+

snapshot: string;

287+

refs: RoleRefMap;

288+

stats: { lines: number; chars: number; refs: number; interactive: number };

289+

}> {

290+

const snapshot = params.urls

291+

? appendSnapshotUrls(params.built.snapshot, await collectSnapshotUrls(params.page))

292+

: params.built.snapshot;

293+

storeRoleRefsForTarget({

294+

page: params.page,

295+

cdpUrl: params.cdpUrl,

296+

targetId: params.targetId,

297+

refs: params.built.refs,

298+

...(params.frameSelector ? { frameSelector: params.frameSelector } : {}),

299+

mode: params.mode,

300+

});

301+

return {

302+

snapshot,

303+

refs: params.built.refs,

304+

stats: getRoleSnapshotStats(snapshot, params.built.refs),

305+

};

306+

}

307+285308

export async function snapshotRoleViaPlaywright(opts: {

286309

cdpUrl: string;

287310

targetId?: string;

@@ -297,20 +320,11 @@ export async function snapshotRoleViaPlaywright(opts: {

297320

refs: Record<string, { role: string; name?: string; nth?: number }>;

298321

stats: { lines: number; chars: number; refs: number; interactive: number };

299322

}> {

300-

const page = await getPageForTargetId({

323+

const page = await prepareSnapshotPageViaPlaywright({

301324

cdpUrl: opts.cdpUrl,

302325

targetId: opts.targetId,

326+

ssrfPolicy: opts.ssrfPolicy,

303327

});

304-

ensurePageState(page);

305-

if (opts.ssrfPolicy) {

306-

await assertPageNavigationCompletedSafely({

307-

cdpUrl: opts.cdpUrl,

308-

page,

309-

response: null,

310-

ssrfPolicy: opts.ssrfPolicy,

311-

targetId: opts.targetId,

312-

});

313-

}

314328315329

const ariaSnapshotTimeout = resolveSnapshotTimeoutMs(opts.timeoutMs);

316330

@@ -323,21 +337,14 @@ export async function snapshotRoleViaPlaywright(opts: {

323337

timeout: ariaSnapshotTimeout,

324338

});

325339

const built = buildRoleSnapshotFromAiSnapshot(snapshot, opts.options);

326-

const snapshotWithUrls = opts.urls

327-

? appendSnapshotUrls(built.snapshot, await collectSnapshotUrls(page))

328-

: built.snapshot;

329-

storeRoleRefsForTarget({

340+

return await finalizeRoleSnapshotViaPlaywright({

330341

page,

331342

cdpUrl: opts.cdpUrl,

332343

targetId: opts.targetId,

333-

refs: built.refs,

344+

built,

334345

mode: "aria",

346+

urls: opts.urls,

335347

});

336-

return {

337-

snapshot: snapshotWithUrls,

338-

refs: built.refs,

339-

stats: getRoleSnapshotStats(snapshotWithUrls, built.refs),

340-

};

341348

}

342349343350

const frameSelector = normalizeOptionalString(opts.frameSelector) ?? "";

@@ -352,22 +359,15 @@ export async function snapshotRoleViaPlaywright(opts: {

352359353360

const ariaSnapshot = await locator.ariaSnapshot({ timeout: ariaSnapshotTimeout });

354361

const built = buildRoleSnapshotFromAriaSnapshot(ariaSnapshot ?? "", opts.options);

355-

const snapshotWithUrls = opts.urls

356-

? appendSnapshotUrls(built.snapshot, await collectSnapshotUrls(page))

357-

: built.snapshot;

358-

storeRoleRefsForTarget({

362+

return await finalizeRoleSnapshotViaPlaywright({

359363

page,

360364

cdpUrl: opts.cdpUrl,

361365

targetId: opts.targetId,

362-

refs: built.refs,

363366

frameSelector: frameSelector || undefined,

367+

built,

364368

mode: "role",

369+

urls: opts.urls,

365370

});

366-

return {

367-

snapshot: snapshotWithUrls,

368-

refs: built.refs,

369-

stats: getRoleSnapshotStats(snapshotWithUrls, built.refs),

370-

};

371371

}

372372373373

export async function navigateViaPlaywright(opts: {