mirror of
https://github.com/Tencent/BrowserSkill.git
synced 2026-09-10 13:01:23 +08:00
Compare commits
14
Commits
main
..
ad4c1a92cf
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
ad4c1a92cf | ||
|
|
b75ea7f7ce | ||
|
|
17f7587c60 | ||
|
|
fe7ddbd082 | ||
|
|
3bb84d1c5b | ||
|
|
7f8b51a724 | ||
|
|
2fd1b9d8f1 | ||
|
|
ef27aa9832 | ||
|
|
e67e393434 | ||
|
|
7bccb84d5f | ||
|
|
f6d129b12e | ||
|
|
fc39bc4f8f | ||
|
|
05bee25b2f | ||
|
|
2778ab1eee |
No files matched your search
@@ -7,30 +7,6 @@ Starting from 0.2.0, CLI / Extension / DSH Plugin share the same version number.
|
|||||||
|
|
||||||
## [Unreleased]
|
## [Unreleased]
|
||||||
|
|
||||||
### Added
|
|
||||||
|
|
||||||
- [Scroll-to element primitive](docs/scroll-to.md) across CLI, Extension and DSH Plugin,
|
|
||||||
with ancestor-clipped visible bounds, iframe support and cooperative cancellation
|
|
||||||
|
|
||||||
## [0.2.1] - 2026-09-09
|
|
||||||
|
|
||||||
### Changed
|
|
||||||
- DSH Plugin: clarified installation, configuration, profile restart, and upgrade instructions
|
|
||||||
|
|
||||||
### Fixed
|
|
||||||
- CLI: reliable Windows self-updates, including executable replacement and daemon restart
|
|
||||||
- CLI: Windows named-pipe connection continuity and stale daemon process detection
|
|
||||||
- Windows installer: PowerShell 5.1 compatibility, path quoting, and staged executable replacement
|
|
||||||
- CLI / DSH Plugin: cancellation propagation and upload/download cleanup when the parent process exits
|
|
||||||
- Extension: tab ownership and session cleanup when agent tabs fail to open or borrowed tabs are returned or closed
|
|
||||||
- Extension: navigation recovery when other extensions restrict Chrome DevTools Protocol access
|
|
||||||
- Extension: background input filling, automatic append behavior, and verification of field values before reporting success
|
|
||||||
- Extension: match observed form state to the correct element after page changes
|
|
||||||
- Extension: UUID generation fallback for recording and overlays on insecure origins
|
|
||||||
- Browser locale matching for regional language variants
|
|
||||||
- DSH Plugin: observation state synchronization, thumbnail capture lifecycle, and stale preview cleanup
|
|
||||||
- DSH Plugin: removed the obsolete client runtime host dependency
|
|
||||||
|
|
||||||
## [0.2.0] - 2026-09-02
|
## [0.2.0] - 2026-09-02
|
||||||
|
|
||||||
### Added
|
### Added
|
||||||
|
|||||||
Generated
+2
-2
@@ -134,7 +134,7 @@ dependencies = [
|
|||||||
|
|
||||||
[[package]]
|
[[package]]
|
||||||
name = "bsk"
|
name = "bsk"
|
||||||
version = "0.2.1"
|
version = "0.2.0"
|
||||||
dependencies = [
|
dependencies = [
|
||||||
"anyhow",
|
"anyhow",
|
||||||
"base64",
|
"base64",
|
||||||
@@ -169,7 +169,7 @@ dependencies = [
|
|||||||
|
|
||||||
[[package]]
|
[[package]]
|
||||||
name = "bsk-protocol"
|
name = "bsk-protocol"
|
||||||
version = "0.2.1"
|
version = "0.2.0"
|
||||||
dependencies = [
|
dependencies = [
|
||||||
"schemars",
|
"schemars",
|
||||||
"semver",
|
"semver",
|
||||||
|
|||||||
+2
-2
@@ -7,7 +7,7 @@ members = [
|
|||||||
default-members = ["crates/bsk-cli"]
|
default-members = ["crates/bsk-cli"]
|
||||||
|
|
||||||
[workspace.package]
|
[workspace.package]
|
||||||
version = "0.2.1"
|
version = "0.2.0"
|
||||||
edition = "2024"
|
edition = "2024"
|
||||||
rust-version = "1.85"
|
rust-version = "1.85"
|
||||||
license = "MIT"
|
license = "MIT"
|
||||||
@@ -43,7 +43,7 @@ rand = "0.8"
|
|||||||
uuid = { version = "1", features = ["v4", "serde"] }
|
uuid = { version = "1", features = ["v4", "serde"] }
|
||||||
|
|
||||||
# Workspace crates (version required for `cargo publish` of dependents)
|
# Workspace crates (version required for `cargo publish` of dependents)
|
||||||
bsk-protocol = { version = "0.2.1", path = "crates/bsk-protocol" }
|
bsk-protocol = { version = "0.2.0", path = "crates/bsk-protocol" }
|
||||||
|
|
||||||
[profile.release]
|
[profile.release]
|
||||||
strip = "symbols"
|
strip = "symbols"
|
||||||
|
|||||||
@@ -207,9 +207,6 @@ through the [plugin](#deepseek-harness-plugin): the agent calls injected
|
|||||||
|
|
||||||
## For Developers
|
## For Developers
|
||||||
|
|
||||||
The [scroll-to primitive reference](docs/scroll-to.md) covers its CLI, protocol
|
|
||||||
and plugin entry points, visible bounds and interruption behavior.
|
|
||||||
|
|
||||||
The repository is a Cargo + pnpm workspace:
|
The repository is a Cargo + pnpm workspace:
|
||||||
|
|
||||||
- `crates/bsk-cli` — `bsk` CLI and local daemon
|
- `crates/bsk-cli` — `bsk` CLI and local daemon
|
||||||
|
|||||||
@@ -177,8 +177,6 @@ Agent 不直接与浏览器通信。它通过 `bsk` CLI 下发浏览器任务;
|
|||||||
|
|
||||||
## 面向开发者
|
## 面向开发者
|
||||||
|
|
||||||
[scroll-to 原语说明](docs/scroll-to.md)介绍 CLI、协议和插件入口,以及可见区域、错误和中断语义。
|
|
||||||
|
|
||||||
本仓库是 Cargo + pnpm workspace:
|
本仓库是 Cargo + pnpm workspace:
|
||||||
|
|
||||||
- `crates/bsk-cli` — `bsk` CLI 与本地 daemon
|
- `crates/bsk-cli` — `bsk` CLI 与本地 daemon
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
{
|
{
|
||||||
"name": "@browser-skill/extension",
|
"name": "@browser-skill/extension",
|
||||||
"version": "0.2.1",
|
"version": "0.2.0",
|
||||||
"private": true,
|
"private": true,
|
||||||
"type": "module",
|
"type": "module",
|
||||||
"scripts": {
|
"scripts": {
|
||||||
|
|||||||
@@ -29,24 +29,6 @@ function fakeApi() {
|
|||||||
}
|
}
|
||||||
|
|
||||||
describe("ChromiumCdp", () => {
|
describe("ChromiumCdp", () => {
|
||||||
it("changes attachment identity only across real debugger attachments", async () => {
|
|
||||||
const { api, onEvent, onDetach } = fakeApi();
|
|
||||||
const cdp = new ChromiumCdp(api);
|
|
||||||
expect(cdp.getAttachmentId(4)).toBeUndefined();
|
|
||||||
await cdp.ensureAttached(4);
|
|
||||||
const first = cdp.getAttachmentId(4);
|
|
||||||
expect(first).toBeTruthy();
|
|
||||||
await cdp.ensureAttached(4);
|
|
||||||
onEvent.fire({ tabId: 4 }, "Target.attachedToTarget", { sessionId: "child" });
|
|
||||||
expect(cdp.getAttachmentId(4)).toBe(first);
|
|
||||||
onDetach.fire({ tabId: 4 }, "target_closed");
|
|
||||||
expect(cdp.getAttachmentId(4)).toBeUndefined();
|
|
||||||
await cdp.ensureAttached(4);
|
|
||||||
expect(cdp.getAttachmentId(4)).not.toBe(first);
|
|
||||||
await cdp.detach(4);
|
|
||||||
expect(cdp.getAttachmentId(4)).toBeUndefined();
|
|
||||||
});
|
|
||||||
|
|
||||||
it("discovers multiple iframe targets and recursively routes nested OOPIF commands", async () => {
|
it("discovers multiple iframe targets and recursively routes nested OOPIF commands", async () => {
|
||||||
const { api, onEvent } = fakeApi();
|
const { api, onEvent } = fakeApi();
|
||||||
(api.sendCommand as ReturnType<typeof vi.fn>).mockImplementation(
|
(api.sendCommand as ReturnType<typeof vi.fn>).mockImplementation(
|
||||||
|
|||||||
@@ -164,7 +164,6 @@ async function settleBeforeDeadline(promises: Promise<void>[], deadline: number)
|
|||||||
export class ChromiumCdp {
|
export class ChromiumCdp {
|
||||||
private readonly api: CdpDebuggerApi;
|
private readonly api: CdpDebuggerApi;
|
||||||
private readonly attachedTabs = new Set<number>();
|
private readonly attachedTabs = new Set<number>();
|
||||||
private readonly attachmentIds = new Map<number, string>();
|
|
||||||
private readonly attachInFlight = new Map<number, Promise<void>>();
|
private readonly attachInFlight = new Map<number, Promise<void>>();
|
||||||
private readonly detachInFlight = new Map<number, Promise<void>>();
|
private readonly detachInFlight = new Map<number, Promise<void>>();
|
||||||
private readonly tabOwners = new Map<number, Set<string>>();
|
private readonly tabOwners = new Map<number, Set<string>>();
|
||||||
@@ -199,11 +198,6 @@ export class ChromiumCdp {
|
|||||||
this.bindFrameTargetHandler();
|
this.bindFrameTargetHandler();
|
||||||
}
|
}
|
||||||
|
|
||||||
/** Identity of this actual debugger attachment, independent of frame topology. */
|
|
||||||
getAttachmentId(tabId: number): string | undefined {
|
|
||||||
return this.attachmentIds.get(tabId);
|
|
||||||
}
|
|
||||||
|
|
||||||
/** Attach to `tabId` if we haven't already in this driver. */
|
/** Attach to `tabId` if we haven't already in this driver. */
|
||||||
async ensureAttached(tabId: number): Promise<void> {
|
async ensureAttached(tabId: number): Promise<void> {
|
||||||
// Returning a tab clears the cache before Chrome finishes detaching.
|
// Returning a tab clears the cache before Chrome finishes detaching.
|
||||||
@@ -223,7 +217,6 @@ export class ChromiumCdp {
|
|||||||
await this.enableConsoleDomains(tabId);
|
await this.enableConsoleDomains(tabId);
|
||||||
await this.enableNetworkDomainBestEffort(tabId);
|
await this.enableNetworkDomainBestEffort(tabId);
|
||||||
this.attachedTabs.add(tabId);
|
this.attachedTabs.add(tabId);
|
||||||
this.attachmentIds.set(tabId, crypto.randomUUID());
|
|
||||||
await this.enableFrameDiscovery({ tabId }).catch((err) => {
|
await this.enableFrameDiscovery({ tabId }).catch((err) => {
|
||||||
console.debug("[bsk cdp] frame discovery unavailable", { tabId, err });
|
console.debug("[bsk cdp] frame discovery unavailable", { tabId, err });
|
||||||
});
|
});
|
||||||
@@ -451,7 +444,6 @@ export class ChromiumCdp {
|
|||||||
this.attachInFlight.delete(tabId);
|
this.attachInFlight.delete(tabId);
|
||||||
if (!this.attachedTabs.has(tabId)) return;
|
if (!this.attachedTabs.has(tabId)) return;
|
||||||
this.attachedTabs.delete(tabId);
|
this.attachedTabs.delete(tabId);
|
||||||
this.attachmentIds.delete(tabId);
|
|
||||||
this.clearDialogState(tabId);
|
this.clearDialogState(tabId);
|
||||||
this.clearConsoleState(tabId);
|
this.clearConsoleState(tabId);
|
||||||
this.clearNetworkState(tabId);
|
this.clearNetworkState(tabId);
|
||||||
@@ -510,7 +502,6 @@ export class ChromiumCdp {
|
|||||||
this.attachInFlight.clear();
|
this.attachInFlight.clear();
|
||||||
this.tabOwners.clear();
|
this.tabOwners.clear();
|
||||||
this.attachedTabs.clear();
|
this.attachedTabs.clear();
|
||||||
this.attachmentIds.clear();
|
|
||||||
this.dialogBuffers.clear();
|
this.dialogBuffers.clear();
|
||||||
this.dialogSequences.clear();
|
this.dialogSequences.clear();
|
||||||
this.consoleBuffers.clear();
|
this.consoleBuffers.clear();
|
||||||
@@ -857,7 +848,6 @@ export class ChromiumCdp {
|
|||||||
const listener = (source: chrome.debugger.Debuggee, _reason: string) => {
|
const listener = (source: chrome.debugger.Debuggee, _reason: string) => {
|
||||||
if (typeof source.tabId === "number") {
|
if (typeof source.tabId === "number") {
|
||||||
this.attachedTabs.delete(source.tabId);
|
this.attachedTabs.delete(source.tabId);
|
||||||
this.attachmentIds.delete(source.tabId);
|
|
||||||
this.attachInFlight.delete(source.tabId);
|
this.attachInFlight.delete(source.tabId);
|
||||||
this.tabOwners.delete(source.tabId);
|
this.tabOwners.delete(source.tabId);
|
||||||
this.clearDialogState(source.tabId);
|
this.clearDialogState(source.tabId);
|
||||||
|
|||||||
@@ -599,79 +599,6 @@ describe("ToolDispatcher", () => {
|
|||||||
expect(onSessionsChanged).toHaveBeenCalledTimes(2);
|
expect(onSessionsChanged).toHaveBeenCalledTimes(2);
|
||||||
});
|
});
|
||||||
|
|
||||||
it.each([
|
|
||||||
"focus",
|
|
||||||
"blur",
|
|
||||||
"scroll_to",
|
|
||||||
] as const)("routes %s with hover cleanup and cooperative cancellation", async (action) => {
|
|
||||||
const tab = { id: 7, windowId: 4242, active: true };
|
|
||||||
vi.stubGlobal("chrome", {
|
|
||||||
tabs: {
|
|
||||||
get: vi.fn(async () => tab),
|
|
||||||
query: vi.fn(async () => [tab]),
|
|
||||||
sendMessage: vi.fn(async () => undefined),
|
|
||||||
},
|
|
||||||
});
|
|
||||||
const sessions = new SessionManager({
|
|
||||||
agentWindow: {
|
|
||||||
create: async () => 4242,
|
|
||||||
remove: async () => {},
|
|
||||||
ensureActiveTab: async () => 7,
|
|
||||||
},
|
|
||||||
});
|
|
||||||
const ctx = await sessions.start("aa11");
|
|
||||||
ctx.refStore.set("e1", 12, { tabId: 7 });
|
|
||||||
const { transport, sent, deliver } = fakeTransport();
|
|
||||||
const onBrowserControlResumed = vi.fn();
|
|
||||||
let resolveNode: ((value: object) => void) | undefined;
|
|
||||||
const cdp = {
|
|
||||||
send: vi.fn(async (_tabId: number, method: string) => {
|
|
||||||
if (method === "DOM.resolveNode")
|
|
||||||
return new Promise((resolve) => {
|
|
||||||
resolveNode = resolve;
|
|
||||||
});
|
|
||||||
if (method === "Runtime.callFunctionOn") return { result: { value: true } };
|
|
||||||
return {};
|
|
||||||
}),
|
|
||||||
} as unknown as TestDispatcherCdp;
|
|
||||||
const dispatcher = new ToolDispatcher({ transport, sessions, cdp, onBrowserControlResumed });
|
|
||||||
const hover = dispatcher as unknown as {
|
|
||||||
rememberHover: (sessionId: string, result: object) => void;
|
|
||||||
setHoverBypass: (sessionId: string, tabId: number, enabled: boolean) => Promise<void>;
|
|
||||||
};
|
|
||||||
hover.rememberHover("aa11", { tab_id: 7, x: 10, y: 20 });
|
|
||||||
await hover.setHoverBypass("aa11", 7, true);
|
|
||||||
dispatcher.start();
|
|
||||||
deliver(makeRequest(`tool.${action}`, { session_id: "aa11", ref: "e1" }));
|
|
||||||
await vi.waitFor(() => expect(resolveNode).toBeDefined());
|
|
||||||
expect(onBrowserControlResumed).toHaveBeenCalledWith("aa11");
|
|
||||||
deliver({ id: "cancel-focus", method: "cancel", params: { rpc_id: "r-1" } });
|
|
||||||
resolveNode!({ object: { objectId: "focus-target" } });
|
|
||||||
await vi.waitFor(() => expect(sent).toHaveLength(2));
|
|
||||||
expect(sent).toContainEqual({ id: "cancel-focus", result: { cancelled: true } });
|
|
||||||
expect(sent).toContainEqual({
|
|
||||||
id: "r-1",
|
|
||||||
error: expect.objectContaining({ code: "cancelled" }),
|
|
||||||
});
|
|
||||||
expect(cdp.send).not.toHaveBeenCalledWith(7, "DOM.focus", expect.anything());
|
|
||||||
expect(cdp.send).not.toHaveBeenCalledWith(7, "Runtime.callFunctionOn", expect.anything());
|
|
||||||
if (action === "scroll_to") {
|
|
||||||
expect(cdp.send).toHaveBeenCalledWith(7, "Runtime.releaseObjectGroup", {
|
|
||||||
objectGroup: expect.any(String),
|
|
||||||
});
|
|
||||||
} else {
|
|
||||||
expect(cdp.send).toHaveBeenCalledWith(7, "Runtime.releaseObject", {
|
|
||||||
objectId: "focus-target",
|
|
||||||
});
|
|
||||||
}
|
|
||||||
expect(chrome.tabs.sendMessage).toHaveBeenCalledWith(
|
|
||||||
7,
|
|
||||||
expect.objectContaining({ enabled: false }),
|
|
||||||
);
|
|
||||||
expect(dispatcher.inflightAbortControllers.size).toBe(0);
|
|
||||||
dispatcher.stop();
|
|
||||||
});
|
|
||||||
|
|
||||||
it("invokes onBrowserControlResumed for browser-control tools but not passive reads", async () => {
|
it("invokes onBrowserControlResumed for browser-control tools but not passive reads", async () => {
|
||||||
vi.stubGlobal("chrome", {
|
vi.stubGlobal("chrome", {
|
||||||
tabs: {
|
tabs: {
|
||||||
|
|||||||
@@ -436,8 +436,6 @@ describe("file transfer tools", () => {
|
|||||||
if (method === "DOM.getContentQuads") {
|
if (method === "DOM.getContentQuads") {
|
||||||
return { quads: [[10, 20, 210, 20, 210, 120, 10, 120]] };
|
return { quads: [[10, 20, 210, 20, 210, 120, 10, 120]] };
|
||||||
}
|
}
|
||||||
if (method === "Runtime.evaluate")
|
|
||||||
return { result: { value: { width: 400, height: 300 } } };
|
|
||||||
if (method === "Page.getLayoutMetrics") {
|
if (method === "Page.getLayoutMetrics") {
|
||||||
return { cssLayoutViewport: { clientWidth: 400, clientHeight: 300 } };
|
return { cssLayoutViewport: { clientWidth: 400, clientHeight: 300 } };
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -1,166 +0,0 @@
|
|||||||
// @vitest-environment node
|
|
||||||
// Opt in with BSK_FOCUS_CHROME=/path/to/chrome; each test owns its browser/profile.
|
|
||||||
import { describe, expect, it } from "vitest";
|
|
||||||
import { SessionManager } from "@/session-manager/manager";
|
|
||||||
import { handleBlur, handleFocus } from "../interaction";
|
|
||||||
import type { CdpRunner } from "../shared";
|
|
||||||
|
|
||||||
type Send = <T = Record<string, unknown>>(
|
|
||||||
method: string,
|
|
||||||
params?: object,
|
|
||||||
sessionId?: string,
|
|
||||||
) => Promise<T>;
|
|
||||||
|
|
||||||
async function withFocusBrowser(
|
|
||||||
run: (h: {
|
|
||||||
evaluate: (expression: string) => Promise<unknown>;
|
|
||||||
ref: () => Promise<void>;
|
|
||||||
focus: (signal?: AbortSignal) => ReturnType<typeof handleFocus>;
|
|
||||||
blur: (signal?: AbortSignal) => ReturnType<typeof handleBlur>;
|
|
||||||
calls: string[];
|
|
||||||
afterCommand: { current: (method: string) => void };
|
|
||||||
}) => Promise<void>,
|
|
||||||
) {
|
|
||||||
// Reuse the existing isolated Chrome launcher; no new browser dependency.
|
|
||||||
const { withChrome } = await import(
|
|
||||||
new URL(
|
|
||||||
"../../../../../evals/browser/cases/regression/snapshot-coordinates/chrome.mjs",
|
|
||||||
import.meta.url,
|
|
||||||
).href
|
|
||||||
);
|
|
||||||
await withChrome(
|
|
||||||
{ executable: process.env.BSK_FOCUS_CHROME, deviceScale: 1, zoom: 1 },
|
|
||||||
async (send: Send) => {
|
|
||||||
const { targetId } = await send<{ targetId: string }>("Target.createTarget", {
|
|
||||||
url: "about:blank",
|
|
||||||
});
|
|
||||||
const { sessionId } = await send<{ sessionId: string }>("Target.attachToTarget", {
|
|
||||||
targetId,
|
|
||||||
flatten: true,
|
|
||||||
});
|
|
||||||
await send("Page.bringToFront", {}, sessionId);
|
|
||||||
const evaluate = async (expression: string) => {
|
|
||||||
const reply = await send<{ result: { value: unknown }; exceptionDetails?: unknown }>(
|
|
||||||
"Runtime.evaluate",
|
|
||||||
{ expression, returnByValue: true },
|
|
||||||
sessionId,
|
|
||||||
);
|
|
||||||
expect(reply.exceptionDetails).toBeUndefined();
|
|
||||||
return reply.result.value;
|
|
||||||
};
|
|
||||||
await evaluate(
|
|
||||||
`document.body.innerHTML = '<input id="target"><input id="other">'; window.probe = document.querySelector('#target');`,
|
|
||||||
);
|
|
||||||
const manager = new SessionManager({
|
|
||||||
agentWindow: {
|
|
||||||
create: async () => 100,
|
|
||||||
remove: async () => {},
|
|
||||||
ensureActiveTab: async () => 4,
|
|
||||||
},
|
|
||||||
});
|
|
||||||
const ctx = await manager.start("aa11");
|
|
||||||
const calls: string[] = [];
|
|
||||||
const afterCommand = { current: (_method: string) => {} };
|
|
||||||
const cdp: CdpRunner = {
|
|
||||||
send: async (_tabId, method, params) => {
|
|
||||||
calls.push(method);
|
|
||||||
const result = await send(method, params, sessionId);
|
|
||||||
afterCommand.current(method);
|
|
||||||
return result as never;
|
|
||||||
},
|
|
||||||
};
|
|
||||||
const deps = {
|
|
||||||
cdp,
|
|
||||||
tabsApi: {
|
|
||||||
get: async (id: number) => ({ id, windowId: 100, active: true }) as chrome.tabs.Tab,
|
|
||||||
query: async () => [{ id: 4, windowId: 100, active: true } as chrome.tabs.Tab],
|
|
||||||
},
|
|
||||||
};
|
|
||||||
await run({
|
|
||||||
evaluate,
|
|
||||||
calls,
|
|
||||||
afterCommand,
|
|
||||||
ref: async () => {
|
|
||||||
const { result } = await send<{ result: { objectId: string } }>(
|
|
||||||
"Runtime.evaluate",
|
|
||||||
{ expression: "window.probe" },
|
|
||||||
sessionId,
|
|
||||||
);
|
|
||||||
const { node } = await send<{ node: { backendNodeId: number } }>(
|
|
||||||
"DOM.describeNode",
|
|
||||||
{ objectId: result.objectId },
|
|
||||||
sessionId,
|
|
||||||
);
|
|
||||||
await send("Runtime.releaseObject", { objectId: result.objectId }, sessionId);
|
|
||||||
ctx.refStore.set("e1", node.backendNodeId, { tabId: 4 });
|
|
||||||
},
|
|
||||||
focus: (signal) =>
|
|
||||||
handleFocus(manager, { session_id: "aa11", ref: "e1" }, { ...deps, signal }),
|
|
||||||
blur: (signal) =>
|
|
||||||
handleBlur(manager, { session_id: "aa11", ref: "e1" }, { ...deps, signal }),
|
|
||||||
});
|
|
||||||
},
|
|
||||||
);
|
|
||||||
}
|
|
||||||
|
|
||||||
describe.skipIf(!process.env.BSK_FOCUS_CHROME)("real browser focus and blur", () => {
|
|
||||||
it.each(["light", "open", "closed"])("verifies focus and blur in %s DOM", async (mode) => {
|
|
||||||
await withFocusBrowser(async (h) => {
|
|
||||||
if (mode !== "light")
|
|
||||||
await h.evaluate(`(() => {
|
|
||||||
const host = document.createElement('div'); document.body.append(host);
|
|
||||||
const nested = document.createElement('div'); host.attachShadow({mode:'${mode}'}).append(nested);
|
|
||||||
const input = document.createElement('input'); nested.attachShadow({mode:'${mode}'}).append(input);
|
|
||||||
window.probe = input;
|
|
||||||
})()`);
|
|
||||||
await h.ref();
|
|
||||||
expect(await h.focus()).toMatchObject({ focused: true });
|
|
||||||
expect(await h.evaluate("window.probe.matches(':focus')")).toBe(true);
|
|
||||||
expect(await h.blur()).toMatchObject({ was_focused: true, focused: false });
|
|
||||||
expect(await h.evaluate("window.probe.matches(':focus')")).toBe(false);
|
|
||||||
expect(h.calls.filter((method) => method === "Runtime.releaseObject")).toHaveLength(2);
|
|
||||||
});
|
|
||||||
});
|
|
||||||
|
|
||||||
it("detects focus changes from event-handler microtasks", async () => {
|
|
||||||
await withFocusBrowser(async (h) => {
|
|
||||||
await h.ref();
|
|
||||||
await h.evaluate(
|
|
||||||
"window.probe.addEventListener('focus', () => queueMicrotask(() => document.querySelector('#other').focus()), {once:true})",
|
|
||||||
);
|
|
||||||
expect(await h.focus()).toMatchObject({ code: "cdp_failed" });
|
|
||||||
expect(await h.focus()).toMatchObject({ focused: true });
|
|
||||||
await h.evaluate(
|
|
||||||
"window.probe.addEventListener('blur', () => queueMicrotask(() => window.probe.focus()), {once:true})",
|
|
||||||
);
|
|
||||||
expect(await h.blur()).toMatchObject({ code: "cdp_failed" });
|
|
||||||
expect(await h.evaluate("window.probe.matches(':focus')")).toBe(true);
|
|
||||||
});
|
|
||||||
});
|
|
||||||
|
|
||||||
it("cancels before blur while still releasing the resolved object", async () => {
|
|
||||||
await withFocusBrowser(async (h) => {
|
|
||||||
await h.ref();
|
|
||||||
await h.focus();
|
|
||||||
const abort = new AbortController();
|
|
||||||
h.afterCommand.current = (method) => {
|
|
||||||
if (method === "DOM.resolveNode") abort.abort();
|
|
||||||
};
|
|
||||||
expect(await h.blur(abort.signal)).toMatchObject({ code: "cancelled" });
|
|
||||||
expect(await h.evaluate("window.probe.matches(':focus')")).toBe(true);
|
|
||||||
expect(h.calls.at(-1)).toBe("Runtime.releaseObject");
|
|
||||||
});
|
|
||||||
});
|
|
||||||
|
|
||||||
it("reports a page exception with its cause", async () => {
|
|
||||||
await withFocusBrowser(async (h) => {
|
|
||||||
await h.ref();
|
|
||||||
await h.evaluate("window.probe.blur = () => { throw new Error('page blur failed'); }");
|
|
||||||
expect(await h.blur()).toMatchObject({
|
|
||||||
code: "cdp_failed",
|
|
||||||
message: expect.stringContaining("page blur failed"),
|
|
||||||
});
|
|
||||||
expect(h.calls.at(-1)).toBe("Runtime.releaseObject");
|
|
||||||
});
|
|
||||||
});
|
|
||||||
});
|
|
||||||
@@ -1,293 +0,0 @@
|
|||||||
import { afterEach, describe, expect, it, vi } from "vitest";
|
|
||||||
import type { CdpTarget } from "@/browser-driver/frame-graph";
|
|
||||||
import { SessionManager } from "@/session-manager/manager";
|
|
||||||
import { handleBlur, handleFocus } from "../interaction";
|
|
||||||
import type { CdpRunner } from "../shared";
|
|
||||||
|
|
||||||
interface ScriptParams {
|
|
||||||
functionDeclaration: string;
|
|
||||||
}
|
|
||||||
interface Call {
|
|
||||||
target: CdpTarget;
|
|
||||||
method: string;
|
|
||||||
}
|
|
||||||
|
|
||||||
async function setup(element?: HTMLElement, childSession = false) {
|
|
||||||
if (!element) {
|
|
||||||
document.body.innerHTML = '<input id="target"><input id="other">';
|
|
||||||
element = document.querySelector<HTMLInputElement>("#target")!;
|
|
||||||
}
|
|
||||||
const targetElement = element;
|
|
||||||
const manager = new SessionManager({
|
|
||||||
agentWindow: {
|
|
||||||
create: async () => 100,
|
|
||||||
remove: async () => {},
|
|
||||||
ensureActiveTab: async () => 4,
|
|
||||||
},
|
|
||||||
});
|
|
||||||
const ctx = await manager.start("aa11");
|
|
||||||
ctx.refStore.set("e1", 12, {
|
|
||||||
tabId: 4,
|
|
||||||
...(childSession ? { frameId: "child", cdpSessionId: "child-session" } : {}),
|
|
||||||
});
|
|
||||||
const calls: Call[] = [];
|
|
||||||
const afterCommand = vi.fn<(call: Call) => void>();
|
|
||||||
const script = vi.fn(async (params: ScriptParams) => {
|
|
||||||
try {
|
|
||||||
const fn = new Function(`return (${params.functionDeclaration})`)();
|
|
||||||
return { result: { value: await fn.call(targetElement) } };
|
|
||||||
} catch (error) {
|
|
||||||
return { exceptionDetails: { text: "Uncaught", exception: { description: String(error) } } };
|
|
||||||
}
|
|
||||||
});
|
|
||||||
const focus = vi.fn(() => targetElement.focus());
|
|
||||||
const release = vi.fn(async () => ({}));
|
|
||||||
const send = async (target: CdpTarget, method: string, params?: object) => {
|
|
||||||
const call = { target, method };
|
|
||||||
calls.push(call);
|
|
||||||
try {
|
|
||||||
switch (method) {
|
|
||||||
case "DOM.getDocument":
|
|
||||||
return { root: { nodeId: 1 } };
|
|
||||||
case "DOM.querySelector":
|
|
||||||
return { nodeId: 2 };
|
|
||||||
case "DOM.describeNode":
|
|
||||||
return { node: { backendNodeId: 12 } };
|
|
||||||
case "DOM.scrollIntoViewIfNeeded":
|
|
||||||
return {};
|
|
||||||
case "DOM.resolveNode":
|
|
||||||
return { object: { objectId: "focus-target" } };
|
|
||||||
case "DOM.focus":
|
|
||||||
focus();
|
|
||||||
return {};
|
|
||||||
case "Runtime.callFunctionOn":
|
|
||||||
return await script(params as ScriptParams);
|
|
||||||
case "Runtime.releaseObject":
|
|
||||||
return await release();
|
|
||||||
default:
|
|
||||||
throw new Error(`unexpected ${method}`);
|
|
||||||
}
|
|
||||||
} finally {
|
|
||||||
afterCommand(call);
|
|
||||||
}
|
|
||||||
};
|
|
||||||
const cdp: CdpRunner = {
|
|
||||||
send: (tabId, method, params) => send({ tabId }, method, params) as never,
|
|
||||||
sendToTarget: send as CdpRunner["sendToTarget"],
|
|
||||||
getFrameGraph: vi.fn(async () => ({
|
|
||||||
rootFrameId: "main",
|
|
||||||
frames: [
|
|
||||||
{ frameId: "main", target: { tabId: 4 } },
|
|
||||||
...(childSession
|
|
||||||
? [
|
|
||||||
{
|
|
||||||
frameId: "child",
|
|
||||||
parentFrameId: "main",
|
|
||||||
ownerBackendNodeId: 99,
|
|
||||||
target: { tabId: 4, sessionId: "child-session" },
|
|
||||||
},
|
|
||||||
]
|
|
||||||
: []),
|
|
||||||
],
|
|
||||||
})),
|
|
||||||
};
|
|
||||||
const tabsApi = {
|
|
||||||
get: vi.fn(async (id: number) => ({ id, windowId: 100, active: true }) as chrome.tabs.Tab),
|
|
||||||
query: vi.fn(async () => [{ id: 4, windowId: 100, active: true } as chrome.tabs.Tab]),
|
|
||||||
};
|
|
||||||
return {
|
|
||||||
element: targetElement,
|
|
||||||
calls,
|
|
||||||
afterCommand,
|
|
||||||
script,
|
|
||||||
focus,
|
|
||||||
release,
|
|
||||||
cdp,
|
|
||||||
tabsApi,
|
|
||||||
run: (
|
|
||||||
action: "focus" | "blur",
|
|
||||||
signal?: AbortSignal,
|
|
||||||
params: { ref?: string; selector?: string; tab_id?: number } = { ref: "e1" },
|
|
||||||
) =>
|
|
||||||
(action === "focus" ? handleFocus : handleBlur)(
|
|
||||||
manager,
|
|
||||||
{ session_id: "aa11", ...params },
|
|
||||||
{ cdp, tabsApi, signal },
|
|
||||||
),
|
|
||||||
};
|
|
||||||
}
|
|
||||||
|
|
||||||
afterEach(() => {
|
|
||||||
vi.restoreAllMocks();
|
|
||||||
document.body.innerHTML = "";
|
|
||||||
});
|
|
||||||
|
|
||||||
describe("focus and blur state verification", () => {
|
|
||||||
it.each(["open", "closed"] as const)("handles nested %s shadow roots", async (mode) => {
|
|
||||||
const host = document.createElement("div");
|
|
||||||
document.body.append(host);
|
|
||||||
const outer = host.attachShadow({ mode });
|
|
||||||
const innerHost = document.createElement("div");
|
|
||||||
outer.append(innerHost);
|
|
||||||
const inner = innerHost.attachShadow({ mode });
|
|
||||||
const element = document.createElement("input");
|
|
||||||
inner.append(element);
|
|
||||||
const h = await setup(element);
|
|
||||||
expect(await h.run("focus")).toMatchObject({ focused: true });
|
|
||||||
expect(inner.activeElement).toBe(element);
|
|
||||||
expect(await h.run("blur")).toMatchObject({ was_focused: true, focused: false });
|
|
||||||
expect(inner.activeElement).toBeNull();
|
|
||||||
expect(h.release).toHaveBeenCalledTimes(2);
|
|
||||||
});
|
|
||||||
|
|
||||||
it("keeps DOM focus usable when the document is in the background", async () => {
|
|
||||||
const h = await setup();
|
|
||||||
vi.spyOn(document, "hasFocus").mockReturnValue(false);
|
|
||||||
expect(await h.run("focus")).toMatchObject({ focused: true });
|
|
||||||
expect(await h.run("blur")).toMatchObject({ was_focused: true, focused: false });
|
|
||||||
});
|
|
||||||
|
|
||||||
it("blurring an unfocused target preserves the other element's focus", async () => {
|
|
||||||
const h = await setup();
|
|
||||||
const other = document.querySelector<HTMLInputElement>("#other")!;
|
|
||||||
other.focus();
|
|
||||||
expect(await h.run("blur")).toMatchObject({ was_focused: false, focused: false });
|
|
||||||
expect(document.activeElement).toBe(other);
|
|
||||||
});
|
|
||||||
|
|
||||||
it("detects focus redirected by a focus handler's microtask", async () => {
|
|
||||||
const h = await setup();
|
|
||||||
h.element.addEventListener("focus", () =>
|
|
||||||
queueMicrotask(() => document.querySelector<HTMLInputElement>("#other")!.focus()),
|
|
||||||
);
|
|
||||||
expect(await h.run("focus")).toMatchObject({
|
|
||||||
code: "cdp_failed",
|
|
||||||
message: "target element did not become focused",
|
|
||||||
});
|
|
||||||
expect(h.release).toHaveBeenCalledOnce();
|
|
||||||
});
|
|
||||||
|
|
||||||
it("does not report blur success when a microtask restores focus", async () => {
|
|
||||||
const h = await setup();
|
|
||||||
h.element.focus();
|
|
||||||
h.element.addEventListener("blur", () => queueMicrotask(() => h.element.focus()));
|
|
||||||
expect(await h.run("blur")).toMatchObject({
|
|
||||||
code: "cdp_failed",
|
|
||||||
message: "target element remained focused after blur()",
|
|
||||||
});
|
|
||||||
expect(document.activeElement).toBe(h.element);
|
|
||||||
expect(h.release).toHaveBeenCalledOnce();
|
|
||||||
});
|
|
||||||
|
|
||||||
it.each(["focus", "blur"] as const)("rejects a detached %s target", async (action) => {
|
|
||||||
const h = await setup();
|
|
||||||
h.element.remove();
|
|
||||||
expect(await h.run(action)).toMatchObject({ code: "cdp_failed" });
|
|
||||||
expect(h.release).toHaveBeenCalledOnce();
|
|
||||||
});
|
|
||||||
|
|
||||||
it("preserves a script exception's cause", async () => {
|
|
||||||
const h = await setup();
|
|
||||||
vi.spyOn(h.element, "blur").mockImplementation(() => {
|
|
||||||
throw new Error("page blur failed");
|
|
||||||
});
|
|
||||||
expect(await h.run("blur")).toMatchObject({
|
|
||||||
code: "cdp_failed",
|
|
||||||
message: expect.stringContaining("page blur failed"),
|
|
||||||
});
|
|
||||||
expect(h.release).toHaveBeenCalledOnce();
|
|
||||||
});
|
|
||||||
|
|
||||||
it.each(["focus", "blur"] as const)("rejects malformed %s script results", async (action) => {
|
|
||||||
const h = await setup();
|
|
||||||
h.script.mockResolvedValueOnce({ result: { value: null } });
|
|
||||||
expect(await h.run(action)).toMatchObject({
|
|
||||||
code: "cdp_failed",
|
|
||||||
message: expect.stringContaining("unexpected result"),
|
|
||||||
});
|
|
||||||
expect(h.release).toHaveBeenCalledOnce();
|
|
||||||
});
|
|
||||||
|
|
||||||
it.each([
|
|
||||||
"focus",
|
|
||||||
"blur",
|
|
||||||
] as const)("keeps %s, verification and cleanup in the OOPIF session", async (action) => {
|
|
||||||
const h = await setup(undefined, true);
|
|
||||||
if (action === "blur") h.element.focus();
|
|
||||||
expect(await h.run(action)).toMatchObject({ focused: action === "focus" });
|
|
||||||
const targetCalls = h.calls.filter((call) => call.method !== "DOM.scrollIntoViewIfNeeded");
|
|
||||||
expect(targetCalls.every((call) => call.target.sessionId === "child-session")).toBe(true);
|
|
||||||
expect(targetCalls.at(-1)?.method).toBe("Runtime.releaseObject");
|
|
||||||
});
|
|
||||||
|
|
||||||
it.each(["focus", "blur"] as const)("rejects %s on a user tab before CDP", async (action) => {
|
|
||||||
const h = await setup();
|
|
||||||
h.tabsApi.get.mockResolvedValue({ id: 9, windowId: 200, active: true } as chrome.tabs.Tab);
|
|
||||||
expect(await h.run(action, undefined, { ref: "e1", tab_id: 9 })).toMatchObject({
|
|
||||||
code: "permission_denied",
|
|
||||||
});
|
|
||||||
expect(h.calls).toEqual([]);
|
|
||||||
});
|
|
||||||
|
|
||||||
it("does not replace a successful result when navigation disposed the remote object", async () => {
|
|
||||||
const h = await setup();
|
|
||||||
h.release.mockRejectedValue(new Error("Cannot find context"));
|
|
||||||
expect(await h.run("focus")).toMatchObject({ focused: true });
|
|
||||||
});
|
|
||||||
});
|
|
||||||
|
|
||||||
describe("focus and blur cancellation", () => {
|
|
||||||
const boundaries = [
|
|
||||||
"DOM.getDocument",
|
|
||||||
"DOM.querySelector",
|
|
||||||
"DOM.describeNode",
|
|
||||||
"DOM.resolveNode",
|
|
||||||
"Runtime.callFunctionOn",
|
|
||||||
];
|
|
||||||
for (const action of ["focus", "blur"] as const) {
|
|
||||||
it.each(
|
|
||||||
action === "focus" ? [...boundaries, "DOM.scrollIntoViewIfNeeded", "DOM.focus"] : boundaries,
|
|
||||||
)(`${action} stops after cancellation during %s`, async (method) => {
|
|
||||||
const h = await setup();
|
|
||||||
const abort = new AbortController();
|
|
||||||
let cancelledAfter = 0;
|
|
||||||
h.afterCommand.mockImplementation((call) => {
|
|
||||||
if (call.method === method && !abort.signal.aborted) {
|
|
||||||
cancelledAfter = h.calls.length;
|
|
||||||
abort.abort();
|
|
||||||
}
|
|
||||||
});
|
|
||||||
expect(await h.run(action, abort.signal, { selector: "#target" })).toMatchObject({
|
|
||||||
code: "cancelled",
|
|
||||||
});
|
|
||||||
expect(abort.signal.aborted).toBe(true);
|
|
||||||
expect(
|
|
||||||
h.calls.slice(cancelledAfter).every((call) => call.method === "Runtime.releaseObject"),
|
|
||||||
).toBe(true);
|
|
||||||
if (h.calls.some((call) => call.method === "DOM.resolveNode"))
|
|
||||||
expect(h.release).toHaveBeenCalledOnce();
|
|
||||||
});
|
|
||||||
|
|
||||||
it(`${action} stops if cancellation arrives while resolving the tab`, async () => {
|
|
||||||
const h = await setup();
|
|
||||||
const abort = new AbortController();
|
|
||||||
h.tabsApi.query.mockImplementation(async () => {
|
|
||||||
abort.abort();
|
|
||||||
return [{ id: 4, windowId: 100, active: true } as chrome.tabs.Tab];
|
|
||||||
});
|
|
||||||
expect(await h.run(action, abort.signal)).toMatchObject({ code: "cancelled" });
|
|
||||||
expect(h.calls).toEqual([]);
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
it("does not scroll frame owners after cancellation in an OOPIF", async () => {
|
|
||||||
const h = await setup(undefined, true);
|
|
||||||
const abort = new AbortController();
|
|
||||||
h.afterCommand.mockImplementation((call) => {
|
|
||||||
if (call.method === "DOM.scrollIntoViewIfNeeded") abort.abort();
|
|
||||||
});
|
|
||||||
expect(await h.run("focus", abort.signal)).toMatchObject({ code: "cancelled" });
|
|
||||||
expect(h.calls.filter((call) => call.method === "DOM.scrollIntoViewIfNeeded")).toHaveLength(1);
|
|
||||||
expect(h.focus).not.toHaveBeenCalled();
|
|
||||||
});
|
|
||||||
});
|
|
||||||
@@ -13,138 +13,7 @@ import {
|
|||||||
import { GeometryContext } from "../geometry/frame-context";
|
import { GeometryContext } from "../geometry/frame-context";
|
||||||
import type { CdpRunner } from "../shared";
|
import type { CdpRunner } from "../shared";
|
||||||
|
|
||||||
function scrollbarDriver(
|
|
||||||
visible = { width: 185, height: 89 },
|
|
||||||
frameSize: unknown = { width: 200, height: 100 },
|
|
||||||
) {
|
|
||||||
const send = vi.fn(async (target: { sessionId?: string }, method: string) => {
|
|
||||||
if (method === "Runtime.evaluate") return { result: { value: frameSize } };
|
|
||||||
if (method === "Page.getLayoutMetrics")
|
|
||||||
return {
|
|
||||||
cssLayoutViewport: {
|
|
||||||
clientWidth: target.sessionId ? visible.width : 800,
|
|
||||||
clientHeight: target.sessionId ? visible.height : 600,
|
|
||||||
},
|
|
||||||
};
|
|
||||||
if (method === "DOM.getBoxModel")
|
|
||||||
return {
|
|
||||||
model: {
|
|
||||||
content: target.sessionId
|
|
||||||
? [0, 0, 200, 0, 200, 100, 0, 100]
|
|
||||||
: [100, 100, 500, 100, 500, 300, 100, 300],
|
|
||||||
},
|
|
||||||
};
|
|
||||||
if (method === "DOM.getContentQuads")
|
|
||||||
return { quads: [[180, 80, 230, 80, 230, 120, 180, 120]] };
|
|
||||||
throw new Error(`unexpected ${method}`);
|
|
||||||
});
|
|
||||||
const cdp: CdpRunner = {
|
|
||||||
send: (tabId, method) => send({ tabId } as never, method) as never,
|
|
||||||
sendToTarget: send as CdpRunner["sendToTarget"],
|
|
||||||
getFrameGraph: async () => ({
|
|
||||||
rootFrameId: "main",
|
|
||||||
frames: [
|
|
||||||
{ frameId: "main", target: { tabId: 4 } },
|
|
||||||
{
|
|
||||||
frameId: "child",
|
|
||||||
parentFrameId: "main",
|
|
||||||
ownerBackendNodeId: 10,
|
|
||||||
target: { tabId: 4, sessionId: "child" },
|
|
||||||
},
|
|
||||||
{
|
|
||||||
frameId: "same-child",
|
|
||||||
parentFrameId: "child",
|
|
||||||
ownerBackendNodeId: 20,
|
|
||||||
target: { tabId: 4, sessionId: "child" },
|
|
||||||
},
|
|
||||||
],
|
|
||||||
}),
|
|
||||||
};
|
|
||||||
return { cdp, send };
|
|
||||||
}
|
|
||||||
|
|
||||||
describe("frame geometry projection", () => {
|
describe("frame geometry projection", () => {
|
||||||
it.each([
|
|
||||||
{ width: 200, height: 100 },
|
|
||||||
{ width: 185, height: 100 },
|
|
||||||
{ width: 200, height: 89 },
|
|
||||||
{ width: 185, height: 89 },
|
|
||||||
])("preserves scale and clips scrollbar strips for visible viewport $width × $height", async (visible) => {
|
|
||||||
const { cdp, send } = scrollbarDriver(visible);
|
|
||||||
const geometry = await resolveNodeGeometry(cdp, 4, {
|
|
||||||
target: { tabId: 4, sessionId: "child" },
|
|
||||||
frameId: "child",
|
|
||||||
backendNodeId: 101,
|
|
||||||
});
|
|
||||||
expect(geometry).toMatchObject({
|
|
||||||
topBounds: {
|
|
||||||
x: 460,
|
|
||||||
y: 260,
|
|
||||||
width: (visible.width - 180) * 2,
|
|
||||||
height: (visible.height - 80) * 2,
|
|
||||||
},
|
|
||||||
actionPoint: { x: 460 + visible.width - 180, y: 260 + visible.height - 80 },
|
|
||||||
targetActionPoint: { x: (180 + visible.width) / 2, y: (80 + visible.height) / 2 },
|
|
||||||
});
|
|
||||||
expect(send.mock.calls.filter(([, method]) => method === "Runtime.evaluate")).toHaveLength(1);
|
|
||||||
expect(send.mock.calls.filter(([, method]) => method === "Page.getLayoutMetrics")).toHaveLength(
|
|
||||||
2,
|
|
||||||
);
|
|
||||||
});
|
|
||||||
|
|
||||||
it("shares the full viewport read across same-target frames, and refreshes it next operation", async () => {
|
|
||||||
const { cdp, send } = scrollbarDriver();
|
|
||||||
const context = new GeometryContext(cdp, 4);
|
|
||||||
await Promise.all([context.targetProjection("child"), context.targetProjection("same-child")]);
|
|
||||||
expect(send.mock.calls.filter(([, method]) => method === "Runtime.evaluate")).toHaveLength(1);
|
|
||||||
await new GeometryContext(cdp, 4).targetProjection("child");
|
|
||||||
expect(send.mock.calls.filter(([, method]) => method === "Runtime.evaluate")).toHaveLength(2);
|
|
||||||
});
|
|
||||||
|
|
||||||
it.each([
|
|
||||||
null,
|
|
||||||
{},
|
|
||||||
{ width: 0, height: 100 },
|
|
||||||
{ width: 200, height: NaN },
|
|
||||||
])("rejects unavailable full viewport dimensions: %j", async (size) => {
|
|
||||||
const { cdp } = scrollbarDriver(undefined, size);
|
|
||||||
expect(await new GeometryContext(cdp, 4).targetProjection("child")).toBeNull();
|
|
||||||
});
|
|
||||||
|
|
||||||
it("clips an inner OOPIF against an intermediate OOPIF's occupied scrollbar strips", async () => {
|
|
||||||
const { cdp } = scrollbarDriver();
|
|
||||||
const outer = cdp.sendToTarget!;
|
|
||||||
cdp.sendToTarget = async (target, method, params) => {
|
|
||||||
if (method === "DOM.getBoxModel")
|
|
||||||
return { model: { content: [150, 60, 250, 60, 250, 120, 150, 120] } } as never;
|
|
||||||
if (target.sessionId !== "inner") return outer(target, method, params);
|
|
||||||
if (method === "Runtime.evaluate")
|
|
||||||
return { result: { value: { width: 100, height: 60 } } } as never;
|
|
||||||
if (method === "Page.getLayoutMetrics")
|
|
||||||
return { cssLayoutViewport: { clientWidth: 90, clientHeight: 50 } } as never;
|
|
||||||
if (method === "DOM.getContentQuads")
|
|
||||||
return { quads: [[0, 0, 100, 0, 100, 60, 0, 60]] } as never;
|
|
||||||
throw new Error(`unexpected ${method}`);
|
|
||||||
};
|
|
||||||
const graph = await cdp.getFrameGraph!(4);
|
|
||||||
graph.frames[2] = {
|
|
||||||
frameId: "inner",
|
|
||||||
parentFrameId: "child",
|
|
||||||
ownerBackendNodeId: 20,
|
|
||||||
target: { tabId: 4, sessionId: "inner" },
|
|
||||||
};
|
|
||||||
cdp.getFrameGraph = async () => graph;
|
|
||||||
expect(
|
|
||||||
await resolveNodeGeometry(cdp, 4, {
|
|
||||||
target: { tabId: 4, sessionId: "inner" },
|
|
||||||
frameId: "inner",
|
|
||||||
backendNodeId: 101,
|
|
||||||
}),
|
|
||||||
).toMatchObject({
|
|
||||||
topBounds: { x: 400, y: 220, width: 70, height: 58 },
|
|
||||||
});
|
|
||||||
});
|
|
||||||
|
|
||||||
it("keeps region bounds separate from polygon area", () => {
|
it("keeps region bounds separate from polygon area", () => {
|
||||||
const region = [
|
const region = [
|
||||||
rectPolygon({ x: 0, y: 0, w: 10, h: 10 }),
|
rectPolygon({ x: 0, y: 0, w: 10, h: 10 }),
|
||||||
@@ -208,8 +77,6 @@ describe("frame geometry projection", () => {
|
|||||||
const cdp: CdpRunner = {
|
const cdp: CdpRunner = {
|
||||||
send: send as CdpRunner["send"],
|
send: send as CdpRunner["send"],
|
||||||
sendToTarget: vi.fn(async (_target, method) => {
|
sendToTarget: vi.fn(async (_target, method) => {
|
||||||
if (method === "Runtime.evaluate")
|
|
||||||
return { result: { value: { width: 200, height: 100 } } };
|
|
||||||
if (method === "Page.getLayoutMetrics") {
|
if (method === "Page.getLayoutMetrics") {
|
||||||
return { cssLayoutViewport: { clientWidth: 200, clientHeight: 100 } };
|
return { cssLayoutViewport: { clientWidth: 200, clientHeight: 100 } };
|
||||||
}
|
}
|
||||||
@@ -268,8 +135,6 @@ describe("frame geometry projection", () => {
|
|||||||
throw new Error(`unexpected root command ${method}`);
|
throw new Error(`unexpected root command ${method}`);
|
||||||
}) as CdpRunner["send"],
|
}) as CdpRunner["send"],
|
||||||
sendToTarget: vi.fn(async (_target, method) => {
|
sendToTarget: vi.fn(async (_target, method) => {
|
||||||
if (method === "Runtime.evaluate")
|
|
||||||
return { result: { value: { width: 200, height: 100 } } };
|
|
||||||
if (method === "Page.getLayoutMetrics") {
|
if (method === "Page.getLayoutMetrics") {
|
||||||
return { cssLayoutViewport: { clientWidth: 200, clientHeight: 100 } };
|
return { cssLayoutViewport: { clientWidth: 200, clientHeight: 100 } };
|
||||||
}
|
}
|
||||||
@@ -331,8 +196,6 @@ describe("frame geometry projection", () => {
|
|||||||
}) as CdpRunner["send"],
|
}) as CdpRunner["send"],
|
||||||
sendToTarget: vi.fn(async (_target, method) => {
|
sendToTarget: vi.fn(async (_target, method) => {
|
||||||
if (method === "DOM.scrollIntoViewIfNeeded") return {};
|
if (method === "DOM.scrollIntoViewIfNeeded") return {};
|
||||||
if (method === "Runtime.evaluate")
|
|
||||||
return { result: { value: { width: 200, height: 100 } } };
|
|
||||||
if (method === "Page.getLayoutMetrics") {
|
if (method === "Page.getLayoutMetrics") {
|
||||||
return { cssLayoutViewport: { clientWidth: 200, clientHeight: 100 } };
|
return { cssLayoutViewport: { clientWidth: 200, clientHeight: 100 } };
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -5,10 +5,9 @@ import { rectPolygon } from "../geometry";
|
|||||||
import {
|
import {
|
||||||
projectSnapshotRect,
|
projectSnapshotRect,
|
||||||
screenshotPageRect,
|
screenshotPageRect,
|
||||||
snapshotCoordinates,
|
|
||||||
snapshotViewportRect,
|
snapshotViewportRect,
|
||||||
} from "../geometry/coordinate-types";
|
} from "../geometry/coordinate-types";
|
||||||
import { GeometryContext, snapshotLayoutScale } from "../geometry/frame-context";
|
import { GeometryContext } from "../geometry/frame-context";
|
||||||
import type { CdpRunner } from "../shared";
|
import type { CdpRunner } from "../shared";
|
||||||
|
|
||||||
const target = { tabId: 4 };
|
const target = { tabId: 4 };
|
||||||
@@ -23,11 +22,7 @@ const graph: CdpFrameGraph = {
|
|||||||
function driver() {
|
function driver() {
|
||||||
const send = vi.fn(async (_tab: number, method: string): Promise<object> => {
|
const send = vi.fn(async (_tab: number, method: string): Promise<object> => {
|
||||||
if (method === "Page.getLayoutMetrics")
|
if (method === "Page.getLayoutMetrics")
|
||||||
return {
|
return { cssLayoutViewport: { clientWidth: 1000, clientHeight: 1000 } };
|
||||||
visualViewport: { clientWidth: 1000 },
|
|
||||||
cssVisualViewport: { clientWidth: 1000 },
|
|
||||||
cssLayoutViewport: { clientWidth: 1000, clientHeight: 1000 },
|
|
||||||
};
|
|
||||||
if (method === "DOM.getBoxModel")
|
if (method === "DOM.getBoxModel")
|
||||||
return { model: { content: [52.5, 612.5, 427.5, 612.5, 427.5, 862.5, 52.5, 862.5] } };
|
return { model: { content: [52.5, 612.5, 427.5, 612.5, 427.5, 862.5, 52.5, 862.5] } };
|
||||||
if (method === "DOM.resolveNode") return { object: { objectId: "owner" } };
|
if (method === "DOM.resolveNode") return { object: { objectId: "owner" } };
|
||||||
@@ -40,63 +35,6 @@ function driver() {
|
|||||||
}
|
}
|
||||||
|
|
||||||
describe("measurement geometry context", () => {
|
describe("measurement geometry context", () => {
|
||||||
it.each([0.8, 1, 1.25, 2])("normalizes snapshot layout units at scale %s", (scale) => {
|
|
||||||
const measured = snapshotLayoutScale({
|
|
||||||
visualViewport: { clientWidth: 997.25, zoom: 1.1 },
|
|
||||||
cssVisualViewport: { clientWidth: 997.25 / scale, zoom: 1.1 },
|
|
||||||
// Rounded layout dimensions must not supply the scale.
|
|
||||||
layoutViewport: { clientWidth: 997 },
|
|
||||||
cssLayoutViewport: { clientWidth: Math.floor(997.25 / scale) },
|
|
||||||
});
|
|
||||||
expect(measured).toBeCloseTo(scale, 12);
|
|
||||||
const coordinates = snapshotCoordinates(
|
|
||||||
{ scrollOffsetX: 80 * scale, scrollOffsetY: 200 * scale },
|
|
||||||
measured,
|
|
||||||
{ x: 999, y: 999 },
|
|
||||||
);
|
|
||||||
expect(
|
|
||||||
snapshotViewportRect(
|
|
||||||
[160 * scale, 320 * scale, 120 * scale, 40 * scale],
|
|
||||||
{ target },
|
|
||||||
coordinates,
|
|
||||||
)?.rect,
|
|
||||||
).toEqual({ x: 80, y: 120, width: 120, height: 40 });
|
|
||||||
});
|
|
||||||
|
|
||||||
it("uses CSS root scroll only for missing snapshot offsets, without scaling it twice", () => {
|
|
||||||
const coordinates = snapshotCoordinates({ scrollOffsetX: 80 }, 2, { x: 999, y: 100 });
|
|
||||||
expect(snapshotViewportRect([200, 800, 240, 80], { target }, coordinates)?.rect).toEqual({
|
|
||||||
x: 60,
|
|
||||||
y: 300,
|
|
||||||
width: 120,
|
|
||||||
height: 40,
|
|
||||||
});
|
|
||||||
expect(snapshotCoordinates({ scrollOffsetX: 0 }, 2)).toBeNull();
|
|
||||||
expect(
|
|
||||||
snapshotCoordinates({ scrollOffsetX: NaN, scrollOffsetY: 0 }, 2, { x: 0, y: 0 }),
|
|
||||||
).toBeNull();
|
|
||||||
});
|
|
||||||
|
|
||||||
it("does not infer snapshot units from missing, invalid, or CSS-only metrics", () => {
|
|
||||||
expect(snapshotLayoutScale({ cssLayoutViewport: { clientWidth: 800 } })).toBeNull();
|
|
||||||
for (const raw of [0, -1, NaN, Infinity]) {
|
|
||||||
expect(
|
|
||||||
snapshotLayoutScale({
|
|
||||||
visualViewport: { clientWidth: raw },
|
|
||||||
cssVisualViewport: { clientWidth: 800 },
|
|
||||||
}),
|
|
||||||
).toBeNull();
|
|
||||||
}
|
|
||||||
expect(
|
|
||||||
snapshotLayoutScale({
|
|
||||||
visualViewport: { clientWidth: 0, clientHeight: 600 },
|
|
||||||
cssVisualViewport: { clientWidth: 0, clientHeight: 300 },
|
|
||||||
}),
|
|
||||||
).toBe(2);
|
|
||||||
expect(snapshotCoordinates({ scrollOffsetX: 0, scrollOffsetY: 0 }, null)).toBeNull();
|
|
||||||
expect(snapshotViewportRect([10, 20, 120, 40], { target }, null)).toBeNull();
|
|
||||||
});
|
|
||||||
|
|
||||||
it("shares in-flight frame measurements, but never shares them with the next context", async () => {
|
it("shares in-flight frame measurements, but never shares them with the next context", async () => {
|
||||||
const cdp = driver();
|
const cdp = driver();
|
||||||
const context = new GeometryContext(cdp, 4);
|
const context = new GeometryContext(cdp, 4);
|
||||||
@@ -123,20 +61,14 @@ describe("measurement geometry context", () => {
|
|||||||
height: 1000,
|
height: 1000,
|
||||||
});
|
});
|
||||||
if (projection.status !== "available") throw new Error("expected available projection");
|
if (projection.status !== "available") throw new Error("expected available projection");
|
||||||
const input = snapshotViewportRect([17, 23, 120, 40], source, {
|
const input = snapshotViewportRect([17, 23, 120, 40], source, { x: 0, y: 0 });
|
||||||
layoutUnitsPerCssPixel: 1,
|
|
||||||
scrollCss: { x: 0, y: 0 },
|
|
||||||
});
|
|
||||||
expect(projectSnapshotRect(input!, projection.projection)).toEqual({
|
expect(projectSnapshotRect(input!, projection.projection)).toEqual({
|
||||||
x: 73.75,
|
x: 73.75,
|
||||||
y: 641.25,
|
y: 641.25,
|
||||||
width: 150,
|
width: 150,
|
||||||
height: 50,
|
height: 50,
|
||||||
});
|
});
|
||||||
const scrolled = snapshotViewportRect([17, 23, 120, 40], source, {
|
const scrolled = snapshotViewportRect([17, 23, 120, 40], source, { x: 0, y: 10 });
|
||||||
layoutUnitsPerCssPixel: 1,
|
|
||||||
scrollCss: { x: 0, y: 10 },
|
|
||||||
});
|
|
||||||
expect(projectSnapshotRect(scrolled!, projection.projection)?.y).toBe(628.75);
|
expect(projectSnapshotRect(scrolled!, projection.projection)?.y).toBe(628.75);
|
||||||
await context.snapshotProjection(source, 10, [], { width: 1000, height: 1000 });
|
await context.snapshotProjection(source, 10, [], { width: 1000, height: 1000 });
|
||||||
expect(cdp.calls.mock.calls.filter(([, method]) => method === "DOM.resolveNode")).toHaveLength(
|
expect(cdp.calls.mock.calls.filter(([, method]) => method === "DOM.resolveNode")).toHaveLength(
|
||||||
@@ -241,7 +173,7 @@ describe("measurement geometry context", () => {
|
|||||||
const input = snapshotViewportRect(
|
const input = snapshotViewportRect(
|
||||||
[30, 50, 120, 40],
|
[30, 50, 120, 40],
|
||||||
{ target, frameId: "main" },
|
{ target, frameId: "main" },
|
||||||
{ layoutUnitsPerCssPixel: 1, scrollCss: { x: 10, y: 20 } },
|
{ x: 10, y: 20 },
|
||||||
)!;
|
)!;
|
||||||
const projection = {
|
const projection = {
|
||||||
source: { target, frameId: "main" },
|
source: { target, frameId: "main" },
|
||||||
@@ -262,20 +194,8 @@ describe("measurement geometry context", () => {
|
|||||||
source: { target: { tabId: 5 }, frameId: "main" },
|
source: { target: { tabId: 5 }, frameId: "main" },
|
||||||
}),
|
}),
|
||||||
).toBeNull();
|
).toBeNull();
|
||||||
expect(
|
expect(snapshotViewportRect([0, 0, NaN, 40], { target }, { x: 0, y: 0 })).toBeNull();
|
||||||
snapshotViewportRect(
|
expect(snapshotViewportRect([0, 0, 10, 40], { target }, { x: Infinity, y: 0 })).toBeNull();
|
||||||
[0, 0, NaN, 40],
|
|
||||||
{ target },
|
|
||||||
{ layoutUnitsPerCssPixel: 1, scrollCss: { x: 0, y: 0 } },
|
|
||||||
),
|
|
||||||
).toBeNull();
|
|
||||||
expect(
|
|
||||||
snapshotViewportRect(
|
|
||||||
[0, 0, 10, 40],
|
|
||||||
{ target },
|
|
||||||
{ layoutUnitsPerCssPixel: 1, scrollCss: { x: Infinity, y: 0 } },
|
|
||||||
),
|
|
||||||
).toBeNull();
|
|
||||||
});
|
});
|
||||||
|
|
||||||
it("does not turn a border quad or a failed owner read into a content projection", async () => {
|
it("does not turn a border quad or a failed owner read into a content projection", async () => {
|
||||||
@@ -308,7 +228,7 @@ describe("measurement geometry context", () => {
|
|||||||
const input = snapshotViewportRect(
|
const input = snapshotViewportRect(
|
||||||
[0, 0, 300, 200],
|
[0, 0, 300, 200],
|
||||||
{ target, frameId: "nested" },
|
{ target, frameId: "nested" },
|
||||||
{ layoutUnitsPerCssPixel: 1, scrollCss: { x: 0, y: 0 } },
|
{ x: 0, y: 0 },
|
||||||
);
|
);
|
||||||
expect(projectSnapshotRect(input!, projection.projection)).toEqual({
|
expect(projectSnapshotRect(input!, projection.projection)).toEqual({
|
||||||
x: 60,
|
x: 60,
|
||||||
@@ -358,11 +278,7 @@ describe("measurement geometry context", () => {
|
|||||||
peak = Math.max(peak, active);
|
peak = Math.max(peak, active);
|
||||||
await new Promise<void>((resolve) => release.push(resolve));
|
await new Promise<void>((resolve) => release.push(resolve));
|
||||||
active--;
|
active--;
|
||||||
return {
|
return { cssLayoutViewport: { clientWidth: 100, clientHeight: 100 } };
|
||||||
visualViewport: { clientWidth: 1000 },
|
|
||||||
cssVisualViewport: { clientWidth: 1000 },
|
|
||||||
cssLayoutViewport: { clientWidth: 100, clientHeight: 100 },
|
|
||||||
};
|
|
||||||
});
|
});
|
||||||
const controller = new AbortController();
|
const controller = new AbortController();
|
||||||
const context = new GeometryContext(
|
const context = new GeometryContext(
|
||||||
|
|||||||
@@ -433,7 +433,6 @@ describe("handleRequestHelp", () => {
|
|||||||
if (method === "DOM.getContentQuads") {
|
if (method === "DOM.getContentQuads") {
|
||||||
return { quads: [[10, 20, 110, 20, 110, 60, 10, 60]] };
|
return { quads: [[10, 20, 110, 20, 110, 60, 10, 60]] };
|
||||||
}
|
}
|
||||||
if (method === "Runtime.evaluate") return { result: { value: { width: 200, height: 100 } } };
|
|
||||||
if (method === "Page.getLayoutMetrics") {
|
if (method === "Page.getLayoutMetrics") {
|
||||||
return { cssLayoutViewport: { clientWidth: 200, clientHeight: 100 } };
|
return { cssLayoutViewport: { clientWidth: 200, clientHeight: 100 } };
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -2,10 +2,8 @@ import { describe, expect, it, vi } from "vitest";
|
|||||||
import { SessionManager } from "@/session-manager/manager";
|
import { SessionManager } from "@/session-manager/manager";
|
||||||
import type { CdpRunner } from "@/tools/shared";
|
import type { CdpRunner } from "@/tools/shared";
|
||||||
import {
|
import {
|
||||||
handleBlur,
|
|
||||||
handleClick,
|
handleClick,
|
||||||
handleFill,
|
handleFill,
|
||||||
handleFocus,
|
|
||||||
handleHover,
|
handleHover,
|
||||||
handlePress,
|
handlePress,
|
||||||
handleSelect,
|
handleSelect,
|
||||||
@@ -203,7 +201,6 @@ describe("handleClick", () => {
|
|||||||
if (method === "DOM.getContentQuads") {
|
if (method === "DOM.getContentQuads") {
|
||||||
return { quads: [[10, 20, 110, 20, 110, 60, 10, 60]] };
|
return { quads: [[10, 20, 110, 20, 110, 60, 10, 60]] };
|
||||||
}
|
}
|
||||||
if (method === "Runtime.evaluate") return { result: { value: { width: 200, height: 100 } } };
|
|
||||||
if (method === "Page.getLayoutMetrics") {
|
if (method === "Page.getLayoutMetrics") {
|
||||||
return { cssLayoutViewport: { clientWidth: 200, clientHeight: 100 } };
|
return { cssLayoutViewport: { clientWidth: 200, clientHeight: 100 } };
|
||||||
}
|
}
|
||||||
@@ -223,7 +220,6 @@ describe("handleClick", () => {
|
|||||||
{ sessionId: "child-session", method: "DOM.scrollIntoViewIfNeeded" },
|
{ sessionId: "child-session", method: "DOM.scrollIntoViewIfNeeded" },
|
||||||
{ sessionId: "child-session", method: "DOM.getContentQuads" },
|
{ sessionId: "child-session", method: "DOM.getContentQuads" },
|
||||||
{ sessionId: "child-session", method: "Page.getLayoutMetrics" },
|
{ sessionId: "child-session", method: "Page.getLayoutMetrics" },
|
||||||
{ sessionId: "child-session", method: "Runtime.evaluate" },
|
|
||||||
]);
|
]);
|
||||||
expect(fake.sent.filter((call) => call.method === "Input.dispatchMouseEvent")).toHaveLength(3);
|
expect(fake.sent.filter((call) => call.method === "Input.dispatchMouseEvent")).toHaveLength(3);
|
||||||
});
|
});
|
||||||
@@ -544,161 +540,6 @@ describe("handleHover", () => {
|
|||||||
});
|
});
|
||||||
});
|
});
|
||||||
|
|
||||||
describe("handleFocus and handleBlur", () => {
|
|
||||||
it("focuses a ref and verifies the deep active element", async () => {
|
|
||||||
const sm = new SessionManager({ agentWindow: fakeAgentWindow([100]) });
|
|
||||||
const ctx = await sm.start("aa11");
|
|
||||||
ctx.refStore.set("e3", 1234, { tabId: 4 });
|
|
||||||
const fake = makeFakeCdp({
|
|
||||||
"DOM.scrollIntoViewIfNeeded": () => ({}),
|
|
||||||
"DOM.focus": () => ({}),
|
|
||||||
"DOM.resolveNode": () => ({ object: { objectId: "focus-target" } }),
|
|
||||||
"Runtime.callFunctionOn": () => ({ result: { value: true } }),
|
|
||||||
});
|
|
||||||
|
|
||||||
const res = await handleFocus(
|
|
||||||
sm,
|
|
||||||
{ session_id: "aa11", ref: "@e3" },
|
|
||||||
{ cdp: fake.cdp, tabsApi: fake.tabsApi },
|
|
||||||
);
|
|
||||||
|
|
||||||
if ("code" in res) throw new Error(`unexpected error: ${JSON.stringify(res)}`);
|
|
||||||
expect(res).toMatchObject({ tab_id: 4, used_ref: "e3", focused: true });
|
|
||||||
expect(fake.sent.map((call) => call.method)).toEqual([
|
|
||||||
"DOM.scrollIntoViewIfNeeded",
|
|
||||||
"DOM.resolveNode",
|
|
||||||
"DOM.focus",
|
|
||||||
"Runtime.callFunctionOn",
|
|
||||||
"Runtime.releaseObject",
|
|
||||||
]);
|
|
||||||
});
|
|
||||||
|
|
||||||
it("focuses an OOPIF ref in its CDP session", async () => {
|
|
||||||
const sm = new SessionManager({ agentWindow: fakeAgentWindow([100]) });
|
|
||||||
const ctx = await sm.start("aa11");
|
|
||||||
ctx.refStore.set("e3", 1234, {
|
|
||||||
tabId: 4,
|
|
||||||
frameId: "child-frame",
|
|
||||||
cdpSessionId: "child-session",
|
|
||||||
});
|
|
||||||
const fake = makeFakeCdp({
|
|
||||||
"DOM.scrollIntoViewIfNeeded": () => ({}),
|
|
||||||
});
|
|
||||||
fake.cdp.getFrameGraph = vi.fn(async () => ({
|
|
||||||
rootFrameId: "main",
|
|
||||||
frames: [
|
|
||||||
{ frameId: "main", target: { tabId: 4 } },
|
|
||||||
{
|
|
||||||
frameId: "child-frame",
|
|
||||||
parentFrameId: "main",
|
|
||||||
ownerBackendNodeId: 99,
|
|
||||||
target: { tabId: 4, sessionId: "child-session" },
|
|
||||||
},
|
|
||||||
],
|
|
||||||
}));
|
|
||||||
const targetCalls: Array<{ sessionId?: string; method: string }> = [];
|
|
||||||
fake.cdp.sendToTarget = vi.fn(async (target, method) => {
|
|
||||||
targetCalls.push({ sessionId: target.sessionId, method });
|
|
||||||
if (method === "DOM.scrollIntoViewIfNeeded") return {};
|
|
||||||
if (method === "DOM.focus" || method === "Runtime.releaseObject") return {};
|
|
||||||
if (method === "DOM.resolveNode") return { object: { objectId: "focus-target" } };
|
|
||||||
if (method === "Runtime.callFunctionOn") return { result: { value: true } };
|
|
||||||
throw new Error(`unexpected child CDP call ${method}`);
|
|
||||||
}) as CdpRunner["sendToTarget"];
|
|
||||||
|
|
||||||
const res = await handleFocus(
|
|
||||||
sm,
|
|
||||||
{ session_id: "aa11", ref: "@e3" },
|
|
||||||
{ cdp: fake.cdp, tabsApi: fake.tabsApi },
|
|
||||||
);
|
|
||||||
|
|
||||||
if ("code" in res) throw new Error(`unexpected error: ${JSON.stringify(res)}`);
|
|
||||||
expect(res.focused).toBe(true);
|
|
||||||
expect(targetCalls).toEqual([
|
|
||||||
{ sessionId: "child-session", method: "DOM.scrollIntoViewIfNeeded" },
|
|
||||||
{ sessionId: "child-session", method: "DOM.resolveNode" },
|
|
||||||
{ sessionId: "child-session", method: "DOM.focus" },
|
|
||||||
{ sessionId: "child-session", method: "Runtime.callFunctionOn" },
|
|
||||||
{ sessionId: "child-session", method: "Runtime.releaseObject" },
|
|
||||||
]);
|
|
||||||
});
|
|
||||||
|
|
||||||
it("does not focus after cancellation during scrolling", async () => {
|
|
||||||
const sm = new SessionManager({ agentWindow: fakeAgentWindow([100]) });
|
|
||||||
const ctx = await sm.start("aa11");
|
|
||||||
ctx.refStore.set("e3", 1234, { tabId: 4 });
|
|
||||||
const abort = new AbortController();
|
|
||||||
const fake = makeFakeCdp({
|
|
||||||
"DOM.scrollIntoViewIfNeeded": () => {
|
|
||||||
abort.abort();
|
|
||||||
return {};
|
|
||||||
},
|
|
||||||
});
|
|
||||||
|
|
||||||
const res = await handleFocus(
|
|
||||||
sm,
|
|
||||||
{ session_id: "aa11", ref: "@e3" },
|
|
||||||
{ cdp: fake.cdp, tabsApi: fake.tabsApi, signal: abort.signal },
|
|
||||||
);
|
|
||||||
|
|
||||||
expect(res).toMatchObject({ code: "cancelled" });
|
|
||||||
expect(fake.sent.some((call) => call.method === "DOM.focus")).toBe(false);
|
|
||||||
});
|
|
||||||
|
|
||||||
it("blurs a ref and returns its previous focus state", async () => {
|
|
||||||
const sm = new SessionManager({ agentWindow: fakeAgentWindow([100]) });
|
|
||||||
const ctx = await sm.start("aa11");
|
|
||||||
ctx.refStore.set("e3", 1234, { tabId: 4 });
|
|
||||||
const fake = makeFakeCdp({
|
|
||||||
"DOM.resolveNode": () => ({ object: { objectId: "focus-target" } }),
|
|
||||||
"Runtime.callFunctionOn": vi
|
|
||||||
.fn()
|
|
||||||
.mockResolvedValueOnce({ result: { value: { ok: true, was_focused: true } } })
|
|
||||||
.mockResolvedValueOnce({ result: { value: false } }),
|
|
||||||
});
|
|
||||||
|
|
||||||
const res = await handleBlur(
|
|
||||||
sm,
|
|
||||||
{ session_id: "aa11", ref: "@e3" },
|
|
||||||
{ cdp: fake.cdp, tabsApi: fake.tabsApi },
|
|
||||||
);
|
|
||||||
|
|
||||||
if ("code" in res) throw new Error(`unexpected error: ${JSON.stringify(res)}`);
|
|
||||||
expect(res).toMatchObject({
|
|
||||||
tab_id: 4,
|
|
||||||
used_ref: "e3",
|
|
||||||
was_focused: true,
|
|
||||||
focused: false,
|
|
||||||
});
|
|
||||||
expect(fake.sent.map((call) => call.method)).toEqual([
|
|
||||||
"DOM.resolveNode",
|
|
||||||
"Runtime.callFunctionOn",
|
|
||||||
"Runtime.callFunctionOn",
|
|
||||||
"Runtime.releaseObject",
|
|
||||||
]);
|
|
||||||
});
|
|
||||||
|
|
||||||
it("rejects a target that does not implement blur", async () => {
|
|
||||||
const sm = new SessionManager({ agentWindow: fakeAgentWindow([100]) });
|
|
||||||
const ctx = await sm.start("aa11");
|
|
||||||
ctx.refStore.set("e3", 1234, { tabId: 4 });
|
|
||||||
const fake = makeFakeCdp({
|
|
||||||
"DOM.resolveNode": () => ({ object: { objectId: "focus-target" } }),
|
|
||||||
"Runtime.callFunctionOn": () => ({
|
|
||||||
result: { value: { ok: false, was_focused: false, focused: false } },
|
|
||||||
}),
|
|
||||||
});
|
|
||||||
|
|
||||||
const res = await handleBlur(
|
|
||||||
sm,
|
|
||||||
{ session_id: "aa11", ref: "@e3" },
|
|
||||||
{ cdp: fake.cdp, tabsApi: fake.tabsApi },
|
|
||||||
);
|
|
||||||
|
|
||||||
expect(res).toMatchObject({ code: "invalid_params", message: /does not support blur/ });
|
|
||||||
});
|
|
||||||
});
|
|
||||||
|
|
||||||
function successfulFillScript(params: unknown) {
|
function successfulFillScript(params: unknown) {
|
||||||
const script = params as { arguments?: Array<{ value: unknown }>; functionDeclaration: string };
|
const script = params as { arguments?: Array<{ value: unknown }>; functionDeclaration: string };
|
||||||
const args = script.arguments ?? [];
|
const args = script.arguments ?? [];
|
||||||
|
|||||||
@@ -93,11 +93,7 @@ function makeFakeCdp(handlers: Record<string, (params?: object) => unknown>) {
|
|||||||
sent.push({ method, params });
|
sent.push({ method, params });
|
||||||
const handler = handlers[method];
|
const handler = handlers[method];
|
||||||
if (!handler && method === "Page.getLayoutMetrics") {
|
if (!handler && method === "Page.getLayoutMetrics") {
|
||||||
return {
|
return { cssLayoutViewport: { clientWidth: 1280, clientHeight: 720 } };
|
||||||
visualViewport: { clientWidth: 1000 },
|
|
||||||
cssVisualViewport: { clientWidth: 1000 },
|
|
||||||
cssLayoutViewport: { clientWidth: 1280, clientHeight: 720 },
|
|
||||||
};
|
|
||||||
}
|
}
|
||||||
if (!handler) throw new Error(`unexpected CDP call ${method}`);
|
if (!handler) throw new Error(`unexpected CDP call ${method}`);
|
||||||
return handler(params);
|
return handler(params);
|
||||||
@@ -2587,11 +2583,7 @@ describe("handleSnapshot", () => {
|
|||||||
if (method === "Accessibility.enable") return {};
|
if (method === "Accessibility.enable") return {};
|
||||||
if (method === "Accessibility.getFullAXTree") return { nodes };
|
if (method === "Accessibility.getFullAXTree") return { nodes };
|
||||||
if (method === "Page.getLayoutMetrics") {
|
if (method === "Page.getLayoutMetrics") {
|
||||||
return {
|
return { cssLayoutViewport: { clientWidth: 1000, clientHeight: 800, pageX: 0, pageY: 0 } };
|
||||||
visualViewport: { clientWidth: 1000 },
|
|
||||||
cssVisualViewport: { clientWidth: 1000 },
|
|
||||||
cssLayoutViewport: { clientWidth: 1000, clientHeight: 800, pageX: 0, pageY: 0 },
|
|
||||||
};
|
|
||||||
}
|
}
|
||||||
if (method === "DOMSnapshot.enable") return {};
|
if (method === "DOMSnapshot.enable") return {};
|
||||||
if (method === "DOMSnapshot.captureSnapshot") throw new Error("snapshot unsupported");
|
if (method === "DOMSnapshot.captureSnapshot") throw new Error("snapshot unsupported");
|
||||||
@@ -2678,11 +2670,7 @@ describe("handleSnapshot", () => {
|
|||||||
if (method === "Accessibility.enable") return {};
|
if (method === "Accessibility.enable") return {};
|
||||||
if (method === "Accessibility.getFullAXTree") return { nodes: [root, button] };
|
if (method === "Accessibility.getFullAXTree") return { nodes: [root, button] };
|
||||||
if (method === "Page.getLayoutMetrics") {
|
if (method === "Page.getLayoutMetrics") {
|
||||||
return {
|
return { cssLayoutViewport: { clientWidth: 1000, clientHeight: 800, pageX: 0, pageY: 0 } };
|
||||||
visualViewport: { clientWidth: 1000 },
|
|
||||||
cssVisualViewport: { clientWidth: 1000 },
|
|
||||||
cssLayoutViewport: { clientWidth: 1000, clientHeight: 800, pageX: 0, pageY: 0 },
|
|
||||||
};
|
|
||||||
}
|
}
|
||||||
if (method === "DOMSnapshot.enable") return {};
|
if (method === "DOMSnapshot.enable") return {};
|
||||||
if (method === "DOMSnapshot.captureSnapshot") {
|
if (method === "DOMSnapshot.captureSnapshot") {
|
||||||
@@ -2690,8 +2678,6 @@ describe("handleSnapshot", () => {
|
|||||||
strings,
|
strings,
|
||||||
documents: [
|
documents: [
|
||||||
{
|
{
|
||||||
scrollOffsetX: 0,
|
|
||||||
scrollOffsetY: 0,
|
|
||||||
frameId: "root",
|
frameId: "root",
|
||||||
nodes: {
|
nodes: {
|
||||||
parentIndex: [-1, 0],
|
parentIndex: [-1, 0],
|
||||||
@@ -2776,11 +2762,7 @@ describe("handleSnapshot", () => {
|
|||||||
if (method === "Accessibility.enable") return {};
|
if (method === "Accessibility.enable") return {};
|
||||||
if (method === "Accessibility.getFullAXTree") return { nodes: [root, button] };
|
if (method === "Accessibility.getFullAXTree") return { nodes: [root, button] };
|
||||||
if (method === "Page.getLayoutMetrics") {
|
if (method === "Page.getLayoutMetrics") {
|
||||||
return {
|
return { cssLayoutViewport: { clientWidth: 1000, clientHeight: 800, pageX: 0, pageY: 0 } };
|
||||||
visualViewport: { clientWidth: 1000 },
|
|
||||||
cssVisualViewport: { clientWidth: 1000 },
|
|
||||||
cssLayoutViewport: { clientWidth: 1000, clientHeight: 800, pageX: 0, pageY: 0 },
|
|
||||||
};
|
|
||||||
}
|
}
|
||||||
if (method === "DOMSnapshot.enable") return {};
|
if (method === "DOMSnapshot.enable") return {};
|
||||||
if (method === "DOMSnapshot.captureSnapshot") {
|
if (method === "DOMSnapshot.captureSnapshot") {
|
||||||
@@ -2788,8 +2770,6 @@ describe("handleSnapshot", () => {
|
|||||||
strings,
|
strings,
|
||||||
documents: [
|
documents: [
|
||||||
{
|
{
|
||||||
scrollOffsetX: 0,
|
|
||||||
scrollOffsetY: 0,
|
|
||||||
frameId: "root",
|
frameId: "root",
|
||||||
nodes: {
|
nodes: {
|
||||||
parentIndex: [-1, 0],
|
parentIndex: [-1, 0],
|
||||||
@@ -2877,11 +2857,7 @@ describe("handleSnapshot", () => {
|
|||||||
if (method === "Accessibility.enable") return {};
|
if (method === "Accessibility.enable") return {};
|
||||||
if (method === "Accessibility.getFullAXTree") return { nodes: [root, button] };
|
if (method === "Accessibility.getFullAXTree") return { nodes: [root, button] };
|
||||||
if (method === "Page.getLayoutMetrics") {
|
if (method === "Page.getLayoutMetrics") {
|
||||||
return {
|
return { cssLayoutViewport: { clientWidth: 1000, clientHeight: 800, pageX: 0, pageY: 0 } };
|
||||||
visualViewport: { clientWidth: 1000 },
|
|
||||||
cssVisualViewport: { clientWidth: 1000 },
|
|
||||||
cssLayoutViewport: { clientWidth: 1000, clientHeight: 800, pageX: 0, pageY: 0 },
|
|
||||||
};
|
|
||||||
}
|
}
|
||||||
if (method === "DOMSnapshot.enable") return {};
|
if (method === "DOMSnapshot.enable") return {};
|
||||||
if (method === "DOMSnapshot.captureSnapshot") {
|
if (method === "DOMSnapshot.captureSnapshot") {
|
||||||
@@ -2889,8 +2865,6 @@ describe("handleSnapshot", () => {
|
|||||||
strings,
|
strings,
|
||||||
documents: [
|
documents: [
|
||||||
{
|
{
|
||||||
scrollOffsetX: 0,
|
|
||||||
scrollOffsetY: 0,
|
|
||||||
frameId: "root",
|
frameId: "root",
|
||||||
nodes: {
|
nodes: {
|
||||||
parentIndex: [-1, 0],
|
parentIndex: [-1, 0],
|
||||||
@@ -3049,11 +3023,7 @@ describe("handleSnapshot", () => {
|
|||||||
};
|
};
|
||||||
}
|
}
|
||||||
if (method === "Page.getLayoutMetrics") {
|
if (method === "Page.getLayoutMetrics") {
|
||||||
return {
|
return { cssLayoutViewport: { clientWidth: 1000, clientHeight: 800 } };
|
||||||
visualViewport: { clientWidth: 1000 },
|
|
||||||
cssVisualViewport: { clientWidth: 1000 },
|
|
||||||
cssLayoutViewport: { clientWidth: 1000, clientHeight: 800 },
|
|
||||||
};
|
|
||||||
}
|
}
|
||||||
if (method === "DOMSnapshot.enable") return {};
|
if (method === "DOMSnapshot.enable") return {};
|
||||||
if (method === "DOMSnapshot.captureSnapshot") {
|
if (method === "DOMSnapshot.captureSnapshot") {
|
||||||
@@ -3160,8 +3130,6 @@ describe("handleSnapshot", () => {
|
|||||||
strings: S,
|
strings: S,
|
||||||
documents: [
|
documents: [
|
||||||
{
|
{
|
||||||
scrollOffsetX: 0,
|
|
||||||
scrollOffsetY: 0,
|
|
||||||
frameId: "root",
|
frameId: "root",
|
||||||
nodes: {
|
nodes: {
|
||||||
parentIndex: [-1, 0, 1, 2],
|
parentIndex: [-1, 0, 1, 2],
|
||||||
@@ -3220,8 +3188,6 @@ describe("handleSnapshot", () => {
|
|||||||
strings: S,
|
strings: S,
|
||||||
documents: [
|
documents: [
|
||||||
{
|
{
|
||||||
scrollOffsetX: 0,
|
|
||||||
scrollOffsetY: 0,
|
|
||||||
frameId: "root",
|
frameId: "root",
|
||||||
nodes: {
|
nodes: {
|
||||||
parentIndex: [-1, 0, 1, 1, 1, 1],
|
parentIndex: [-1, 0, 1, 1, 1, 1],
|
||||||
@@ -3272,8 +3238,6 @@ describe("handleSnapshot", () => {
|
|||||||
}
|
}
|
||||||
|
|
||||||
const VP_METRICS = {
|
const VP_METRICS = {
|
||||||
visualViewport: { clientWidth: 1000 },
|
|
||||||
cssVisualViewport: { clientWidth: 1000 },
|
|
||||||
cssLayoutViewport: { clientWidth: 1000, clientHeight: 800, pageX: 0, pageY: 0 },
|
cssLayoutViewport: { clientWidth: 1000, clientHeight: 800, pageX: 0, pageY: 0 },
|
||||||
};
|
};
|
||||||
|
|
||||||
@@ -3287,8 +3251,6 @@ describe("handleSnapshot", () => {
|
|||||||
strings,
|
strings,
|
||||||
documents: [
|
documents: [
|
||||||
{
|
{
|
||||||
scrollOffsetX: 0,
|
|
||||||
scrollOffsetY: 0,
|
|
||||||
frameId: "main",
|
frameId: "main",
|
||||||
nodes: {
|
nodes: {
|
||||||
parentIndex: [-1, 0, 1],
|
parentIndex: [-1, 0, 1],
|
||||||
@@ -3309,8 +3271,6 @@ describe("handleSnapshot", () => {
|
|||||||
},
|
},
|
||||||
},
|
},
|
||||||
{
|
{
|
||||||
scrollOffsetX: 0,
|
|
||||||
scrollOffsetY: 0,
|
|
||||||
frameId: "child",
|
frameId: "child",
|
||||||
nodes: {
|
nodes: {
|
||||||
parentIndex: [-1, 0, 1],
|
parentIndex: [-1, 0, 1],
|
||||||
@@ -3380,13 +3340,8 @@ describe("handleSnapshot", () => {
|
|||||||
throw new Error(`unexpected root CDP method ${method}`);
|
throw new Error(`unexpected root CDP method ${method}`);
|
||||||
});
|
});
|
||||||
const sendToTarget = vi.fn(async (_target, method: string) => {
|
const sendToTarget = vi.fn(async (_target, method: string) => {
|
||||||
if (method === "Runtime.evaluate") return { result: { value: { width: 400, height: 300 } } };
|
|
||||||
if (method === "Page.getLayoutMetrics" && ownerGeometry !== "unavailable")
|
if (method === "Page.getLayoutMetrics" && ownerGeometry !== "unavailable")
|
||||||
return {
|
return { cssLayoutViewport: { clientWidth: 400, clientHeight: 300 } };
|
||||||
visualViewport: { clientWidth: 1000 },
|
|
||||||
cssVisualViewport: { clientWidth: 1000 },
|
|
||||||
cssLayoutViewport: { clientWidth: 400, clientHeight: 300 },
|
|
||||||
};
|
|
||||||
if (method === "Accessibility.enable" || method === "DOMSnapshot.enable") return {};
|
if (method === "Accessibility.enable" || method === "DOMSnapshot.enable") return {};
|
||||||
if (method === "DOMSnapshot.captureSnapshot")
|
if (method === "DOMSnapshot.captureSnapshot")
|
||||||
return { ...snapshot, documents: [snapshot.documents[1]] };
|
return { ...snapshot, documents: [snapshot.documents[1]] };
|
||||||
@@ -3429,8 +3384,6 @@ describe("handleSnapshot", () => {
|
|||||||
strings: ["body", "a", "href", "//outside.test/docs", "https://page.test/start"],
|
strings: ["body", "a", "href", "//outside.test/docs", "https://page.test/start"],
|
||||||
documents: [
|
documents: [
|
||||||
{
|
{
|
||||||
scrollOffsetX: 0,
|
|
||||||
scrollOffsetY: 0,
|
|
||||||
frameId: "main",
|
frameId: "main",
|
||||||
...(hasSnapshotUrl ? { documentURL: 4 } : {}),
|
...(hasSnapshotUrl ? { documentURL: 4 } : {}),
|
||||||
nodes: {
|
nodes: {
|
||||||
@@ -3552,8 +3505,6 @@ describe("handleSnapshot", () => {
|
|||||||
strings,
|
strings,
|
||||||
documents: [
|
documents: [
|
||||||
{
|
{
|
||||||
scrollOffsetX: 0,
|
|
||||||
scrollOffsetY: 0,
|
|
||||||
frameId: "root",
|
frameId: "root",
|
||||||
nodes: {
|
nodes: {
|
||||||
parentIndex: [-1, 0, 1, 1, 3],
|
parentIndex: [-1, 0, 1, 1, 3],
|
||||||
@@ -3696,16 +3647,15 @@ describe("handleSnapshot", () => {
|
|||||||
const result = await captureVomObservation(makeFrameAwareDeps().cdp, 4, "https://example.com", {
|
const result = await captureVomObservation(makeFrameAwareDeps().cdp, 4, "https://example.com", {
|
||||||
maxTokens,
|
maxTokens,
|
||||||
});
|
});
|
||||||
expect(result.text.match(/@warning/g)).toHaveLength(2);
|
expect(result.text.match(/@warning/g)).toHaveLength(1);
|
||||||
expect(result.text).toContain("document identity unverified");
|
expect(result.text).toContain("iframe geometry incomplete");
|
||||||
expect(result.text).toContain("geometry incomplete");
|
|
||||||
expect(result.text.startsWith("@vom 1\n")).toBe(true);
|
expect(result.text.startsWith("@vom 1\n")).toBe(true);
|
||||||
if (maxTokens === undefined) {
|
if (maxTokens === undefined) {
|
||||||
expect(result.truncated).toBe(false);
|
expect(result.truncated).toBe(false);
|
||||||
expect(result.text).toContain("Frame action");
|
expect(result.text).toContain("Frame action");
|
||||||
expect(result.matchNodes.find((node) => node.backendNodeId === 22)).toMatchObject({
|
expect(result.matchNodes.find((node) => node.backendNodeId === 22)).toMatchObject({
|
||||||
rect: null,
|
rect: null,
|
||||||
localRect: null,
|
localRect: { x: 20, y: 30, w: 120, h: 40 },
|
||||||
});
|
});
|
||||||
}
|
}
|
||||||
if (maxTokens === 100) expect(Math.ceil(result.text.length / 4)).toBeLessThanOrEqual(maxTokens);
|
if (maxTokens === 100) expect(Math.ceil(result.text.length / 4)).toBeLessThanOrEqual(maxTokens);
|
||||||
@@ -3724,8 +3674,7 @@ describe("handleSnapshot", () => {
|
|||||||
for (const maxTokens of [undefined, 100, 0]) {
|
for (const maxTokens of [undefined, 100, 0]) {
|
||||||
const result = await captureVomObservation(cdp, 4, "https://example.com", { maxTokens });
|
const result = await captureVomObservation(cdp, 4, "https://example.com", { maxTokens });
|
||||||
expect(result.text).toContain(`@warning observation incomplete: some ${stage} data`);
|
expect(result.text).toContain(`@warning observation incomplete: some ${stage} data`);
|
||||||
expect(result.text.match(/@warning/g)).toHaveLength(2);
|
expect(result.text.match(/@warning/g)).toHaveLength(1);
|
||||||
expect(result.text).toContain("document identity unverified");
|
|
||||||
expect(result.text.startsWith("@vom 1\n")).toBe(true);
|
expect(result.text.startsWith("@vom 1\n")).toBe(true);
|
||||||
if (maxTokens === undefined) {
|
if (maxTokens === undefined) {
|
||||||
expect(result.frames.map((frame) => frame.frameId)).toEqual(["main", "child"]);
|
expect(result.frames.map((frame) => frame.frameId)).toEqual(["main", "child"]);
|
||||||
@@ -3773,8 +3722,7 @@ describe("handleSnapshot", () => {
|
|||||||
4,
|
4,
|
||||||
"https://example.com",
|
"https://example.com",
|
||||||
);
|
);
|
||||||
expect(result.text).not.toContain("iframe geometry incomplete");
|
expect(result.text).not.toContain("@warning");
|
||||||
expect(result.text).toContain("document identity unverified");
|
|
||||||
const node = result.matchNodes.find((item) => item.backendNodeId === 22);
|
const node = result.matchNodes.find((item) => item.backendNodeId === 22);
|
||||||
if (ownerGeometry === "clipped") expect(node?.rect).toBeNull();
|
if (ownerGeometry === "clipped") expect(node?.rect).toBeNull();
|
||||||
else expect(node?.rect).toEqual({ x: 120, y: 130, w: 120, h: 40 });
|
else expect(node?.rect).toEqual({ x: 120, y: 130, w: 120, h: 40 });
|
||||||
@@ -3796,7 +3744,7 @@ describe("handleSnapshot", () => {
|
|||||||
expect(result.matchNodes.find((node) => node.backendNodeId === 22)).toMatchObject({
|
expect(result.matchNodes.find((node) => node.backendNodeId === 22)).toMatchObject({
|
||||||
frameId: "child",
|
frameId: "child",
|
||||||
tag: "button",
|
tag: "button",
|
||||||
localRect: null,
|
localRect: { x: 20, y: 30, w: 120, h: 40 },
|
||||||
});
|
});
|
||||||
expect(result.refs.find((ref) => ref.backendNodeId === 22)).toMatchObject({
|
expect(result.refs.find((ref) => ref.backendNodeId === 22)).toMatchObject({
|
||||||
frameId: "child",
|
frameId: "child",
|
||||||
@@ -4140,8 +4088,6 @@ describe("handleSnapshot", () => {
|
|||||||
strings: S,
|
strings: S,
|
||||||
documents: [
|
documents: [
|
||||||
{
|
{
|
||||||
scrollOffsetX: 0,
|
|
||||||
scrollOffsetY: 0,
|
|
||||||
frameId: "root",
|
frameId: "root",
|
||||||
nodes: {
|
nodes: {
|
||||||
parentIndex: [-1, 0, 1, 0, 3, 4, 5],
|
parentIndex: [-1, 0, 1, 0, 3, 4, 5],
|
||||||
|
|||||||
@@ -1,348 +0,0 @@
|
|||||||
// @vitest-environment node
|
|
||||||
// Opt in with BSK_SCROLL_CHROME=/path/to/chrome. Uses an isolated browser/profile.
|
|
||||||
import { describe, expect, it } from "vitest";
|
|
||||||
import type { CdpFrame, CdpFrameGraph, CdpTarget } from "@/browser-driver/frame-graph";
|
|
||||||
import { SessionManager } from "@/session-manager/manager";
|
|
||||||
import type { ViewportRect } from "../geometry";
|
|
||||||
import { handleScrollTo } from "../scroll";
|
|
||||||
import type { CdpRunner } from "../shared";
|
|
||||||
|
|
||||||
type Send = <T = Record<string, unknown>>(
|
|
||||||
method: string,
|
|
||||||
params?: object,
|
|
||||||
sessionId?: string,
|
|
||||||
) => Promise<T>;
|
|
||||||
type Tree = { frame: { id: string; parentId?: string; name?: string }; childFrames?: Tree[] };
|
|
||||||
|
|
||||||
async function withBrowser(
|
|
||||||
run: (h: Awaited<ReturnType<typeof harness>>) => Promise<void>,
|
|
||||||
zoom = 1,
|
|
||||||
) {
|
|
||||||
const { withChrome } = await import(
|
|
||||||
new URL(
|
|
||||||
"../../../../../evals/browser/cases/regression/snapshot-coordinates/chrome.mjs",
|
|
||||||
import.meta.url,
|
|
||||||
).href
|
|
||||||
);
|
|
||||||
await withChrome(
|
|
||||||
{ executable: process.env.BSK_SCROLL_CHROME, deviceScale: 1, zoom },
|
|
||||||
async (send: Send) => run(await harness(send)),
|
|
||||||
);
|
|
||||||
}
|
|
||||||
|
|
||||||
async function harness(send: Send) {
|
|
||||||
const { targetId } = await send<{ targetId: string }>("Target.createTarget", {
|
|
||||||
url: "about:blank",
|
|
||||||
});
|
|
||||||
const { sessionId: rootSession } = await send<{ sessionId: string }>("Target.attachToTarget", {
|
|
||||||
targetId,
|
|
||||||
flatten: true,
|
|
||||||
});
|
|
||||||
await send("Page.bringToFront", {}, rootSession);
|
|
||||||
const manager = new SessionManager({
|
|
||||||
agentWindow: {
|
|
||||||
create: async () => 100,
|
|
||||||
remove: async () => {},
|
|
||||||
ensureActiveTab: async () => 4,
|
|
||||||
},
|
|
||||||
});
|
|
||||||
const ctx = await manager.start("aa11");
|
|
||||||
const calls: { method: string; sessionId?: string }[] = [];
|
|
||||||
const after = { command: (_method: string) => {} };
|
|
||||||
const sessionFor = (target: CdpTarget) => target.sessionId ?? rootSession;
|
|
||||||
const forward = async <T>(target: CdpTarget, method: string, params?: object): Promise<T> => {
|
|
||||||
calls.push({ method, sessionId: target.sessionId });
|
|
||||||
const result = await send<T>(method, params, sessionFor(target));
|
|
||||||
after.command(method);
|
|
||||||
return result;
|
|
||||||
};
|
|
||||||
const cdp: CdpRunner = {
|
|
||||||
send: (_tab, method, params) => forward({ tabId: 4 }, method, params),
|
|
||||||
sendToTarget: forward,
|
|
||||||
};
|
|
||||||
const evaluate = async <T>(expression: string, frame?: CdpFrame): Promise<T> => {
|
|
||||||
const session = frame ? sessionFor(frame.target) : rootSession;
|
|
||||||
const world = frame
|
|
||||||
? await send<{ executionContextId: number }>(
|
|
||||||
"Page.createIsolatedWorld",
|
|
||||||
{
|
|
||||||
frameId: frame.frameId,
|
|
||||||
worldName: "scroll-oracle",
|
|
||||||
},
|
|
||||||
session,
|
|
||||||
)
|
|
||||||
: undefined;
|
|
||||||
const reply = await send<{ result: { value: T }; exceptionDetails?: unknown }>(
|
|
||||||
"Runtime.evaluate",
|
|
||||||
{
|
|
||||||
expression,
|
|
||||||
contextId: world?.executionContextId,
|
|
||||||
returnByValue: true,
|
|
||||||
awaitPromise: true,
|
|
||||||
},
|
|
||||||
session,
|
|
||||||
);
|
|
||||||
expect(reply.exceptionDetails).toBeUndefined();
|
|
||||||
return reply.result.value;
|
|
||||||
};
|
|
||||||
const rememberRef = (frame: CdpFrame, backendNodeId: number) =>
|
|
||||||
ctx.refStore.set("e1", backendNodeId, {
|
|
||||||
tabId: 4,
|
|
||||||
frameId: frame.frameId,
|
|
||||||
cdpSessionId: frame.target.sessionId,
|
|
||||||
});
|
|
||||||
const ref = async (frame: CdpFrame, selector = "#probe") => {
|
|
||||||
const { executionContextId } = await send<{ executionContextId: number }>(
|
|
||||||
"Page.createIsolatedWorld",
|
|
||||||
{
|
|
||||||
frameId: frame.frameId,
|
|
||||||
worldName: "scroll-oracle",
|
|
||||||
},
|
|
||||||
sessionFor(frame.target),
|
|
||||||
);
|
|
||||||
const { result } = await send<{ result: { objectId: string } }>(
|
|
||||||
"Runtime.evaluate",
|
|
||||||
{
|
|
||||||
expression: `document.querySelector(${JSON.stringify(selector)})`,
|
|
||||||
contextId: executionContextId,
|
|
||||||
},
|
|
||||||
sessionFor(frame.target),
|
|
||||||
);
|
|
||||||
const { node } = await send<{ node: { backendNodeId: number } }>(
|
|
||||||
"DOM.describeNode",
|
|
||||||
{ objectId: result.objectId },
|
|
||||||
sessionFor(frame.target),
|
|
||||||
);
|
|
||||||
await send("Runtime.releaseObject", { objectId: result.objectId }, sessionFor(frame.target));
|
|
||||||
rememberRef(frame, node.backendNodeId);
|
|
||||||
};
|
|
||||||
const scroll = (target: { selector: string } | { ref: string }, signal?: AbortSignal) =>
|
|
||||||
handleScrollTo(
|
|
||||||
manager,
|
|
||||||
{ session_id: "aa11", ...target },
|
|
||||||
{
|
|
||||||
cdp,
|
|
||||||
signal,
|
|
||||||
tabsApi: {
|
|
||||||
get: async (id) => ({ id, windowId: 100, active: true }) as chrome.tabs.Tab,
|
|
||||||
query: async () => [{ id: 4, windowId: 100, active: true } as chrome.tabs.Tab],
|
|
||||||
},
|
|
||||||
},
|
|
||||||
);
|
|
||||||
const loadFrames = async () => {
|
|
||||||
const { targetInfos } = await send<{ targetInfos: { targetId: string; type: string }[] }>(
|
|
||||||
"Target.getTargets",
|
|
||||||
);
|
|
||||||
const sessions = [rootSession];
|
|
||||||
for (const target of targetInfos.filter((t) => t.type === "iframe")) {
|
|
||||||
const { sessionId } = await send<{ sessionId: string }>("Target.attachToTarget", {
|
|
||||||
targetId: target.targetId,
|
|
||||||
flatten: true,
|
|
||||||
});
|
|
||||||
sessions.push(sessionId);
|
|
||||||
}
|
|
||||||
const frames: (CdpFrame & { name: string })[] = [];
|
|
||||||
for (const session of sessions) {
|
|
||||||
const { frameTree } = await send<{ frameTree: Tree }>("Page.getFrameTree", {}, session);
|
|
||||||
const target = { tabId: 4, ...(session !== rootSession ? { sessionId: session } : {}) };
|
|
||||||
const visit = (tree: Tree, parentFrameId = tree.frame.parentId) => {
|
|
||||||
frames.push({ frameId: tree.frame.id, parentFrameId, target, name: tree.frame.name ?? "" });
|
|
||||||
for (const child of tree.childFrames ?? []) visit(child, tree.frame.id);
|
|
||||||
};
|
|
||||||
visit(frameTree);
|
|
||||||
}
|
|
||||||
for (const frame of frames) {
|
|
||||||
if (!frame.parentFrameId) continue;
|
|
||||||
const parent = frames.find((f) => f.frameId === frame.parentFrameId)!;
|
|
||||||
const owner = await send<{ backendNodeId: number }>(
|
|
||||||
"DOM.getFrameOwner",
|
|
||||||
{ frameId: frame.frameId },
|
|
||||||
sessionFor(parent.target),
|
|
||||||
);
|
|
||||||
frame.ownerBackendNodeId = owner.backendNodeId;
|
|
||||||
}
|
|
||||||
const graph: CdpFrameGraph = { rootFrameId: frames[0].frameId, frames };
|
|
||||||
cdp.getFrameGraph = async () => graph;
|
|
||||||
return frames;
|
|
||||||
};
|
|
||||||
return { send, rootSession, evaluate, ref, rememberRef, scroll, loadFrames, calls, after };
|
|
||||||
}
|
|
||||||
|
|
||||||
function intersection(a: ViewportRect, b: ViewportRect): ViewportRect | null {
|
|
||||||
const x = Math.max(a.x, b.x),
|
|
||||||
y = Math.max(a.y, b.y);
|
|
||||||
const right = Math.min(a.x + a.width, b.x + b.width),
|
|
||||||
bottom = Math.min(a.y + a.height, b.y + b.height);
|
|
||||||
return right > x && bottom > y ? { x, y, width: right - x, height: bottom - y } : null;
|
|
||||||
}
|
|
||||||
|
|
||||||
function expectRect(actual: unknown, expected: ViewportRect) {
|
|
||||||
expect(actual).not.toHaveProperty("code");
|
|
||||||
for (const key of ["x", "y", "width", "height"] as const)
|
|
||||||
expect(Math.abs((actual as ViewportRect)[key] - expected[key]), key).toBeLessThan(2);
|
|
||||||
}
|
|
||||||
|
|
||||||
describe.skipIf(!process.env.BSK_SCROLL_CHROME)("real browser scroll-to", () => {
|
|
||||||
it("scrolls ordinary elements and reports the clipped portion of nested scrollers", async () => {
|
|
||||||
await withBrowser(async (h) => {
|
|
||||||
for (const html of [
|
|
||||||
'<div style="height:2200px"></div><div id="target" style="width:100px;height:40px"></div>',
|
|
||||||
'<div style="height:200px"></div><div id="clip" style="height:80px;width:200px;overflow:auto"><div id="target" style="width:100px;height:400px"></div></div>',
|
|
||||||
'<div style="height:200px"></div><div id="clip" style="height:80px;width:200px;overflow:auto;transform:scale(1.25);transform-origin:0 0"><div id="target" style="width:100px;height:400px"></div></div>',
|
|
||||||
]) {
|
|
||||||
await h.evaluate(`document.body.innerHTML = ${JSON.stringify(html)}`);
|
|
||||||
const result = await h.scroll({ selector: "#target" });
|
|
||||||
const oracle = await h.evaluate<{ rect: ViewportRect; clip?: ViewportRect }>(`({
|
|
||||||
rect: document.querySelector('#target').getBoundingClientRect().toJSON(),
|
|
||||||
clip: document.querySelector('#clip')?.getBoundingClientRect().toJSON()
|
|
||||||
})`);
|
|
||||||
expectRect(result, oracle.clip ? intersection(oracle.rect, oracle.clip)! : oracle.rect);
|
|
||||||
}
|
|
||||||
});
|
|
||||||
});
|
|
||||||
|
|
||||||
it.each([
|
|
||||||
"visibility:hidden",
|
|
||||||
"opacity:0",
|
|
||||||
"display:none",
|
|
||||||
"content-visibility:hidden",
|
|
||||||
])("rejects %s targets", async (style) => {
|
|
||||||
await withBrowser(async (h) => {
|
|
||||||
await h.evaluate(
|
|
||||||
`document.body.innerHTML = '<div style="${style}"><button id="target">Target</button></div>'`,
|
|
||||||
);
|
|
||||||
expect(await h.scroll({ selector: "#target" })).toMatchObject({
|
|
||||||
code: "permission_denied",
|
|
||||||
data: { reason: "element_not_visible" },
|
|
||||||
});
|
|
||||||
});
|
|
||||||
});
|
|
||||||
|
|
||||||
it("rejects targets fully outside an overflow:clip ancestor", async () => {
|
|
||||||
await withBrowser(async (h) => {
|
|
||||||
await h.evaluate(
|
|
||||||
`document.body.innerHTML = '<div style="height:80px;overflow:clip"><div style="height:150px"></div><button id="target">Target</button></div>'`,
|
|
||||||
);
|
|
||||||
expect(await h.scroll({ selector: "#target" })).toMatchObject({ code: "permission_denied" });
|
|
||||||
});
|
|
||||||
});
|
|
||||||
|
|
||||||
it.each(["open", "closed"])("clips %s shadow-root refs", async (mode) => {
|
|
||||||
await withBrowser(async (h) => {
|
|
||||||
await h.evaluate(`(() => {
|
|
||||||
const host = document.createElement('div'); document.body.append(host);
|
|
||||||
const root = host.attachShadow({mode:'${mode}'});
|
|
||||||
root.innerHTML = '<div style="height:60px;overflow:auto"><button id="probe" style="height:200px;width:100px">Target</button></div>';
|
|
||||||
window.probe = root.querySelector('#probe');
|
|
||||||
})()`);
|
|
||||||
const frames = await h.loadFrames();
|
|
||||||
const { result } = await h.send<{ result: { objectId: string } }>(
|
|
||||||
"Runtime.evaluate",
|
|
||||||
{ expression: "window.probe" },
|
|
||||||
h.rootSession,
|
|
||||||
);
|
|
||||||
// Build the ref from the actual closed-root node, as an observation does.
|
|
||||||
const { node } = await h.send<{ node: { backendNodeId: number } }>(
|
|
||||||
"DOM.describeNode",
|
|
||||||
{ objectId: result.objectId },
|
|
||||||
h.rootSession,
|
|
||||||
);
|
|
||||||
await h.send("Runtime.releaseObject", { objectId: result.objectId }, h.rootSession);
|
|
||||||
h.rememberRef(frames[0], node.backendNodeId);
|
|
||||||
expect(await h.scroll({ ref: "e1" })).toMatchObject({ height: 60 });
|
|
||||||
});
|
|
||||||
});
|
|
||||||
|
|
||||||
it("cancels after scrolling and releases the measurement object without follow-up reads", async () => {
|
|
||||||
await withBrowser(async (h) => {
|
|
||||||
await h.evaluate("document.body.innerHTML = '<button id=target>Target</button>'");
|
|
||||||
const abort = new AbortController();
|
|
||||||
h.after.command = (method) => {
|
|
||||||
if (method === "DOM.resolveNode") abort.abort();
|
|
||||||
};
|
|
||||||
expect(await h.scroll({ selector: "#target" }, abort.signal)).toMatchObject({
|
|
||||||
code: "cancelled",
|
|
||||||
});
|
|
||||||
expect(h.calls.at(-1)!.method).toBe("Runtime.releaseObjectGroup");
|
|
||||||
expect(h.calls.some((call) => call.method === "Runtime.callFunctionOn")).toBe(false);
|
|
||||||
});
|
|
||||||
});
|
|
||||||
|
|
||||||
it.each([
|
|
||||||
{ fixture: "snapshot-coordinates", zoom: 1 },
|
|
||||||
{ fixture: "snapshot-coordinates", zoom: 1.25 },
|
|
||||||
{ fixture: "oopif-scrollbars", zoom: 1 },
|
|
||||||
{ fixture: "oopif-scrollbars", zoom: 0.8 },
|
|
||||||
])("scrolls nested frames: $fixture at zoom $zoom", async ({ fixture, zoom }) => {
|
|
||||||
const { createEvalServer } = await import(
|
|
||||||
new URL("../../../../../evals/browser/lib/server.mjs", import.meta.url).href
|
|
||||||
);
|
|
||||||
const server = createEvalServer();
|
|
||||||
const { baseUrl } = await server.start();
|
|
||||||
try {
|
|
||||||
await withBrowser(async (h) => {
|
|
||||||
await h.send("Page.navigate", { url: `${baseUrl}/${fixture}?run=scroll` }, h.rootSession);
|
|
||||||
await expect
|
|
||||||
.poll(
|
|
||||||
() =>
|
|
||||||
server
|
|
||||||
.snapshot("scroll")
|
|
||||||
.events.some(
|
|
||||||
(e: { type: string; data: { root?: boolean } }) =>
|
|
||||||
e.type === "geometry.ready" && e.data.root,
|
|
||||||
),
|
|
||||||
{ timeout: 10_000 },
|
|
||||||
)
|
|
||||||
.toBe(true);
|
|
||||||
const frames = await h.loadFrames();
|
|
||||||
expect(frames.length).toBe(fixture === "snapshot-coordinates" ? 5 : 3);
|
|
||||||
for (const frame of frames) {
|
|
||||||
await h.ref(frame);
|
|
||||||
const result = await h.scroll({ ref: "e1" });
|
|
||||||
// Independent DOM oracle: CSS border boxes plus this fixture's known
|
|
||||||
// axis-aligned iframe scales. Re-read after each scroll changes layout.
|
|
||||||
let rect = await h.evaluate<ViewportRect>(
|
|
||||||
"document.querySelector('#probe').getBoundingClientRect().toJSON()",
|
|
||||||
frame,
|
|
||||||
);
|
|
||||||
let current = frame;
|
|
||||||
while (true) {
|
|
||||||
const viewport = await h.evaluate<ViewportRect>(
|
|
||||||
"({ x:0, y:0, width:document.documentElement.clientWidth, height:document.documentElement.clientHeight })",
|
|
||||||
current,
|
|
||||||
);
|
|
||||||
rect = intersection(rect, viewport)!;
|
|
||||||
if (!current.parentFrameId) break;
|
|
||||||
const parent = frames.find((f) => f.frameId === current.parentFrameId)!;
|
|
||||||
const owner = await h.evaluate<{ x: number; y: number; scale: number }>(
|
|
||||||
`(() => {
|
|
||||||
const iframe = document.querySelector('iframe[name="${current.name}"]');
|
|
||||||
const r = iframe.getBoundingClientRect(); const s = getComputedStyle(iframe);
|
|
||||||
const scale = r.width / iframe.offsetWidth;
|
|
||||||
return { x:r.x + (iframe.clientLeft + parseFloat(s.paddingLeft))*scale,
|
|
||||||
y:r.y + (iframe.clientTop + parseFloat(s.paddingTop))*scale, scale };
|
|
||||||
})()`,
|
|
||||||
parent,
|
|
||||||
);
|
|
||||||
rect = {
|
|
||||||
x: owner.x + rect.x * owner.scale,
|
|
||||||
y: owner.y + rect.y * owner.scale,
|
|
||||||
width: rect.width * owner.scale,
|
|
||||||
height: rect.height * owner.scale,
|
|
||||||
};
|
|
||||||
current = parent;
|
|
||||||
}
|
|
||||||
expectRect(result, rect);
|
|
||||||
}
|
|
||||||
const child = frames.find((frame) => frame.parentFrameId === frames[0].frameId)!;
|
|
||||||
await h.ref(child);
|
|
||||||
await h.evaluate(
|
|
||||||
`document.querySelector('iframe[name="${child.name}"]').style.opacity = '0'`,
|
|
||||||
);
|
|
||||||
expect(await h.scroll({ ref: "e1" })).toMatchObject({ code: "permission_denied" });
|
|
||||||
}, zoom);
|
|
||||||
} finally {
|
|
||||||
await server.stop();
|
|
||||||
}
|
|
||||||
}, 30_000);
|
|
||||||
});
|
|
||||||
@@ -1,310 +0,0 @@
|
|||||||
import { afterEach, describe, expect, it, vi } from "vitest";
|
|
||||||
import type { CdpFrameGraph, CdpTarget } from "@/browser-driver/frame-graph";
|
|
||||||
import { SessionManager } from "@/session-manager/manager";
|
|
||||||
import type { JavaScriptDialogInfo, ScrollToParams } from "@/transport/types";
|
|
||||||
import type { ViewportRect } from "../geometry";
|
|
||||||
import { handleScrollTo } from "../scroll";
|
|
||||||
import type { CdpRunner } from "../shared";
|
|
||||||
|
|
||||||
interface Call {
|
|
||||||
target: CdpTarget;
|
|
||||||
method: string;
|
|
||||||
params?: Record<string, unknown>;
|
|
||||||
aborted: boolean;
|
|
||||||
}
|
|
||||||
|
|
||||||
async function fixture(frame: "top" | "same-target" | "oopif" = "top") {
|
|
||||||
const manager = new SessionManager({
|
|
||||||
agentWindow: {
|
|
||||||
create: async () => 100,
|
|
||||||
remove: async () => {},
|
|
||||||
ensureActiveTab: async () => 4,
|
|
||||||
},
|
|
||||||
});
|
|
||||||
const ctx = await manager.start("aa11");
|
|
||||||
ctx.refStore.set("e3", 1234, {
|
|
||||||
tabId: 4,
|
|
||||||
...(frame !== "top" ? { frameId: "child" } : {}),
|
|
||||||
...(frame === "oopif" ? { cdpSessionId: "child-session" } : {}),
|
|
||||||
});
|
|
||||||
const abort = new AbortController();
|
|
||||||
const graph: CdpFrameGraph = {
|
|
||||||
rootFrameId: "main",
|
|
||||||
frames: [
|
|
||||||
{ frameId: "main", target: { tabId: 4 } },
|
|
||||||
{
|
|
||||||
frameId: "child",
|
|
||||||
parentFrameId: "main",
|
|
||||||
ownerBackendNodeId: 99,
|
|
||||||
target: { tabId: 4, ...(frame === "oopif" ? { sessionId: "child-session" } : {}) },
|
|
||||||
},
|
|
||||||
],
|
|
||||||
};
|
|
||||||
const rectangles = new Map<number, ViewportRect | null>([
|
|
||||||
[1234, { x: 10, y: 20, width: 100, height: 40 }],
|
|
||||||
[99, { x: 204, y: 306, width: 400, height: 200 }],
|
|
||||||
]);
|
|
||||||
const calls: Call[] = [];
|
|
||||||
const hooks = {
|
|
||||||
after: (_call: Call) => {},
|
|
||||||
reply: (_call: Call): object | undefined => undefined,
|
|
||||||
};
|
|
||||||
const send = async <T>(target: CdpTarget, method: string, params?: object): Promise<T> => {
|
|
||||||
const call = {
|
|
||||||
target,
|
|
||||||
method,
|
|
||||||
params: params as Call["params"],
|
|
||||||
aborted: abort.signal.aborted,
|
|
||||||
};
|
|
||||||
calls.push(call);
|
|
||||||
const override = hooks.reply(call);
|
|
||||||
hooks.after(call);
|
|
||||||
if (override) return override as T;
|
|
||||||
const args = call.params ?? {};
|
|
||||||
const replies: Record<string, unknown> = {
|
|
||||||
"DOM.getDocument": { root: { nodeId: 1 } },
|
|
||||||
"DOM.querySelector": { nodeId: 2 },
|
|
||||||
"DOM.describeNode": { node: { backendNodeId: 1234 } },
|
|
||||||
"DOM.scrollIntoViewIfNeeded": {},
|
|
||||||
"DOM.resolveNode": { object: { objectId: String(args.backendNodeId) } },
|
|
||||||
"Runtime.callFunctionOn": {
|
|
||||||
result: {
|
|
||||||
value: String(args.functionDeclaration).includes("IntersectionObserver")
|
|
||||||
? rectangles.get(Number(args.objectId))
|
|
||||||
: { width: 200, height: 100 },
|
|
||||||
},
|
|
||||||
},
|
|
||||||
"Runtime.releaseObject": {},
|
|
||||||
"Runtime.releaseObjectGroup": {},
|
|
||||||
"Runtime.evaluate": { result: { value: { width: 200, height: 100 } } },
|
|
||||||
"Page.getLayoutMetrics": {
|
|
||||||
cssLayoutViewport: {
|
|
||||||
clientWidth: target.sessionId ? 185 : 1280,
|
|
||||||
clientHeight: target.sessionId ? 89 : 720,
|
|
||||||
},
|
|
||||||
},
|
|
||||||
"DOM.getBoxModel": { model: { content: [204, 306, 604, 306, 604, 506, 204, 506] } },
|
|
||||||
};
|
|
||||||
if (!(method in replies)) throw new Error(`unexpected CDP call ${method}`);
|
|
||||||
return replies[method] as T;
|
|
||||||
};
|
|
||||||
const cdp: CdpRunner = {
|
|
||||||
send: (tabId, method, params) => send({ tabId }, method, params),
|
|
||||||
sendToTarget: send,
|
|
||||||
getFrameGraph: vi.fn(async () => {
|
|
||||||
hooks.after({ target: { tabId: 4 }, method: "getFrameGraph", aborted: abort.signal.aborted });
|
|
||||||
return graph;
|
|
||||||
}),
|
|
||||||
trackSessionTab: vi.fn(),
|
|
||||||
};
|
|
||||||
const tabsApi = {
|
|
||||||
get: vi.fn(async (id: number) => ({ id, windowId: 100, active: true }) as chrome.tabs.Tab),
|
|
||||||
query: vi.fn(async () => [{ id: 4, windowId: 100, active: true } as chrome.tabs.Tab]),
|
|
||||||
};
|
|
||||||
const run = (params: Partial<ScrollToParams> = {}) =>
|
|
||||||
handleScrollTo(
|
|
||||||
manager,
|
|
||||||
{ session_id: "aa11", ref: "@e3", ...params },
|
|
||||||
{ cdp, tabsApi, signal: abort.signal },
|
|
||||||
);
|
|
||||||
return { ctx, cdp, graph, rectangles, calls, hooks, abort, tabsApi, run };
|
|
||||||
}
|
|
||||||
|
|
||||||
afterEach(() => vi.restoreAllMocks());
|
|
||||||
|
|
||||||
describe("handleScrollTo", () => {
|
|
||||||
it("scrolls a ref and returns renderer-clipped bounds", async () => {
|
|
||||||
const f = await fixture();
|
|
||||||
expect(await f.run()).toMatchObject({
|
|
||||||
tab_id: 4,
|
|
||||||
used_ref: "e3",
|
|
||||||
x: 10,
|
|
||||||
y: 20,
|
|
||||||
width: 100,
|
|
||||||
height: 40,
|
|
||||||
});
|
|
||||||
expect(f.calls[0]).toMatchObject({
|
|
||||||
method: "DOM.scrollIntoViewIfNeeded",
|
|
||||||
params: { backendNodeId: 1234 },
|
|
||||||
});
|
|
||||||
const group = f.calls.find((call) => call.method === "DOM.resolveNode")!.params!.objectGroup;
|
|
||||||
expect(f.calls.at(-1)).toMatchObject({
|
|
||||||
method: "Runtime.releaseObjectGroup",
|
|
||||||
params: { objectGroup: group },
|
|
||||||
});
|
|
||||||
});
|
|
||||||
|
|
||||||
it("resolves a selector and tracks the attached tab even when it is missing", async () => {
|
|
||||||
const f = await fixture();
|
|
||||||
expect(await f.run({ ref: undefined, selector: "#target" })).toMatchObject({
|
|
||||||
used_selector: "#target",
|
|
||||||
});
|
|
||||||
f.hooks.reply = ({ method }) => (method === "DOM.querySelector" ? { nodeId: 0 } : undefined);
|
|
||||||
expect(await f.run({ ref: undefined, selector: "#missing" })).toMatchObject({
|
|
||||||
code: "not_found",
|
|
||||||
data: { reason: "selector_not_found" },
|
|
||||||
});
|
|
||||||
expect(f.cdp.trackSessionTab).toHaveBeenCalledWith("aa11", 4);
|
|
||||||
});
|
|
||||||
|
|
||||||
it.each([
|
|
||||||
"same-target",
|
|
||||||
"oopif",
|
|
||||||
] as const)("projects %s refs and scrolls their owners", async (frame) => {
|
|
||||||
const f = await fixture(frame);
|
|
||||||
expect(await f.run()).toMatchObject({ x: 224, y: 346, width: 200, height: 80 });
|
|
||||||
expect(
|
|
||||||
f.calls
|
|
||||||
.filter((call) => call.method === "DOM.scrollIntoViewIfNeeded")
|
|
||||||
.map((call) => call.params!.backendNodeId),
|
|
||||||
).toEqual([99, 1234]);
|
|
||||||
expect(f.cdp.getFrameGraph).toHaveBeenCalledTimes(1);
|
|
||||||
if (frame === "oopif")
|
|
||||||
expect(f.calls.find((call) => call.params?.backendNodeId === 1234)!.target.sessionId).toBe(
|
|
||||||
"child-session",
|
|
||||||
);
|
|
||||||
});
|
|
||||||
|
|
||||||
it("clips OOPIF bounds to occupied scrollbars without changing the frame scale", async () => {
|
|
||||||
const f = await fixture("oopif");
|
|
||||||
f.rectangles.set(1234, { x: 180, y: 80, width: 5, height: 9 });
|
|
||||||
expect(await f.run()).toMatchObject({ x: 564, y: 466, width: 10, height: 18 });
|
|
||||||
});
|
|
||||||
|
|
||||||
it("clips against the iframe owner's ordinary DOM ancestors", async () => {
|
|
||||||
const f = await fixture("oopif");
|
|
||||||
f.rectangles.set(99, { x: 204, y: 306, width: 400, height: 80 });
|
|
||||||
expect(await f.run()).toMatchObject({ x: 224, y: 346, width: 200, height: 40 });
|
|
||||||
});
|
|
||||||
|
|
||||||
it.each([1234, 99])("rejects a hidden or fully clipped node %i", async (node) => {
|
|
||||||
const f = await fixture("oopif");
|
|
||||||
f.rectangles.set(node, null);
|
|
||||||
expect(await f.run()).toMatchObject({
|
|
||||||
code: "permission_denied",
|
|
||||||
data: { reason: "element_not_visible" },
|
|
||||||
});
|
|
||||||
expect(f.calls.at(-1)!.method).toBe("Runtime.releaseObjectGroup");
|
|
||||||
});
|
|
||||||
|
|
||||||
it.each([
|
|
||||||
{ ref: undefined },
|
|
||||||
{ selector: "#target" },
|
|
||||||
{ timeout_ms: 0 },
|
|
||||||
])("rejects invalid params %j", async (params) => {
|
|
||||||
const f = await fixture();
|
|
||||||
expect(await f.run(params)).toMatchObject({ code: "invalid_params" });
|
|
||||||
expect(f.calls).toEqual([]);
|
|
||||||
});
|
|
||||||
|
|
||||||
it.each(["stale", "other-tab"])("rejects %s refs before scrolling", async (mode) => {
|
|
||||||
const f = await fixture();
|
|
||||||
if (mode === "stale") f.ctx.refStore.clear();
|
|
||||||
else f.ctx.refStore.set("e3", 1234, { tabId: 8 });
|
|
||||||
expect(await f.run()).toMatchObject({ code: "not_found", data: { reason: "ref_not_found" } });
|
|
||||||
expect(f.calls).toEqual([]);
|
|
||||||
});
|
|
||||||
|
|
||||||
it("enforces the Agent Window boundary", async () => {
|
|
||||||
const f = await fixture();
|
|
||||||
f.tabsApi.query.mockResolvedValue([{ id: 4, windowId: 200, active: true } as chrome.tabs.Tab]);
|
|
||||||
f.tabsApi.get.mockResolvedValue({ id: 4, windowId: 200, active: true } as chrome.tabs.Tab);
|
|
||||||
expect(await f.run({ tab_id: 4 })).toMatchObject({ code: "permission_denied" });
|
|
||||||
expect(f.calls).toEqual([]);
|
|
||||||
});
|
|
||||||
|
|
||||||
it.each([
|
|
||||||
"getFrameGraph",
|
|
||||||
"DOM.scrollIntoViewIfNeeded",
|
|
||||||
"DOM.resolveNode",
|
|
||||||
"Runtime.callFunctionOn",
|
|
||||||
"Page.getLayoutMetrics",
|
|
||||||
"Runtime.evaluate",
|
|
||||||
"DOM.getBoxModel",
|
|
||||||
])("honors cancellation during %s and only cleans up afterwards", async (method) => {
|
|
||||||
const f = await fixture("oopif");
|
|
||||||
f.hooks.after = (call) => {
|
|
||||||
if (call.method === method) f.abort.abort();
|
|
||||||
};
|
|
||||||
expect(await f.run()).toMatchObject({ code: "cancelled" });
|
|
||||||
expect(
|
|
||||||
f.calls.filter((call) => call.aborted && call.method !== "Runtime.releaseObjectGroup"),
|
|
||||||
).toEqual([]);
|
|
||||||
});
|
|
||||||
|
|
||||||
it.each([
|
|
||||||
"DOM.getDocument",
|
|
||||||
"DOM.querySelector",
|
|
||||||
"DOM.describeNode",
|
|
||||||
])("cancels selector resolution during %s", async (method) => {
|
|
||||||
const f = await fixture();
|
|
||||||
f.hooks.after = (call) => {
|
|
||||||
if (call.method === method) f.abort.abort();
|
|
||||||
};
|
|
||||||
expect(await f.run({ ref: undefined, selector: "#target" })).toMatchObject({
|
|
||||||
code: "cancelled",
|
|
||||||
});
|
|
||||||
expect(f.calls.filter((call) => call.aborted)).toEqual([]);
|
|
||||||
});
|
|
||||||
|
|
||||||
it("does not start after early cancellation", async () => {
|
|
||||||
const f = await fixture();
|
|
||||||
f.abort.abort();
|
|
||||||
expect(await f.run()).toMatchObject({ code: "cancelled" });
|
|
||||||
expect(f.calls).toEqual([]);
|
|
||||||
expect(f.tabsApi.query).not.toHaveBeenCalled();
|
|
||||||
});
|
|
||||||
|
|
||||||
it("does not issue fallback scrolling after cancellation", async () => {
|
|
||||||
const f = await fixture();
|
|
||||||
f.hooks.reply = ({ method }) => {
|
|
||||||
if (method === "DOM.scrollIntoViewIfNeeded") {
|
|
||||||
f.abort.abort();
|
|
||||||
throw new Error("scroll failed");
|
|
||||||
}
|
|
||||||
return undefined;
|
|
||||||
};
|
|
||||||
expect(await f.run()).toMatchObject({ code: "cancelled" });
|
|
||||||
expect(f.calls.map((call) => call.method)).toEqual(["DOM.scrollIntoViewIfNeeded"]);
|
|
||||||
});
|
|
||||||
|
|
||||||
it("stops target scrolling after a deadline expires while scrolling its owner", async () => {
|
|
||||||
const f = await fixture("oopif");
|
|
||||||
const now = vi.spyOn(Date, "now").mockReturnValue(100);
|
|
||||||
f.hooks.after = ({ method }) => {
|
|
||||||
if (method === "DOM.scrollIntoViewIfNeeded") now.mockReturnValue(201);
|
|
||||||
};
|
|
||||||
expect(await f.run({ timeout_ms: 100 })).toMatchObject({ code: "timeout" });
|
|
||||||
expect(f.calls.filter((call) => call.method === "DOM.scrollIntoViewIfNeeded")).toHaveLength(1);
|
|
||||||
});
|
|
||||||
|
|
||||||
it("reports measurement exceptions and releases objects even if cleanup fails", async () => {
|
|
||||||
const f = await fixture();
|
|
||||||
f.hooks.reply = ({ method }) => {
|
|
||||||
if (method === "Runtime.callFunctionOn")
|
|
||||||
return { exceptionDetails: { text: "measurement failed" } };
|
|
||||||
if (method === "Runtime.releaseObjectGroup") throw new Error("target closed");
|
|
||||||
return undefined;
|
|
||||||
};
|
|
||||||
expect(await f.run()).toMatchObject({ code: "cdp_failed", message: "measurement failed" });
|
|
||||||
expect(f.calls.at(-1)!.method).toBe("Runtime.releaseObjectGroup");
|
|
||||||
});
|
|
||||||
|
|
||||||
it("attaches dialogs observed during scrolling", async () => {
|
|
||||||
const f = await fixture();
|
|
||||||
f.cdp.dialogCursor = () => 5;
|
|
||||||
const dialogs: JavaScriptDialogInfo[] = [
|
|
||||||
{
|
|
||||||
sequence: 6,
|
|
||||||
tab_id: 4,
|
|
||||||
type: "alert",
|
|
||||||
message: "scrolled",
|
|
||||||
handled: "accepted",
|
|
||||||
url: "https://example.test",
|
|
||||||
},
|
|
||||||
];
|
|
||||||
f.cdp.dialogsSince = vi.fn(() => dialogs);
|
|
||||||
expect(await f.run()).toHaveProperty("dialogs", dialogs);
|
|
||||||
expect(f.cdp.dialogsSince).toHaveBeenCalledWith(4, 5);
|
|
||||||
});
|
|
||||||
});
|
|
||||||
@@ -1,355 +0,0 @@
|
|||||||
// @vitest-environment node
|
|
||||||
import { describe, expect, it } from "vitest";
|
|
||||||
import type { CdpFrame, CdpFrameGraph, CdpTarget } from "@/browser-driver/frame-graph";
|
|
||||||
import { resolveNodeGeometry } from "../frame-geometry";
|
|
||||||
import type { CdpRunner } from "../shared";
|
|
||||||
import { captureObservationFacts } from "../vom/capture-coordinator";
|
|
||||||
|
|
||||||
type Send = <T = Record<string, unknown>>(
|
|
||||||
method: string,
|
|
||||||
params?: object,
|
|
||||||
sessionId?: string,
|
|
||||||
) => Promise<T>;
|
|
||||||
type Tree = { frame: { id: string; parentId?: string; name?: string }; childFrames?: Tree[] };
|
|
||||||
type Rect = { x: number; y: number; w: number; h: number };
|
|
||||||
type Oracle = {
|
|
||||||
probes: Record<string, Rect>;
|
|
||||||
viewport: { width: number; height: number };
|
|
||||||
owners: Record<string, { x: number; y: number; scale: number }>;
|
|
||||||
};
|
|
||||||
|
|
||||||
function clip(rect: Rect, viewport: Oracle["viewport"]): Rect | null {
|
|
||||||
const x = Math.max(0, rect.x),
|
|
||||||
y = Math.max(0, rect.y);
|
|
||||||
const right = Math.min(viewport.width, rect.x + rect.w);
|
|
||||||
const bottom = Math.min(viewport.height, rect.y + rect.h);
|
|
||||||
return right > x && bottom > y ? { x, y, w: right - x, h: bottom - y } : null;
|
|
||||||
}
|
|
||||||
|
|
||||||
// The independent oracle uses DOM border boxes and this fixture's axis-aligned
|
|
||||||
// iframe transforms. No production snapshot conversion/projection builds expectations.
|
|
||||||
const oracleExpression = `(() => {
|
|
||||||
const probes = {};
|
|
||||||
for (const node of document.querySelectorAll('[data-geometry-probe]')) {
|
|
||||||
const box = node.getBoundingClientRect();
|
|
||||||
probes[node.id] = { x: box.x, y: box.y, w: box.width, h: box.height };
|
|
||||||
}
|
|
||||||
const owners = {};
|
|
||||||
for (const frame of document.querySelectorAll('iframe')) {
|
|
||||||
const rect = frame.getBoundingClientRect();
|
|
||||||
const style = getComputedStyle(frame);
|
|
||||||
const scale = rect.width / frame.offsetWidth;
|
|
||||||
owners[frame.name] = {
|
|
||||||
x: rect.x + (frame.clientLeft + parseFloat(style.paddingLeft)) * scale,
|
|
||||||
y: rect.y + (frame.clientTop + parseFloat(style.paddingTop)) * scale,
|
|
||||||
scale,
|
|
||||||
};
|
|
||||||
}
|
|
||||||
return { probes, viewport: { width: document.documentElement.clientWidth, height: document.documentElement.clientHeight }, owners };
|
|
||||||
})()`;
|
|
||||||
|
|
||||||
describe.skipIf(!process.env.BSK_GEOMETRY_CHROME)("real DOMSnapshot coordinate contract", () => {
|
|
||||||
it.each(
|
|
||||||
[
|
|
||||||
{ deviceScale: 1, zoom: 1 },
|
|
||||||
{ deviceScale: 0.8, zoom: 1 },
|
|
||||||
{ deviceScale: 1, zoom: 1.25 },
|
|
||||||
{ deviceScale: 2, zoom: 1 },
|
|
||||||
{ deviceScale: 2, zoom: 0.8 },
|
|
||||||
]
|
|
||||||
.flatMap((configuration) => [
|
|
||||||
{ ...configuration, fixture: "snapshot-coordinates", scrollbars: "none" },
|
|
||||||
{ ...configuration, fixture: "oopif-scrollbars", scrollbars: "both" },
|
|
||||||
])
|
|
||||||
.concat(
|
|
||||||
["vertical", "horizontal", "none"].map((scrollbars) => ({
|
|
||||||
deviceScale: 1,
|
|
||||||
zoom: 1,
|
|
||||||
fixture: "oopif-scrollbars",
|
|
||||||
scrollbars,
|
|
||||||
})),
|
|
||||||
),
|
|
||||||
)("$fixture: device scale $deviceScale, zoom $zoom, scrollbars $scrollbars", async (configuration) => {
|
|
||||||
const evalRoot = new URL("../../../../../evals/browser/", import.meta.url);
|
|
||||||
const { createEvalServer } = await import(new URL("lib/server.mjs", evalRoot).href);
|
|
||||||
const { withChrome } = await import(
|
|
||||||
new URL("cases/regression/snapshot-coordinates/chrome.mjs", evalRoot).href
|
|
||||||
);
|
|
||||||
const server = createEvalServer();
|
|
||||||
const { baseUrl } = await server.start();
|
|
||||||
try {
|
|
||||||
await withChrome(
|
|
||||||
{ executable: process.env.BSK_GEOMETRY_CHROME, ...configuration },
|
|
||||||
async (send: Send) => {
|
|
||||||
const { targetId } = await send<{ targetId: string }>("Target.createTarget", {
|
|
||||||
url: "about:blank",
|
|
||||||
});
|
|
||||||
const { sessionId: rootSession } = await send<{ sessionId: string }>(
|
|
||||||
"Target.attachToTarget",
|
|
||||||
{ targetId, flatten: true },
|
|
||||||
);
|
|
||||||
await send(
|
|
||||||
"Page.navigate",
|
|
||||||
{
|
|
||||||
url: `${baseUrl}/${configuration.fixture}?run=coordinates&scrollbars=${configuration.scrollbars}`,
|
|
||||||
},
|
|
||||||
rootSession,
|
|
||||||
);
|
|
||||||
await expect
|
|
||||||
.poll(
|
|
||||||
() =>
|
|
||||||
server
|
|
||||||
.snapshot("coordinates")
|
|
||||||
.events.some(
|
|
||||||
(event: { type: string; data: { root?: boolean } }) =>
|
|
||||||
event.type === "geometry.ready" && event.data.root,
|
|
||||||
),
|
|
||||||
{ timeout: 10_000 },
|
|
||||||
)
|
|
||||||
.toBe(true);
|
|
||||||
|
|
||||||
const targets = await send<{ targetInfos: { targetId: string; type: string }[] }>(
|
|
||||||
"Target.getTargets",
|
|
||||||
);
|
|
||||||
const sessions = [rootSession];
|
|
||||||
for (const target of targets.targetInfos.filter((target) => target.type === "iframe")) {
|
|
||||||
const { sessionId } = await send<{ sessionId: string }>("Target.attachToTarget", {
|
|
||||||
targetId: target.targetId,
|
|
||||||
flatten: true,
|
|
||||||
});
|
|
||||||
sessions.push(sessionId);
|
|
||||||
}
|
|
||||||
expect(sessions.length).toBe(configuration.fixture === "oopif-scrollbars" ? 3 : 2);
|
|
||||||
const frames: CdpFrame[] = [];
|
|
||||||
const names = new Map<string, string>();
|
|
||||||
const sessionFor = (target: CdpTarget) => target.sessionId ?? rootSession;
|
|
||||||
for (const sessionId of sessions) {
|
|
||||||
const { frameTree } = await send<{ frameTree: Tree }>(
|
|
||||||
"Page.getFrameTree",
|
|
||||||
{},
|
|
||||||
sessionId,
|
|
||||||
);
|
|
||||||
const target: CdpTarget = {
|
|
||||||
tabId: 1,
|
|
||||||
...(sessionId === rootSession ? {} : { sessionId }),
|
|
||||||
};
|
|
||||||
const visit = (tree: Tree, parentFrameId = tree.frame.parentId) => {
|
|
||||||
frames.push({ frameId: tree.frame.id, parentFrameId, target });
|
|
||||||
names.set(tree.frame.id, tree.frame.name ?? "");
|
|
||||||
for (const child of tree.childFrames ?? []) visit(child, tree.frame.id);
|
|
||||||
};
|
|
||||||
visit(frameTree);
|
|
||||||
}
|
|
||||||
expect(frames).toHaveLength(configuration.fixture === "oopif-scrollbars" ? 3 : 5);
|
|
||||||
for (const frame of frames) {
|
|
||||||
if (!frame.parentFrameId) continue;
|
|
||||||
const parent = frames.find((item) => item.frameId === frame.parentFrameId)!;
|
|
||||||
const owner = await send<{ backendNodeId: number }>(
|
|
||||||
"DOM.getFrameOwner",
|
|
||||||
{ frameId: frame.frameId },
|
|
||||||
sessionFor(parent.target),
|
|
||||||
);
|
|
||||||
frame.ownerBackendNodeId = owner.backendNodeId;
|
|
||||||
}
|
|
||||||
const graph: CdpFrameGraph = { rootFrameId: frames[0].frameId, frames };
|
|
||||||
const calls: string[] = [];
|
|
||||||
const cdp: CdpRunner = {
|
|
||||||
send: (tabId, method, params) => {
|
|
||||||
calls.push(`${tabId}:${method}`);
|
|
||||||
return send(method, params, rootSession);
|
|
||||||
},
|
|
||||||
sendToTarget: (target, method, params) => {
|
|
||||||
calls.push(`${target.sessionId ?? target.tabId}:${method}`);
|
|
||||||
if (
|
|
||||||
method === "Runtime.evaluate" &&
|
|
||||||
(params as { expression?: string })?.expression?.includes("window.innerWidth")
|
|
||||||
)
|
|
||||||
calls.push(`${target.sessionId ?? target.tabId}:viewport-size`);
|
|
||||||
return send(method, params, sessionFor(target));
|
|
||||||
},
|
|
||||||
getFrameGraph: async () => graph,
|
|
||||||
getAttachmentId: () => rootSession,
|
|
||||||
};
|
|
||||||
const oracles = new Map<string, Oracle>();
|
|
||||||
for (const frame of frames) {
|
|
||||||
const session = sessionFor(frame.target);
|
|
||||||
const { executionContextId } = await send<{ executionContextId: number }>(
|
|
||||||
"Page.createIsolatedWorld",
|
|
||||||
{ frameId: frame.frameId, worldName: "coordinate-oracle" },
|
|
||||||
session,
|
|
||||||
);
|
|
||||||
await expect
|
|
||||||
.poll(
|
|
||||||
async () => {
|
|
||||||
const ready = await send<{ result: { value: boolean } }>(
|
|
||||||
"Runtime.evaluate",
|
|
||||||
{
|
|
||||||
expression: 'document.documentElement.dataset.geometryReady === "true"',
|
|
||||||
contextId: executionContextId,
|
|
||||||
returnByValue: true,
|
|
||||||
},
|
|
||||||
session,
|
|
||||||
);
|
|
||||||
return ready.result.value;
|
|
||||||
},
|
|
||||||
{ timeout: 5_000 },
|
|
||||||
)
|
|
||||||
.toBe(true);
|
|
||||||
// Establish scroll after cross-process target creation/layout settles.
|
|
||||||
const scroll = frame.parentFrameId
|
|
||||||
? names.get(frame.frameId) === "nested"
|
|
||||||
? [10, 20]
|
|
||||||
: [40, 100]
|
|
||||||
: [80, 240];
|
|
||||||
await send(
|
|
||||||
"Runtime.evaluate",
|
|
||||||
{
|
|
||||||
expression: `(async () => { scrollTo(${scroll.join(",")}); await new Promise(resolve => requestAnimationFrame(() => requestAnimationFrame(resolve))); })()`,
|
|
||||||
contextId: executionContextId,
|
|
||||||
awaitPromise: true,
|
|
||||||
},
|
|
||||||
session,
|
|
||||||
);
|
|
||||||
const reply = await send<{ result: { value: Oracle } }>(
|
|
||||||
"Runtime.evaluate",
|
|
||||||
{ expression: oracleExpression, contextId: executionContextId, returnByValue: true },
|
|
||||||
session,
|
|
||||||
);
|
|
||||||
oracles.set(frame.frameId, reply.result.value);
|
|
||||||
}
|
|
||||||
const childViewport = await send<{
|
|
||||||
result: {
|
|
||||||
value: { width: number; height: number; clientWidth: number; clientHeight: number };
|
|
||||||
};
|
|
||||||
}>(
|
|
||||||
"Runtime.evaluate",
|
|
||||||
{
|
|
||||||
expression:
|
|
||||||
"({ width: innerWidth, height: innerHeight, clientWidth: document.documentElement.clientWidth, clientHeight: document.documentElement.clientHeight })",
|
|
||||||
returnByValue: true,
|
|
||||||
},
|
|
||||||
sessions[1],
|
|
||||||
);
|
|
||||||
for (const dimension of ["Width", "Height"] as const) {
|
|
||||||
const occupied =
|
|
||||||
childViewport.result.value[dimension === "Width" ? "width" : "height"] -
|
|
||||||
childViewport.result.value[`client${dimension}`];
|
|
||||||
if (
|
|
||||||
configuration.scrollbars === "both" ||
|
|
||||||
configuration.scrollbars === (dimension === "Width" ? "vertical" : "horizontal")
|
|
||||||
)
|
|
||||||
expect(occupied).toBeGreaterThan(0);
|
|
||||||
else expect(occupied).toBe(0);
|
|
||||||
}
|
|
||||||
const facts = await captureObservationFacts(cdp, 1);
|
|
||||||
expect(facts.issues).toEqual([]);
|
|
||||||
expect(calls.filter((call) => call.endsWith(":Page.getLayoutMetrics"))).toHaveLength(
|
|
||||||
sessions.length,
|
|
||||||
);
|
|
||||||
// Identity verification also uses Runtime.evaluate; count the full viewport reads separately.
|
|
||||||
const viewportReadsBeforeLive = calls.filter((call) => call.endsWith(":viewport-size"));
|
|
||||||
expect(new Set(viewportReadsBeforeLive).size).toBe(viewportReadsBeforeLive.length);
|
|
||||||
expect(viewportReadsBeforeLive.length).toBeLessThanOrEqual(sessions.length - 1);
|
|
||||||
for (const frame of frames) {
|
|
||||||
for (const [id, local] of Object.entries(oracles.get(frame.frameId)!.probes)) {
|
|
||||||
const node = facts.documents
|
|
||||||
.find((doc) => doc.frame.frameId === frame.frameId)
|
|
||||||
?.domNodes.find((node) => node.attrs.id === id);
|
|
||||||
expect(node, `missing ${id} in ${names.get(frame.frameId) || "root"}`).toBeDefined();
|
|
||||||
let top = clip(local, oracles.get(frame.frameId)!.viewport);
|
|
||||||
let current = frame;
|
|
||||||
while (top && current.parentFrameId) {
|
|
||||||
const parentOracle = oracles.get(current.parentFrameId)!;
|
|
||||||
const owner = parentOracle.owners[names.get(current.frameId)!];
|
|
||||||
top = clip(
|
|
||||||
{
|
|
||||||
x: owner.x + top.x * owner.scale,
|
|
||||||
y: owner.y + top.y * owner.scale,
|
|
||||||
w: top.w * owner.scale,
|
|
||||||
h: top.h * owner.scale,
|
|
||||||
},
|
|
||||||
parentOracle.viewport,
|
|
||||||
);
|
|
||||||
current = frames.find((item) => item.frameId === current.parentFrameId)!;
|
|
||||||
}
|
|
||||||
for (const key of ["x", "y", "w", "h"] as const)
|
|
||||||
expect(
|
|
||||||
Math.abs(node!.localRect![key] - local[key]),
|
|
||||||
`${names.get(frame.frameId)} ${id} local ${key}`,
|
|
||||||
).toBeLessThan(2);
|
|
||||||
if (!top) {
|
|
||||||
expect(node!.rect, `${id} must be clipped out`).toBeNull();
|
|
||||||
if (configuration.fixture === "oopif-scrollbars")
|
|
||||||
expect(
|
|
||||||
await resolveNodeGeometry(cdp, 1, {
|
|
||||||
target: frame.target,
|
|
||||||
frameId: frame.frameId,
|
|
||||||
backendNodeId: node!.backendNodeId,
|
|
||||||
}),
|
|
||||||
).toMatchObject({ code: "permission_denied" });
|
|
||||||
continue;
|
|
||||||
}
|
|
||||||
expect(node!.rect).not.toBeNull();
|
|
||||||
for (const key of ["x", "y", "w", "h"] as const)
|
|
||||||
expect(
|
|
||||||
Math.abs(node!.rect![key] - top[key]),
|
|
||||||
`${names.get(frame.frameId)} ${id} top ${key}`,
|
|
||||||
).toBeLessThan(2);
|
|
||||||
if (configuration.fixture !== "oopif-scrollbars") continue;
|
|
||||||
const live = await resolveNodeGeometry(cdp, 1, {
|
|
||||||
target: frame.target,
|
|
||||||
frameId: frame.frameId,
|
|
||||||
backendNodeId: node!.backendNodeId,
|
|
||||||
});
|
|
||||||
if ("code" in live) throw new Error(live.message);
|
|
||||||
for (const [key, liveKey] of [
|
|
||||||
["x", "x"],
|
|
||||||
["y", "y"],
|
|
||||||
["w", "width"],
|
|
||||||
["h", "height"],
|
|
||||||
] as const)
|
|
||||||
expect(
|
|
||||||
Math.abs(live.topBounds[liveKey] - top[key]),
|
|
||||||
`${id} live ${key}`,
|
|
||||||
).toBeLessThan(2);
|
|
||||||
const before = server.snapshot("coordinates").events.length;
|
|
||||||
for (const type of ["mousePressed", "mouseReleased"])
|
|
||||||
await send(
|
|
||||||
"Input.dispatchMouseEvent",
|
|
||||||
{ type, ...live.actionPoint, button: "left", clickCount: 1 },
|
|
||||||
rootSession,
|
|
||||||
);
|
|
||||||
await expect
|
|
||||||
.poll(
|
|
||||||
() =>
|
|
||||||
server
|
|
||||||
.snapshot("coordinates")
|
|
||||||
.events.slice(before)
|
|
||||||
.some(
|
|
||||||
(event: { type: string; path: string; data: { probe?: string } }) =>
|
|
||||||
event.type === "geometry.clicked" &&
|
|
||||||
event.data.probe === id &&
|
|
||||||
event.path ===
|
|
||||||
(frame.parentFrameId
|
|
||||||
? names.get(frame.frameId) === "nested"
|
|
||||||
? "/oopif-scrollbars/nested"
|
|
||||||
: "/oopif-scrollbars/frame"
|
|
||||||
: "/oopif-scrollbars"),
|
|
||||||
),
|
|
||||||
{ timeout: 3000 },
|
|
||||||
)
|
|
||||||
.toBe(true);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
const metrics = await send<{
|
|
||||||
cssVisualViewport: { zoom: number };
|
|
||||||
visualViewport: { clientWidth: number };
|
|
||||||
}>("Page.getLayoutMetrics", {}, rootSession);
|
|
||||||
expect(metrics.cssVisualViewport.zoom).toBeCloseTo(configuration.zoom, 4);
|
|
||||||
},
|
|
||||||
);
|
|
||||||
} finally {
|
|
||||||
await server.stop();
|
|
||||||
}
|
|
||||||
}, 30_000);
|
|
||||||
});
|
|
||||||
@@ -2,14 +2,12 @@ import { OVERLAY_AUTOMATION_BYPASS } from "@/lib/overlay-bridge";
|
|||||||
import type { SessionManager } from "@/session-manager/manager";
|
import type { SessionManager } from "@/session-manager/manager";
|
||||||
import type { Transport } from "@/transport/transport";
|
import type { Transport } from "@/transport/transport";
|
||||||
import type {
|
import type {
|
||||||
BlurParams,
|
|
||||||
ClickParams,
|
ClickParams,
|
||||||
ConsoleParams,
|
ConsoleParams,
|
||||||
DownloadParams,
|
DownloadParams,
|
||||||
EmulateParams,
|
EmulateParams,
|
||||||
EvaluateParams,
|
EvaluateParams,
|
||||||
FillParams,
|
FillParams,
|
||||||
FocusParams,
|
|
||||||
GetHtmlParams,
|
GetHtmlParams,
|
||||||
HoverParams,
|
HoverParams,
|
||||||
HoverResult,
|
HoverResult,
|
||||||
@@ -29,7 +27,6 @@ import type {
|
|||||||
ResponseFrame,
|
ResponseFrame,
|
||||||
RpcError,
|
RpcError,
|
||||||
ScreenshotParams,
|
ScreenshotParams,
|
||||||
ScrollToParams,
|
|
||||||
SelectParams,
|
SelectParams,
|
||||||
SnapshotParams,
|
SnapshotParams,
|
||||||
UploadParams,
|
UploadParams,
|
||||||
@@ -42,15 +39,7 @@ import { type EmulateCdpRunner, handleEmulate } from "./emulate";
|
|||||||
import { classifyCdpError } from "./errors";
|
import { classifyCdpError } from "./errors";
|
||||||
import { handleEvaluate } from "./evaluate";
|
import { handleEvaluate } from "./evaluate";
|
||||||
import { handleRequestHelp } from "./human-loop";
|
import { handleRequestHelp } from "./human-loop";
|
||||||
import {
|
import { handleClick, handleFill, handleHover, handlePress, handleSelect } from "./interaction";
|
||||||
handleBlur,
|
|
||||||
handleClick,
|
|
||||||
handleFill,
|
|
||||||
handleFocus,
|
|
||||||
handleHover,
|
|
||||||
handlePress,
|
|
||||||
handleSelect,
|
|
||||||
} from "./interaction";
|
|
||||||
import {
|
import {
|
||||||
handleNavigate,
|
handleNavigate,
|
||||||
handleNavigateBack,
|
handleNavigateBack,
|
||||||
@@ -72,7 +61,6 @@ import {
|
|||||||
handleRecordStop,
|
handleRecordStop,
|
||||||
type RecordRuntimeDeps,
|
type RecordRuntimeDeps,
|
||||||
} from "./record";
|
} from "./record";
|
||||||
import { handleScrollTo } from "./scroll";
|
|
||||||
import {
|
import {
|
||||||
handleSessionStart,
|
handleSessionStart,
|
||||||
handleSessionStop,
|
handleSessionStop,
|
||||||
@@ -527,39 +515,6 @@ export class ToolDispatcher {
|
|||||||
);
|
);
|
||||||
return this.rememberHover((req.params as HoverParams).session_id, result);
|
return this.rememberHover((req.params as HoverParams).session_id, result);
|
||||||
}
|
}
|
||||||
case "tool.scroll_to":
|
|
||||||
return this.withHoverReleaseForRequest(
|
|
||||||
req.params as ScrollToParams,
|
|
||||||
() =>
|
|
||||||
handleScrollTo(
|
|
||||||
this.sessions,
|
|
||||||
req.params as ScrollToParams,
|
|
||||||
this.cdp ? { cdp: this.cdp, tabsApi: chromeTabsApi, signal } : undefined,
|
|
||||||
),
|
|
||||||
signal,
|
|
||||||
);
|
|
||||||
case "tool.focus":
|
|
||||||
return this.withHoverReleaseForRequest(
|
|
||||||
req.params as FocusParams,
|
|
||||||
() =>
|
|
||||||
handleFocus(
|
|
||||||
this.sessions,
|
|
||||||
req.params as FocusParams,
|
|
||||||
this.cdp ? { cdp: this.cdp, tabsApi: chromeTabsApi, signal } : undefined,
|
|
||||||
),
|
|
||||||
signal,
|
|
||||||
);
|
|
||||||
case "tool.blur":
|
|
||||||
return this.withHoverReleaseForRequest(
|
|
||||||
req.params as BlurParams,
|
|
||||||
() =>
|
|
||||||
handleBlur(
|
|
||||||
this.sessions,
|
|
||||||
req.params as BlurParams,
|
|
||||||
this.cdp ? { cdp: this.cdp, tabsApi: chromeTabsApi, signal } : undefined,
|
|
||||||
),
|
|
||||||
signal,
|
|
||||||
);
|
|
||||||
case "tool.fill":
|
case "tool.fill":
|
||||||
return this.withHoverReleaseForRequest(
|
return this.withHoverReleaseForRequest(
|
||||||
req.params as FillParams,
|
req.params as FillParams,
|
||||||
@@ -830,9 +785,6 @@ function sessionIdForBrowserControlMethod(req: RequestFrame): string | null {
|
|||||||
case "tool.reload":
|
case "tool.reload":
|
||||||
case "tool.click":
|
case "tool.click":
|
||||||
case "tool.hover":
|
case "tool.hover":
|
||||||
case "tool.scroll_to":
|
|
||||||
case "tool.focus":
|
|
||||||
case "tool.blur":
|
|
||||||
case "tool.fill":
|
case "tool.fill":
|
||||||
case "tool.press":
|
case "tool.press":
|
||||||
case "tool.select":
|
case "tool.select":
|
||||||
|
|||||||
@@ -161,8 +161,7 @@ export async function resolveNodeGeometry(
|
|||||||
return geometryError(`could not resolve frame geometry for ${address.frameId}`);
|
return geometryError(`could not resolve frame geometry for ${address.frameId}`);
|
||||||
topVisibleRegions = projectRegionToViewport(localRegion, projection);
|
topVisibleRegions = projectRegionToViewport(localRegion, projection);
|
||||||
if (address.target.sessionId) {
|
if (address.target.sessionId) {
|
||||||
const localViewport = await context.viewport(address.target);
|
const localViewport = projection.edges[0]?.sourceViewport ?? projection.topViewport;
|
||||||
if (!localViewport) return geometryError("could not resolve target viewport geometry");
|
|
||||||
const localVisibleRegions = localRegion
|
const localVisibleRegions = localRegion
|
||||||
.map((polygon) =>
|
.map((polygon) =>
|
||||||
clipPolygon(
|
clipPolygon(
|
||||||
|
|||||||
@@ -25,12 +25,6 @@ export interface UnavailableFrameProjection {
|
|||||||
ownerBackendNodeId: number;
|
ownerBackendNodeId: number;
|
||||||
}
|
}
|
||||||
|
|
||||||
export interface UnavailableSnapshotCoordinates {
|
|
||||||
status: "unavailable";
|
|
||||||
source: CoordinateOwner;
|
|
||||||
reason: "snapshot-coordinates-unavailable";
|
|
||||||
}
|
|
||||||
|
|
||||||
export type SnapshotProjectionResult =
|
export type SnapshotProjectionResult =
|
||||||
| { status: "available"; projection: SnapshotProjection }
|
| { status: "available"; projection: SnapshotProjection }
|
||||||
| UnavailableFrameProjection;
|
| UnavailableFrameProjection;
|
||||||
@@ -38,74 +32,25 @@ export type SnapshotProjectionResult =
|
|||||||
/** Descendants inherit the failed boundary without attempting another owner read. */
|
/** Descendants inherit the failed boundary without attempting another owner read. */
|
||||||
export type FrameProjectionIssue =
|
export type FrameProjectionIssue =
|
||||||
| UnavailableFrameProjection
|
| UnavailableFrameProjection
|
||||||
| UnavailableSnapshotCoordinates
|
| { status: "blocked"; source: CoordinateOwner; cause: UnavailableFrameProjection };
|
||||||
| {
|
|
||||||
status: "blocked";
|
|
||||||
source: CoordinateOwner;
|
|
||||||
cause: UnavailableFrameProjection | UnavailableSnapshotCoordinates;
|
|
||||||
};
|
|
||||||
|
|
||||||
export type FrameProjectionState = SnapshotProjectionResult | FrameProjectionIssue;
|
export type FrameProjectionState = SnapshotProjectionResult | FrameProjectionIssue;
|
||||||
|
|
||||||
export interface SnapshotCoordinates {
|
/** DOMSnapshot bounds are document-relative CSS pixels, independent of raster DPR. */
|
||||||
layoutUnitsPerCssPixel: number;
|
|
||||||
scrollCss: { x: number; y: number };
|
|
||||||
}
|
|
||||||
|
|
||||||
/** Snapshot scroll offsets share the raw layout units of its bounds. Only a
|
|
||||||
* target's root document may fall back to that target's CSS layout viewport. */
|
|
||||||
export function snapshotCoordinates(
|
|
||||||
document: { scrollOffsetX?: number; scrollOffsetY?: number },
|
|
||||||
layoutUnitsPerCssPixel: number | null,
|
|
||||||
rootScrollCss?: { x?: number; y?: number },
|
|
||||||
): SnapshotCoordinates | null {
|
|
||||||
if (
|
|
||||||
layoutUnitsPerCssPixel === null ||
|
|
||||||
!Number.isFinite(layoutUnitsPerCssPixel) ||
|
|
||||||
layoutUnitsPerCssPixel <= 0
|
|
||||||
)
|
|
||||||
return null;
|
|
||||||
const x =
|
|
||||||
document.scrollOffsetX === undefined
|
|
||||||
? rootScrollCss?.x
|
|
||||||
: document.scrollOffsetX / layoutUnitsPerCssPixel;
|
|
||||||
const y =
|
|
||||||
document.scrollOffsetY === undefined
|
|
||||||
? rootScrollCss?.y
|
|
||||||
: document.scrollOffsetY / layoutUnitsPerCssPixel;
|
|
||||||
if (x === undefined || y === undefined || !Number.isFinite(x) || !Number.isFinite(y)) return null;
|
|
||||||
return { layoutUnitsPerCssPixel, scrollCss: { x, y } };
|
|
||||||
}
|
|
||||||
|
|
||||||
/** Convert raw document-relative Blink layout units exactly once, before any
|
|
||||||
* CSS viewport clipping or frame projection. This scale is not screenshot zoom. */
|
|
||||||
export function snapshotViewportRect(
|
export function snapshotViewportRect(
|
||||||
bounds: number[],
|
bounds: number[],
|
||||||
owner: CoordinateOwner,
|
owner: CoordinateOwner,
|
||||||
coordinates: SnapshotCoordinates | null,
|
scroll: { x: number; y: number },
|
||||||
): FrameViewportRect | null {
|
): FrameViewportRect | null {
|
||||||
if (!coordinates || bounds.length < 4 || !bounds.slice(0, 4).every(Number.isFinite)) return null;
|
if (bounds.length < 4 || !bounds.slice(0, 4).every(Number.isFinite)) return null;
|
||||||
const { layoutUnitsPerCssPixel: scale, scrollCss: scroll } = coordinates;
|
|
||||||
const [x, y, width, height] = bounds;
|
const [x, y, width, height] = bounds;
|
||||||
if (
|
if (width <= 0 || height <= 0 || !Number.isFinite(scroll.x) || !Number.isFinite(scroll.y)) {
|
||||||
!Number.isFinite(scale) ||
|
|
||||||
scale <= 0 ||
|
|
||||||
width <= 0 ||
|
|
||||||
height <= 0 ||
|
|
||||||
!Number.isFinite(scroll.x) ||
|
|
||||||
!Number.isFinite(scroll.y)
|
|
||||||
) {
|
|
||||||
return null;
|
return null;
|
||||||
}
|
}
|
||||||
return {
|
return {
|
||||||
space: "frame-viewport-css",
|
space: "frame-viewport-css",
|
||||||
owner,
|
owner,
|
||||||
rect: {
|
rect: { x: x - scroll.x, y: y - scroll.y, width, height },
|
||||||
x: x / scale - scroll.x,
|
|
||||||
y: y / scale - scroll.y,
|
|
||||||
width: width / scale,
|
|
||||||
height: height / scale,
|
|
||||||
},
|
|
||||||
};
|
};
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|||||||
@@ -9,10 +9,8 @@ import {
|
|||||||
type Polygon,
|
type Polygon,
|
||||||
type ProjectiveEdge,
|
type ProjectiveEdge,
|
||||||
parseCdpQuad,
|
parseCdpQuad,
|
||||||
projectPolygon,
|
|
||||||
type Quad,
|
type Quad,
|
||||||
type Size,
|
type Size,
|
||||||
viewportPolygon,
|
|
||||||
} from "../geometry";
|
} from "../geometry";
|
||||||
import { type CdpRunner, sendToCdpTarget } from "../shared";
|
import { type CdpRunner, sendToCdpTarget } from "../shared";
|
||||||
import type { CoordinateOwner, CssViewport, SnapshotProjectionResult } from "./coordinate-types";
|
import type { CoordinateOwner, CssViewport, SnapshotProjectionResult } from "./coordinate-types";
|
||||||
@@ -20,8 +18,8 @@ import type { CoordinateOwner, CssViewport, SnapshotProjectionResult } from "./c
|
|||||||
import { readSnapshotOwnerSizes } from "./snapshot-owner-sizes";
|
import { readSnapshotOwnerSizes } from "./snapshot-owner-sizes";
|
||||||
|
|
||||||
export interface LayoutMetrics {
|
export interface LayoutMetrics {
|
||||||
cssVisualViewport?: { zoom?: number; clientWidth?: number; clientHeight?: number };
|
cssVisualViewport?: { zoom?: number };
|
||||||
visualViewport?: { zoom?: number; clientWidth?: number; clientHeight?: number };
|
visualViewport?: { zoom?: number };
|
||||||
cssLayoutViewport?: {
|
cssLayoutViewport?: {
|
||||||
clientWidth?: number;
|
clientWidth?: number;
|
||||||
clientHeight?: number;
|
clientHeight?: number;
|
||||||
@@ -31,29 +29,6 @@ export interface LayoutMetrics {
|
|||||||
layoutViewport?: { clientWidth?: number; clientHeight?: number; pageX?: number; pageY?: number };
|
layoutViewport?: { clientWidth?: number; clientHeight?: number; pageX?: number; pageY?: number };
|
||||||
}
|
}
|
||||||
|
|
||||||
/** Chromium emits these paired floating-point dimensions before/after dividing
|
|
||||||
* by LayoutZoomFactor. Integer layout viewport dimensions lose precision at
|
|
||||||
* fractional zoom. Neither visualViewport.scale nor .zoom is this conversion.
|
|
||||||
* See InspectorPageAgent::getLayoutMetrics in Chromium. */
|
|
||||||
export function snapshotLayoutScale(metrics: LayoutMetrics): number | null {
|
|
||||||
for (const dimension of ["clientWidth", "clientHeight"] as const) {
|
|
||||||
const raw = metrics.visualViewport?.[dimension];
|
|
||||||
const css = metrics.cssVisualViewport?.[dimension];
|
|
||||||
if (
|
|
||||||
raw !== undefined &&
|
|
||||||
css !== undefined &&
|
|
||||||
Number.isFinite(raw) &&
|
|
||||||
Number.isFinite(css) &&
|
|
||||||
raw > 0 &&
|
|
||||||
css > 0
|
|
||||||
) {
|
|
||||||
const scale = raw / css;
|
|
||||||
if (Number.isFinite(scale) && scale > 0) return scale;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return null;
|
|
||||||
}
|
|
||||||
|
|
||||||
/** The legacy field is a compatibility fallback, never a source of raster DPR. */
|
/** The legacy field is a compatibility fallback, never a source of raster DPR. */
|
||||||
export function cssViewport(metrics: LayoutMetrics): CssViewport {
|
export function cssViewport(metrics: LayoutMetrics): CssViewport {
|
||||||
const value = metrics.cssLayoutViewport ?? metrics.layoutViewport;
|
const value = metrics.cssLayoutViewport ?? metrics.layoutViewport;
|
||||||
@@ -69,7 +44,6 @@ export function cssViewport(metrics: LayoutMetrics): CssViewport {
|
|||||||
/** One read-only measurement phase. Discard after scrolling or any later operation. */
|
/** One read-only measurement phase. Discard after scrolling or any later operation. */
|
||||||
export class GeometryContext {
|
export class GeometryContext {
|
||||||
private readonly metrics = new Map<string, Promise<LayoutMetrics>>();
|
private readonly metrics = new Map<string, Promise<LayoutMetrics>>();
|
||||||
private readonly frameViewports = new Map<string, Promise<Size | null>>();
|
|
||||||
private readonly owners = new Map<string, Promise<Quad | null>>();
|
private readonly owners = new Map<string, Promise<Quad | null>>();
|
||||||
private readonly projections = new Map<string, Promise<GeometryProjection | null>>();
|
private readonly projections = new Map<string, Promise<GeometryProjection | null>>();
|
||||||
private readonly snapshotOwners = new Map<string, Promise<{ quad: Quad; size: Size } | null>>();
|
private readonly snapshotOwners = new Map<string, Promise<{ quad: Quad; size: Size } | null>>();
|
||||||
@@ -160,35 +134,6 @@ export class GeometryContext {
|
|||||||
: null;
|
: null;
|
||||||
}
|
}
|
||||||
|
|
||||||
/** The full OOPIF viewport maps to its owner's content quad. Layout metrics
|
|
||||||
* exclude occupied scrollbars and remain the clipping boundary, not the scale. */
|
|
||||||
private frameViewport(target: CdpTarget): Promise<Size | null> {
|
|
||||||
const key = cdpTargetKey(target);
|
|
||||||
let promise = this.frameViewports.get(key);
|
|
||||||
if (!promise) {
|
|
||||||
promise = this.request<{ result?: { value?: Size }; exceptionDetails?: unknown }>(
|
|
||||||
target,
|
|
||||||
"Runtime.evaluate",
|
|
||||||
{
|
|
||||||
expression: "({ width: window.innerWidth, height: window.innerHeight })",
|
|
||||||
returnByValue: true,
|
|
||||||
},
|
|
||||||
).then(({ result, exceptionDetails }) => {
|
|
||||||
const size = result?.value;
|
|
||||||
return !exceptionDetails &&
|
|
||||||
size &&
|
|
||||||
Number.isFinite(size.width) &&
|
|
||||||
Number.isFinite(size.height) &&
|
|
||||||
size.width > 0 &&
|
|
||||||
size.height > 0
|
|
||||||
? size
|
|
||||||
: null;
|
|
||||||
});
|
|
||||||
this.frameViewports.set(key, promise);
|
|
||||||
}
|
|
||||||
return promise;
|
|
||||||
}
|
|
||||||
|
|
||||||
ownerContent(target: CdpTarget, backendNodeId: number): Promise<Quad | null> {
|
ownerContent(target: CdpTarget, backendNodeId: number): Promise<Quad | null> {
|
||||||
const key = `${cdpTargetKey(target)}:${backendNodeId}`;
|
const key = `${cdpTargetKey(target)}:${backendNodeId}`;
|
||||||
let promise = this.owners.get(key);
|
let promise = this.owners.get(key);
|
||||||
@@ -374,19 +319,12 @@ export class GeometryContext {
|
|||||||
const parent = frames.get(root.parentFrameId);
|
const parent = frames.get(root.parentFrameId);
|
||||||
if (!parent || root.ownerBackendNodeId === undefined) return null;
|
if (!parent || root.ownerBackendNodeId === undefined) return null;
|
||||||
const destinationQuad = await this.ownerContent(parent.target, root.ownerBackendNodeId);
|
const destinationQuad = await this.ownerContent(parent.target, root.ownerBackendNodeId);
|
||||||
if (!destinationQuad) return null;
|
const source = await this.viewport(root.target);
|
||||||
const source = await this.frameViewport(root.target);
|
|
||||||
const visible = await this.viewport(root.target);
|
|
||||||
const parentRoot = this.targetRoot(frames, parent);
|
const parentRoot = this.targetRoot(frames, parent);
|
||||||
if (!source || !visible || !parentRoot) return null;
|
if (!destinationQuad || !source || !parentRoot) return null;
|
||||||
const destinationClips = await this.clips(frames, parent, parentRoot);
|
const destinationClips = await this.clips(frames, parent, parentRoot);
|
||||||
if (!destinationClips) return null;
|
if (!destinationClips) return null;
|
||||||
const edge = { sourceViewport: source, destinationQuad, destinationClips };
|
edges.push({ sourceViewport: source, destinationQuad, destinationClips });
|
||||||
// Keep scrollbar strips clipped at every target boundary, including
|
|
||||||
// intermediate OOPIFs. Project the clip with the same full-viewport scale.
|
|
||||||
if (source.width !== visible.width || source.height !== visible.height)
|
|
||||||
destinationClips.push(projectPolygon(viewportPolygon(visible), edge));
|
|
||||||
edges.push(edge);
|
|
||||||
root = parentRoot;
|
root = parentRoot;
|
||||||
}
|
}
|
||||||
const topViewport = await this.viewport(root.target);
|
const topViewport = await this.viewport(root.target);
|
||||||
|
|||||||
@@ -1,4 +1,5 @@
|
|||||||
// DOM interaction tools — click, hover, focus/blur, fill, press, and select.
|
// DOM interaction tools — `tool.click`, `tool.fill`, `tool.press`, and
|
||||||
|
// `tool.select`.
|
||||||
//
|
//
|
||||||
// All interaction tools:
|
// All interaction tools:
|
||||||
// 1. Resolve target tab (sandbox: must be inside Agent Window).
|
// 1. Resolve target tab (sandbox: must be inside Agent Window).
|
||||||
@@ -13,14 +14,10 @@ import { ChromiumCdp } from "@/browser-driver/chromium-cdp";
|
|||||||
import type { CdpTarget } from "@/browser-driver/frame-graph";
|
import type { CdpTarget } from "@/browser-driver/frame-graph";
|
||||||
import type { SessionContext, SessionManager } from "@/session-manager/manager";
|
import type { SessionContext, SessionManager } from "@/session-manager/manager";
|
||||||
import type {
|
import type {
|
||||||
BlurParams,
|
|
||||||
BlurResult,
|
|
||||||
ClickParams,
|
ClickParams,
|
||||||
ClickResult,
|
ClickResult,
|
||||||
FillParams,
|
FillParams,
|
||||||
FillResult,
|
FillResult,
|
||||||
FocusParams,
|
|
||||||
FocusResult,
|
|
||||||
HoverParams,
|
HoverParams,
|
||||||
HoverResult,
|
HoverResult,
|
||||||
KeyModifier,
|
KeyModifier,
|
||||||
@@ -230,207 +227,6 @@ export async function resolveBackendNode(
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
// Check the target's own root, then its hosts: closed shadow roots are not
|
|
||||||
// reachable via host.shadowRoot. DOM focus remains meaningful in background tabs.
|
|
||||||
const FOCUS_CHECK = `function() {
|
|
||||||
if (!this.isConnected) return false;
|
|
||||||
let element = this;
|
|
||||||
while (element) {
|
|
||||||
const root = element.getRootNode();
|
|
||||||
if (root.activeElement !== element) return false;
|
|
||||||
element = root.host;
|
|
||||||
}
|
|
||||||
return true;
|
|
||||||
}`;
|
|
||||||
|
|
||||||
const BLUR_TARGET = `function() {
|
|
||||||
if (!this.isConnected) throw new Error('blur target is detached');
|
|
||||||
const wasFocused = (${FOCUS_CHECK}).call(this);
|
|
||||||
if (typeof this.blur !== 'function') return { ok: false, was_focused: wasFocused };
|
|
||||||
this.blur();
|
|
||||||
return { ok: true, was_focused: wasFocused };
|
|
||||||
}`;
|
|
||||||
|
|
||||||
interface FocusScriptReply<T> {
|
|
||||||
result?: { value?: T };
|
|
||||||
exceptionDetails?: { text?: string; exception?: { description?: string } };
|
|
||||||
}
|
|
||||||
|
|
||||||
function checkFocusAbort(signal: AbortSignal | undefined): void {
|
|
||||||
if (signal?.aborted) throw new DOMException("interaction aborted", "AbortError");
|
|
||||||
}
|
|
||||||
|
|
||||||
// Only focus/blur use this view. Guard every CDP boundary, including commands
|
|
||||||
// inside selector resolution and frame scrolling, without changing other tools.
|
|
||||||
function focusCdp(cdp: CdpRunner, signal: AbortSignal | undefined): CdpRunner {
|
|
||||||
const send = <T = unknown>(target: CdpTarget, method: string, params?: object): Promise<T> => {
|
|
||||||
checkFocusAbort(signal);
|
|
||||||
return cdpRunnerForTarget(cdp, target).send<T>(target.tabId, method, params);
|
|
||||||
};
|
|
||||||
return {
|
|
||||||
send: (tabId, method, params) => send({ tabId }, method, params),
|
|
||||||
sendToTarget: send,
|
|
||||||
trackSessionTab: cdp.trackSessionTab?.bind(cdp),
|
|
||||||
getFrameGraph: cdp.getFrameGraph
|
|
||||||
? (tabId) => {
|
|
||||||
checkFocusAbort(signal);
|
|
||||||
return cdp.getFrameGraph!(tabId);
|
|
||||||
}
|
|
||||||
: undefined,
|
|
||||||
};
|
|
||||||
}
|
|
||||||
|
|
||||||
// ---------------------------------------------------------------------------
|
|
||||||
// tool.focus / tool.blur
|
|
||||||
// ---------------------------------------------------------------------------
|
|
||||||
|
|
||||||
export function handleFocus(
|
|
||||||
manager: SessionManager,
|
|
||||||
params: FocusParams,
|
|
||||||
deps: InteractionDeps = getDefaultDeps(),
|
|
||||||
): Promise<FocusResult | RpcError> {
|
|
||||||
return changeFocus(manager, params, deps, "focus");
|
|
||||||
}
|
|
||||||
|
|
||||||
export function handleBlur(
|
|
||||||
manager: SessionManager,
|
|
||||||
params: BlurParams,
|
|
||||||
deps: InteractionDeps = getDefaultDeps(),
|
|
||||||
): Promise<BlurResult | RpcError> {
|
|
||||||
return changeFocus(manager, params, deps, "blur");
|
|
||||||
}
|
|
||||||
|
|
||||||
function changeFocus(
|
|
||||||
manager: SessionManager,
|
|
||||||
params: FocusParams,
|
|
||||||
deps: InteractionDeps,
|
|
||||||
action: "focus",
|
|
||||||
): Promise<FocusResult | RpcError>;
|
|
||||||
function changeFocus(
|
|
||||||
manager: SessionManager,
|
|
||||||
params: BlurParams,
|
|
||||||
deps: InteractionDeps,
|
|
||||||
action: "blur",
|
|
||||||
): Promise<BlurResult | RpcError>;
|
|
||||||
async function changeFocus(
|
|
||||||
manager: SessionManager,
|
|
||||||
params: FocusParams | BlurParams,
|
|
||||||
deps: InteractionDeps,
|
|
||||||
action: "focus" | "blur",
|
|
||||||
): Promise<FocusResult | BlurResult | RpcError> {
|
|
||||||
const ctx = lookupSession(manager, params, action);
|
|
||||||
if (isRpcError(ctx)) return ctx;
|
|
||||||
const cdp = focusCdp(deps.cdp, deps.signal);
|
|
||||||
let objectId: string | undefined;
|
|
||||||
let cleanupCdp: CdpRunner | undefined;
|
|
||||||
let tabId: number | undefined;
|
|
||||||
try {
|
|
||||||
checkFocusAbort(deps.signal);
|
|
||||||
const target = await resolveTargetTab(manager, ctx, params.tab_id, deps.tabsApi);
|
|
||||||
checkFocusAbort(deps.signal);
|
|
||||||
if (isRpcError(target)) return target;
|
|
||||||
const denied = enforceAgentWindow(ctx, target, action);
|
|
||||||
if (denied) return denied;
|
|
||||||
tabId = target.tabId;
|
|
||||||
const dialogCursor = markDialogCursor(deps.cdp, tabId);
|
|
||||||
const node = await resolveBackendNode(cdp, ctx, target, params, action);
|
|
||||||
checkFocusAbort(deps.signal);
|
|
||||||
if (isRpcError(node)) return node;
|
|
||||||
const nodeCdp = cdpRunnerForTarget(cdp, node.cdpTarget);
|
|
||||||
cleanupCdp = cdpRunnerForTarget(deps.cdp, node.cdpTarget);
|
|
||||||
deps.cdp.trackSessionTab?.(ctx.sessionId, tabId);
|
|
||||||
|
|
||||||
if (action === "focus") {
|
|
||||||
const scrollErr = await scrollElementAndFramesIntoView(
|
|
||||||
cdp,
|
|
||||||
tabId,
|
|
||||||
node.cdpTarget,
|
|
||||||
node.backendNodeId,
|
|
||||||
node.frameId,
|
|
||||||
);
|
|
||||||
checkFocusAbort(deps.signal);
|
|
||||||
if (scrollErr) return scrollErr;
|
|
||||||
}
|
|
||||||
const resolved = await backendNodeToObject(nodeCdp, tabId, node.backendNodeId);
|
|
||||||
// Keep the handle before checking cancellation so finally can release it.
|
|
||||||
if (!isRpcError(resolved)) objectId = resolved;
|
|
||||||
checkFocusAbort(deps.signal);
|
|
||||||
if (isRpcError(resolved)) return resolved;
|
|
||||||
|
|
||||||
const runScript = async <T>(functionDeclaration: string): Promise<T | undefined> => {
|
|
||||||
const reply = await nodeCdp.send<FocusScriptReply<T>>(
|
|
||||||
target.tabId,
|
|
||||||
"Runtime.callFunctionOn",
|
|
||||||
{
|
|
||||||
objectId,
|
|
||||||
functionDeclaration,
|
|
||||||
returnByValue: true,
|
|
||||||
},
|
|
||||||
);
|
|
||||||
checkFocusAbort(deps.signal);
|
|
||||||
if (reply.exceptionDetails) {
|
|
||||||
const details = reply.exceptionDetails;
|
|
||||||
throw new Error(
|
|
||||||
`${action} script failed: ${details.exception?.description ?? details.text ?? "unknown exception"}`,
|
|
||||||
);
|
|
||||||
}
|
|
||||||
return reply.result?.value;
|
|
||||||
};
|
|
||||||
|
|
||||||
let wasFocused: boolean | undefined;
|
|
||||||
if (action === "focus") {
|
|
||||||
await nodeCdp.send(tabId, "DOM.focus", { backendNodeId: node.backendNodeId });
|
|
||||||
checkFocusAbort(deps.signal);
|
|
||||||
} else {
|
|
||||||
const mutation = await runScript<{ ok: boolean; was_focused: boolean }>(BLUR_TARGET);
|
|
||||||
if (typeof mutation?.ok !== "boolean" || typeof mutation.was_focused !== "boolean") {
|
|
||||||
throw new Error("blur script returned an unexpected result");
|
|
||||||
}
|
|
||||||
if (!mutation.ok) {
|
|
||||||
return { code: "invalid_params", message: "target element does not support blur()" };
|
|
||||||
}
|
|
||||||
wasFocused = mutation.was_focused;
|
|
||||||
}
|
|
||||||
// Use a separate call so microtasks from focus/blur handlers finish before
|
|
||||||
// we report success. In particular, a blur handler can restore focus.
|
|
||||||
const focused = await runScript<boolean>(FOCUS_CHECK);
|
|
||||||
if (typeof focused !== "boolean") {
|
|
||||||
throw new Error(`${action} verification returned an unexpected result`);
|
|
||||||
}
|
|
||||||
if (focused !== (action === "focus")) {
|
|
||||||
throw new Error(
|
|
||||||
action === "focus"
|
|
||||||
? "target element did not become focused"
|
|
||||||
: "target element remained focused after blur()",
|
|
||||||
);
|
|
||||||
}
|
|
||||||
return attachDialogs(deps.cdp, tabId, dialogCursor, {
|
|
||||||
tab_id: tabId,
|
|
||||||
used_ref: node.usedRef,
|
|
||||||
used_selector: node.usedSelector,
|
|
||||||
focused,
|
|
||||||
...(action === "blur" ? { was_focused: wasFocused! } : {}),
|
|
||||||
});
|
|
||||||
} catch (err) {
|
|
||||||
return (
|
|
||||||
throwIfAborted(deps.signal) ?? {
|
|
||||||
code: "cdp_failed",
|
|
||||||
message: err instanceof Error ? err.message : String(err),
|
|
||||||
}
|
|
||||||
);
|
|
||||||
} finally {
|
|
||||||
if (objectId !== undefined && cleanupCdp && tabId !== undefined) {
|
|
||||||
// Cleanup must also run after cancellation. Navigation may have already
|
|
||||||
// disposed the object, which must not replace the operation's result.
|
|
||||||
try {
|
|
||||||
await cleanupCdp.send(tabId, "Runtime.releaseObject", { objectId });
|
|
||||||
} catch {
|
|
||||||
// The target or execution context may no longer exist.
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
export async function resolveActionTarget(
|
export async function resolveActionTarget(
|
||||||
cdp: CdpRunner,
|
cdp: CdpRunner,
|
||||||
ctx: SessionContext,
|
ctx: SessionContext,
|
||||||
|
|||||||
@@ -929,7 +929,7 @@ export async function captureVomObservation(
|
|||||||
const notices: string[] = [];
|
const notices: string[] = [];
|
||||||
if (facts.issues.some((issue) => issue.stage === "geometry"))
|
if (facts.issues.some((issue) => issue.stage === "geometry"))
|
||||||
notices.push(
|
notices.push(
|
||||||
"@warning geometry incomplete: some page or frame content has no top-level coordinates.",
|
"@warning iframe geometry incomplete: some frame content has no top-level coordinates.",
|
||||||
);
|
);
|
||||||
const incompleteStages = ["dom", "ax", "forms", "ownership"].filter((stage) =>
|
const incompleteStages = ["dom", "ax", "forms", "ownership"].filter((stage) =>
|
||||||
facts.issues.some((issue) => issue.stage === stage),
|
facts.issues.some((issue) => issue.stage === stage),
|
||||||
@@ -938,18 +938,6 @@ export async function captureVomObservation(
|
|||||||
notices.push(
|
notices.push(
|
||||||
`@warning observation incomplete: some ${incompleteStages.join(", ")} data is unavailable or omitted.`,
|
`@warning observation incomplete: some ${incompleteStages.join(", ")} data is unavailable or omitted.`,
|
||||||
);
|
);
|
||||||
if (
|
|
||||||
facts.issues.some(
|
|
||||||
(issue) => issue.stage === "identity" && issue.reason !== "identity-unverified",
|
|
||||||
)
|
|
||||||
)
|
|
||||||
notices.push(
|
|
||||||
"@warning observation incomplete: some documents were omitted because their identity changed or could not be revalidated.",
|
|
||||||
);
|
|
||||||
if (facts.issues.some((issue) => issue.reason === "identity-unverified"))
|
|
||||||
notices.push(
|
|
||||||
"@warning document identity unverified: some retained documents could not be checked for changes during capture.",
|
|
||||||
);
|
|
||||||
const captureNotice = notices.join("\n");
|
const captureNotice = notices.join("\n");
|
||||||
const rendered = renderVom(decoratedScene, {
|
const rendered = renderVom(decoratedScene, {
|
||||||
maxDepth: options.maxDepth,
|
maxDepth: options.maxDepth,
|
||||||
|
|||||||
@@ -1,142 +0,0 @@
|
|||||||
import { cdpTargetKey } from "@/browser-driver/frame-graph";
|
|
||||||
import type { NodeAddress } from "./frame-geometry";
|
|
||||||
import {
|
|
||||||
clipPolygon,
|
|
||||||
projectRegionToViewport,
|
|
||||||
type Region,
|
|
||||||
rectPolygon,
|
|
||||||
regionBounds,
|
|
||||||
type ViewportRect,
|
|
||||||
} from "./geometry";
|
|
||||||
import { GeometryContext } from "./geometry/frame-context";
|
|
||||||
import { type CdpRunner, sendToCdpTarget } from "./shared";
|
|
||||||
|
|
||||||
// Ask the renderer to apply containing-block clips (including shadow DOM),
|
|
||||||
// instead of treating layout quads as visible pixels. Each document is measured
|
|
||||||
// locally; the existing frame projections supply the top-viewport coordinates.
|
|
||||||
// IntersectionObserver reports a bounding rectangle, not an occlusion/hit test.
|
|
||||||
const VISIBLE_RECT = `function(timeoutMs) {
|
|
||||||
const element = this;
|
|
||||||
const visible = () => element.isConnected && element.checkVisibility({
|
|
||||||
checkOpacity: true, checkVisibilityCSS: true, contentVisibilityAuto: true
|
|
||||||
});
|
|
||||||
if (typeof element.checkVisibility !== 'function' || !visible()) return null;
|
|
||||||
return new Promise((resolve, reject) => {
|
|
||||||
const observer = new IntersectionObserver(([entry]) => {
|
|
||||||
clearTimeout(timer);
|
|
||||||
observer.disconnect();
|
|
||||||
const rect = entry.intersectionRect;
|
|
||||||
resolve(visible() && entry.isIntersecting && rect.width > 0 && rect.height > 0
|
|
||||||
? { x: rect.x, y: rect.y, width: rect.width, height: rect.height }
|
|
||||||
: null);
|
|
||||||
}, { root: element.ownerDocument });
|
|
||||||
const timer = setTimeout(() => {
|
|
||||||
observer.disconnect();
|
|
||||||
reject(new Error('scroll-to visibility measurement timed out'));
|
|
||||||
}, timeoutMs);
|
|
||||||
observer.observe(element);
|
|
||||||
});
|
|
||||||
}`;
|
|
||||||
|
|
||||||
async function visibleRect(
|
|
||||||
cdp: CdpRunner,
|
|
||||||
address: NodeAddress,
|
|
||||||
deadline: number,
|
|
||||||
): Promise<ViewportRect | null> {
|
|
||||||
const resolved = await sendToCdpTarget<{ object?: { objectId?: string } }>(
|
|
||||||
cdp,
|
|
||||||
address.target,
|
|
||||||
"DOM.resolveNode",
|
|
||||||
{ backendNodeId: address.backendNodeId },
|
|
||||||
);
|
|
||||||
if (!resolved.object?.objectId) throw new Error("scroll-to could not resolve the target element");
|
|
||||||
const reply = await sendToCdpTarget<{
|
|
||||||
result?: { value?: ViewportRect | null };
|
|
||||||
exceptionDetails?: { text?: string; exception?: { description?: string } };
|
|
||||||
}>(cdp, address.target, "Runtime.callFunctionOn", {
|
|
||||||
objectId: resolved.object.objectId,
|
|
||||||
functionDeclaration: VISIBLE_RECT,
|
|
||||||
// Bound this read even if a background document stops rendering. Its
|
|
||||||
// observer always disconnects; cancellation cannot leave a live observer.
|
|
||||||
arguments: [{ value: Math.max(1, Math.min(1_000, deadline - Date.now())) }],
|
|
||||||
awaitPromise: true,
|
|
||||||
returnByValue: true,
|
|
||||||
});
|
|
||||||
if (reply.exceptionDetails) {
|
|
||||||
const details = reply.exceptionDetails;
|
|
||||||
throw new Error(details.exception?.description ?? details.text ?? "visibility script failed");
|
|
||||||
}
|
|
||||||
const rect = reply.result?.value;
|
|
||||||
if (rect === null) return null;
|
|
||||||
if (
|
|
||||||
!rect ||
|
|
||||||
![rect.x, rect.y, rect.width, rect.height].every(Number.isFinite) ||
|
|
||||||
rect.width <= 0 ||
|
|
||||||
rect.height <= 0
|
|
||||||
) {
|
|
||||||
throw new Error("scroll-to visibility measurement returned invalid bounds");
|
|
||||||
}
|
|
||||||
return rect;
|
|
||||||
}
|
|
||||||
|
|
||||||
async function projectRect(
|
|
||||||
context: GeometryContext,
|
|
||||||
address: NodeAddress,
|
|
||||||
rect: ViewportRect,
|
|
||||||
): Promise<Region> {
|
|
||||||
let region: Region = [rectPolygon({ x: rect.x, y: rect.y, w: rect.width, h: rect.height })];
|
|
||||||
if (!address.frameId) return region;
|
|
||||||
const frame = await context.frame(address.frameId);
|
|
||||||
if (!frame || cdpTargetKey(frame.target) !== cdpTargetKey(address.target)) {
|
|
||||||
throw new Error("scroll-to frame no longer belongs to its target");
|
|
||||||
}
|
|
||||||
const parent = frame.parentFrameId ? await context.frame(frame.parentFrameId) : undefined;
|
|
||||||
if (parent && cdpTargetKey(parent.target) === cdpTargetKey(frame.target)) {
|
|
||||||
// DOM rectangles are document-local. Same-target iframe quads are already
|
|
||||||
// target-local, so cross this one boundary before the target projection.
|
|
||||||
const viewport = await context.viewport(frame.target);
|
|
||||||
if (frame.ownerBackendNodeId === undefined || !viewport) {
|
|
||||||
throw new Error("scroll-to could not resolve the frame viewport");
|
|
||||||
}
|
|
||||||
const local = await context.snapshotProjection(address, frame.ownerBackendNodeId, [], viewport);
|
|
||||||
if (local.status !== "available") throw new Error("scroll-to could not project the frame");
|
|
||||||
region = projectRegionToViewport(region, local.projection.geometry);
|
|
||||||
}
|
|
||||||
const projection = await context.targetProjection(frame.frameId);
|
|
||||||
if (!projection) throw new Error("scroll-to could not project the target viewport");
|
|
||||||
return projectRegionToViewport(region, projection);
|
|
||||||
}
|
|
||||||
|
|
||||||
/** Only scroll-to needs renderer-clipped bounds; other interaction geometry is unchanged. */
|
|
||||||
export async function scrollVisibleBounds(
|
|
||||||
cdp: CdpRunner,
|
|
||||||
tabId: number,
|
|
||||||
address: NodeAddress,
|
|
||||||
deadline: number,
|
|
||||||
): Promise<ViewportRect | null> {
|
|
||||||
const context = new GeometryContext(cdp, tabId);
|
|
||||||
const rect = await visibleRect(cdp, address, deadline);
|
|
||||||
if (!rect) return null;
|
|
||||||
let region = await projectRect(context, address, rect);
|
|
||||||
if (address.frameId) {
|
|
||||||
const ancestry = await context.ancestry(address.frameId);
|
|
||||||
if (!ancestry) throw new Error("scroll-to could not resolve the frame ancestry");
|
|
||||||
for (const child of ancestry) {
|
|
||||||
const parent = child.parentFrameId ? await context.frame(child.parentFrameId) : undefined;
|
|
||||||
if (!parent || child.ownerBackendNodeId === undefined) {
|
|
||||||
throw new Error("scroll-to could not resolve the frame owner");
|
|
||||||
}
|
|
||||||
const owner = {
|
|
||||||
target: parent.target,
|
|
||||||
frameId: parent.frameId,
|
|
||||||
backendNodeId: child.ownerBackendNodeId,
|
|
||||||
};
|
|
||||||
// A visible child document can still have a hidden or clipped iframe.
|
|
||||||
const ownerRect = await visibleRect(cdp, owner, deadline);
|
|
||||||
if (!ownerRect) return null;
|
|
||||||
const clips = await projectRect(context, owner, ownerRect);
|
|
||||||
region = region.flatMap((polygon) => clips.map((clip) => clipPolygon(polygon, clip)));
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return regionBounds(region);
|
|
||||||
}
|
|
||||||
@@ -1,137 +0,0 @@
|
|||||||
import { ChromiumCdp } from "@/browser-driver/chromium-cdp";
|
|
||||||
import { type CdpTarget, cdpTargetKey } from "@/browser-driver/frame-graph";
|
|
||||||
import type { SessionManager } from "@/session-manager/manager";
|
|
||||||
import type { RpcError, ScrollToParams, ScrollToResult } from "@/transport/types";
|
|
||||||
import { attachDialogs, markDialogCursor } from "./dialogs";
|
|
||||||
import { cdpError, rpcError } from "./errors";
|
|
||||||
import { scrollElementAndFramesIntoView } from "./frame-geometry";
|
|
||||||
import { resolveBackendNode } from "./interaction";
|
|
||||||
import { scrollVisibleBounds } from "./scroll-visibility";
|
|
||||||
import {
|
|
||||||
type CdpRunner,
|
|
||||||
type ChromeTabsApi,
|
|
||||||
chromeTabsApi,
|
|
||||||
enforceAgentWindow,
|
|
||||||
isRpcError,
|
|
||||||
lookupSession,
|
|
||||||
resolveTargetTab,
|
|
||||||
sendToCdpTarget,
|
|
||||||
} from "./shared";
|
|
||||||
|
|
||||||
export interface ScrollToDeps {
|
|
||||||
cdp: CdpRunner;
|
|
||||||
tabsApi: ChromeTabsApi;
|
|
||||||
signal?: AbortSignal;
|
|
||||||
}
|
|
||||||
|
|
||||||
let defaultDeps: { cdp: ChromiumCdp; tabsApi: ChromeTabsApi } | null = null;
|
|
||||||
function getDefaultDeps(): { cdp: ChromiumCdp; tabsApi: ChromeTabsApi } {
|
|
||||||
if (!defaultDeps) defaultDeps = { cdp: new ChromiumCdp(), tabsApi: chromeTabsApi };
|
|
||||||
return defaultDeps;
|
|
||||||
}
|
|
||||||
|
|
||||||
export async function handleScrollTo(
|
|
||||||
manager: SessionManager,
|
|
||||||
params: ScrollToParams,
|
|
||||||
deps: ScrollToDeps = getDefaultDeps(),
|
|
||||||
): Promise<ScrollToResult | RpcError> {
|
|
||||||
const ctxOrErr = lookupSession(manager, params, "scroll-to");
|
|
||||||
if (isRpcError(ctxOrErr)) return ctxOrErr;
|
|
||||||
const ctx = ctxOrErr;
|
|
||||||
const timeout = params.timeout_ms ?? 30_000;
|
|
||||||
if (!Number.isInteger(timeout) || timeout <= 0) {
|
|
||||||
return { code: "invalid_params", message: "timeout_ms must be a positive integer" };
|
|
||||||
}
|
|
||||||
const deadline = Date.now() + timeout;
|
|
||||||
const checkActive = () => {
|
|
||||||
if (deps.signal?.aborted) throw new DOMException("scroll-to aborted", "AbortError");
|
|
||||||
if (Date.now() >= deadline) throw new DOMException("scroll-to timed out", "TimeoutError");
|
|
||||||
};
|
|
||||||
const objectGroup = `bsk-scroll-${crypto.randomUUID()}`;
|
|
||||||
const objectTargets = new Map<string, CdpTarget>();
|
|
||||||
const send = async <T>(target: CdpTarget, method: string, args?: object): Promise<T> => {
|
|
||||||
checkActive();
|
|
||||||
// Also own objects allocated by the shared scroll fallback. Record the
|
|
||||||
// target before awaiting so cancellation cannot skip their cleanup.
|
|
||||||
if (method === "DOM.resolveNode") objectTargets.set(cdpTargetKey(target), target);
|
|
||||||
const result = await sendToCdpTarget<T>(
|
|
||||||
deps.cdp,
|
|
||||||
target,
|
|
||||||
method,
|
|
||||||
method === "DOM.resolveNode" ? { ...args, objectGroup } : args,
|
|
||||||
);
|
|
||||||
checkActive();
|
|
||||||
return result;
|
|
||||||
};
|
|
||||||
let graph: ReturnType<NonNullable<CdpRunner["getFrameGraph"]>> | undefined;
|
|
||||||
const cdp: CdpRunner = {
|
|
||||||
send: (tabId, method, args) => send({ tabId }, method, args),
|
|
||||||
sendToTarget: send,
|
|
||||||
trackSessionTab: deps.cdp.trackSessionTab?.bind(deps.cdp),
|
|
||||||
getFrameGraph: deps.cdp.getFrameGraph
|
|
||||||
? async (tabId) => {
|
|
||||||
checkActive();
|
|
||||||
graph ??= deps.cdp.getFrameGraph!(tabId);
|
|
||||||
const result = await graph;
|
|
||||||
checkActive();
|
|
||||||
return result;
|
|
||||||
}
|
|
||||||
: undefined,
|
|
||||||
};
|
|
||||||
try {
|
|
||||||
checkActive();
|
|
||||||
const target = await resolveTargetTab(manager, ctx, params.tab_id, deps.tabsApi);
|
|
||||||
checkActive();
|
|
||||||
if (isRpcError(target)) return target;
|
|
||||||
const denied = enforceAgentWindow(ctx, target, "scroll-to");
|
|
||||||
if (denied) return denied;
|
|
||||||
const dialogCursor = markDialogCursor(deps.cdp, target.tabId);
|
|
||||||
const node = await resolveBackendNode(cdp, ctx, target, params, "scroll-to");
|
|
||||||
checkActive();
|
|
||||||
if (isRpcError(node)) return node;
|
|
||||||
deps.cdp.trackSessionTab?.(ctx.sessionId, target.tabId);
|
|
||||||
const scrollError = await scrollElementAndFramesIntoView(
|
|
||||||
cdp,
|
|
||||||
target.tabId,
|
|
||||||
node.cdpTarget,
|
|
||||||
node.backendNodeId,
|
|
||||||
node.frameId,
|
|
||||||
);
|
|
||||||
checkActive();
|
|
||||||
if (scrollError) return scrollError;
|
|
||||||
const bounds = await scrollVisibleBounds(
|
|
||||||
cdp,
|
|
||||||
target.tabId,
|
|
||||||
{
|
|
||||||
target: node.cdpTarget,
|
|
||||||
backendNodeId: node.backendNodeId,
|
|
||||||
frameId: node.frameId,
|
|
||||||
},
|
|
||||||
deadline,
|
|
||||||
);
|
|
||||||
checkActive();
|
|
||||||
if (!bounds)
|
|
||||||
return rpcError(
|
|
||||||
"permission_denied",
|
|
||||||
"element_not_visible",
|
|
||||||
"scroll-to target has no visible area",
|
|
||||||
);
|
|
||||||
return attachDialogs(deps.cdp, target.tabId, dialogCursor, {
|
|
||||||
tab_id: target.tabId,
|
|
||||||
used_ref: node.usedRef,
|
|
||||||
used_selector: node.usedSelector,
|
|
||||||
...bounds,
|
|
||||||
});
|
|
||||||
} catch (error) {
|
|
||||||
if (deps.signal?.aborted) return { code: "cancelled", message: "scroll-to aborted" };
|
|
||||||
if (Date.now() >= deadline) return { code: "timeout", message: "scroll-to timed out" };
|
|
||||||
return cdpError(error);
|
|
||||||
} finally {
|
|
||||||
// Cleanup bypasses the cancellation guard and cannot replace the result.
|
|
||||||
for (const target of objectTargets.values()) {
|
|
||||||
await sendToCdpTarget(deps.cdp, target, "Runtime.releaseObjectGroup", { objectGroup }).catch(
|
|
||||||
() => {},
|
|
||||||
);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -55,7 +55,6 @@ export interface CdpRunner {
|
|||||||
sendToTarget?<T = unknown>(target: CdpTarget, method: string, params?: object): Promise<T>;
|
sendToTarget?<T = unknown>(target: CdpTarget, method: string, params?: object): Promise<T>;
|
||||||
detach?(tabId: number): Promise<void>;
|
detach?(tabId: number): Promise<void>;
|
||||||
getFrameGraph?(tabId: number): Promise<CdpFrameGraph>;
|
getFrameGraph?(tabId: number): Promise<CdpFrameGraph>;
|
||||||
getAttachmentId?(tabId: number): string | undefined;
|
|
||||||
ensureAttachedToUrl?(tabId: number, expectedUrl: string | undefined): Promise<void>;
|
ensureAttachedToUrl?(tabId: number, expectedUrl: string | undefined): Promise<void>;
|
||||||
trackSessionTab?(sessionId: string, tabId: number): void;
|
trackSessionTab?(sessionId: string, tabId: number): void;
|
||||||
releaseSessionTab?(sessionId: string, tabId: number): Promise<void>;
|
releaseSessionTab?(sessionId: string, tabId: number): Promise<void>;
|
||||||
|
|||||||
@@ -2,22 +2,13 @@ import { describe, expect, it, vi } from "vitest";
|
|||||||
import type { CdpFrame, CdpTarget } from "@/browser-driver/frame-graph";
|
import type { CdpFrame, CdpTarget } from "@/browser-driver/frame-graph";
|
||||||
import { cdpTargetKey } from "@/browser-driver/frame-graph";
|
import { cdpTargetKey } from "@/browser-driver/frame-graph";
|
||||||
import { OVERLAY_HOST_MARKER_ATTR } from "@/lib/overlay-bridge";
|
import { OVERLAY_HOST_MARKER_ATTR } from "@/lib/overlay-bridge";
|
||||||
import { captureVomObservation } from "../../observation";
|
|
||||||
import type { CdpRunner } from "../../shared";
|
import type { CdpRunner } from "../../shared";
|
||||||
import { captureObservationFacts, semanticCapture } from "../capture-coordinator";
|
import { captureObservationFacts, semanticCapture } from "../capture-coordinator";
|
||||||
import { buildSemanticGraph } from "../semantic-graph/build";
|
import { buildSemanticGraph } from "../semantic-graph/build";
|
||||||
import { REQUESTED_STYLES, type SnapshotReply } from "../snapshot";
|
import { REQUESTED_STYLES } from "../snapshot";
|
||||||
|
|
||||||
function fixture(
|
function fixture(
|
||||||
options: {
|
options: { frames?: CdpFrame[]; fail?: string; omitDocument?: string; overlay?: string } = {},
|
||||||
frames?: CdpFrame[];
|
|
||||||
after?: Record<string, { element?: number; missing?: boolean; unreadable?: boolean }>;
|
|
||||||
fail?: string;
|
|
||||||
missingIdentity?: boolean;
|
|
||||||
omitDocument?: string;
|
|
||||||
attachmentChanged?: boolean;
|
|
||||||
overlay?: string;
|
|
||||||
} = {},
|
|
||||||
) {
|
) {
|
||||||
const frames = options.frames ?? [
|
const frames = options.frames ?? [
|
||||||
{ frameId: "main", target: { tabId: 4 } },
|
{ frameId: "main", target: { tabId: 4 } },
|
||||||
@@ -43,10 +34,7 @@ function fixture(
|
|||||||
const elements = new Map(
|
const elements = new Map(
|
||||||
frames.map((frame, i) => [frame.frameId, frame.target.sessionId ? 1 : i * 10 + 1]),
|
frames.map((frame, i) => [frame.frameId, frame.target.sessionId ? 1 : i * 10 + 1]),
|
||||||
);
|
);
|
||||||
const contexts = new Map(frames.map((frame, i) => [i + 1, frame.frameId]));
|
|
||||||
const logs: Array<{ target: CdpTarget; method: string; params: Record<string, unknown> }> = [];
|
const logs: Array<{ target: CdpTarget; method: string; params: Record<string, unknown> }> = [];
|
||||||
let snapshots = 0;
|
|
||||||
const targetCount = new Set(frames.map((frame) => cdpTargetKey(frame.target))).size;
|
|
||||||
const send = vi.fn(
|
const send = vi.fn(
|
||||||
async <T>(target: CdpTarget, method: string, params: object = {}): Promise<T> => {
|
async <T>(target: CdpTarget, method: string, params: object = {}): Promise<T> => {
|
||||||
logs.push({ target, method, params: params as Record<string, unknown> });
|
logs.push({ target, method, params: params as Record<string, unknown> });
|
||||||
@@ -54,35 +42,9 @@ function fixture(
|
|||||||
if (options.fail === `${target.sessionId ?? "main"}:${method}`)
|
if (options.fail === `${target.sessionId ?? "main"}:${method}`)
|
||||||
throw new Error("fixture failure");
|
throw new Error("fixture failure");
|
||||||
let result: unknown = {};
|
let result: unknown = {};
|
||||||
if (method === "Page.createIsolatedWorld")
|
|
||||||
result = {
|
|
||||||
executionContextId: frames.findIndex((frame) => frame.frameId === args.frameId) + 1,
|
|
||||||
};
|
|
||||||
if (method === "Runtime.evaluate" && args.contextId) {
|
|
||||||
const id = contexts.get(Number(args.contextId))!;
|
|
||||||
const change = options.after?.[id];
|
|
||||||
result =
|
|
||||||
options.missingIdentity || change?.unreadable
|
|
||||||
? {}
|
|
||||||
: {
|
|
||||||
result: {
|
|
||||||
deepSerializedValue: change?.missing
|
|
||||||
? { type: "null" }
|
|
||||||
: {
|
|
||||||
type: "node",
|
|
||||||
value: { backendNodeId: change?.element ?? elements.get(id) },
|
|
||||||
},
|
|
||||||
},
|
|
||||||
};
|
|
||||||
}
|
|
||||||
if (method === "Page.getLayoutMetrics")
|
if (method === "Page.getLayoutMetrics")
|
||||||
result = {
|
result = { cssLayoutViewport: { clientWidth: 1000, clientHeight: 800 } };
|
||||||
visualViewport: { clientWidth: 1000 },
|
|
||||||
cssVisualViewport: { clientWidth: 1000 },
|
|
||||||
cssLayoutViewport: { clientWidth: 1000, clientHeight: 800 },
|
|
||||||
};
|
|
||||||
if (method === "DOMSnapshot.captureSnapshot") {
|
if (method === "DOMSnapshot.captureSnapshot") {
|
||||||
snapshots++;
|
|
||||||
expect((params as { computedStyles: unknown }).computedStyles).toEqual(REQUESTED_STYLES);
|
expect((params as { computedStyles: unknown }).computedStyles).toEqual(REQUESTED_STYLES);
|
||||||
result = {
|
result = {
|
||||||
strings: [
|
strings: [
|
||||||
@@ -112,8 +74,6 @@ function fixture(
|
|||||||
const children = localFrames.filter((f) => f.parentFrameId === frame.frameId);
|
const children = localFrames.filter((f) => f.parentFrameId === frame.frameId);
|
||||||
|
|
||||||
return {
|
return {
|
||||||
scrollOffsetX: 0,
|
|
||||||
scrollOffsetY: 0,
|
|
||||||
frameId: frame.frameId,
|
frameId: frame.frameId,
|
||||||
nodes: {
|
nodes: {
|
||||||
backendNodeId: [
|
backendNodeId: [
|
||||||
@@ -171,12 +131,6 @@ function fixture(
|
|||||||
},
|
},
|
||||||
);
|
);
|
||||||
const cdp: CdpRunner = {
|
const cdp: CdpRunner = {
|
||||||
getAttachmentId: () =>
|
|
||||||
options.missingIdentity
|
|
||||||
? undefined
|
|
||||||
: options.attachmentChanged && snapshots === targetCount
|
|
||||||
? "new-attachment"
|
|
||||||
: "attachment",
|
|
||||||
getFrameGraph: async () => ({ rootFrameId: frames[0].frameId, frames }),
|
getFrameGraph: async () => ({ rootFrameId: frames[0].frameId, frames }),
|
||||||
send: (tabId, method, params) =>
|
send: (tabId, method, params) =>
|
||||||
(send as NonNullable<CdpRunner["sendToTarget"]>)({ tabId }, method, params),
|
(send as NonNullable<CdpRunner["sendToTarget"]>)({ tabId }, method, params),
|
||||||
@@ -186,44 +140,12 @@ function fixture(
|
|||||||
}
|
}
|
||||||
|
|
||||||
describe("captureObservationFacts", () => {
|
describe("captureObservationFacts", () => {
|
||||||
it("normalizes snapshot-owned root scroll instead of mixing in stale CSS scroll", async () => {
|
|
||||||
const { cdp } = fixture({ frames: [{ frameId: "main", target: { tabId: 4 } }] });
|
|
||||||
const original = cdp.sendToTarget!;
|
|
||||||
cdp.sendToTarget = async (target, method, params) => {
|
|
||||||
if (method === "Page.getLayoutMetrics")
|
|
||||||
return {
|
|
||||||
visualViewport: { clientWidth: 2000 },
|
|
||||||
cssVisualViewport: { clientWidth: 1000 },
|
|
||||||
cssLayoutViewport: { clientWidth: 1000, clientHeight: 800, pageX: 999, pageY: 999 },
|
|
||||||
} as never;
|
|
||||||
const reply = await original(target, method, params);
|
|
||||||
if (method === "DOMSnapshot.captureSnapshot") {
|
|
||||||
const doc = (reply as SnapshotReply).documents![0];
|
|
||||||
doc.scrollOffsetX = 40;
|
|
||||||
doc.scrollOffsetY = 200;
|
|
||||||
doc.layout!.bounds![1] = [200, 800, 240, 80];
|
|
||||||
}
|
|
||||||
return reply as never;
|
|
||||||
};
|
|
||||||
cdp.send = (tabId, method, params) => cdp.sendToTarget!({ tabId }, method, params);
|
|
||||||
const facts = await captureObservationFacts(cdp, 4);
|
|
||||||
expect(facts.documents[0].domNodes.find((node) => node.backendNodeId === 2)).toMatchObject({
|
|
||||||
localRect: { x: 80, y: 300, w: 120, h: 40 },
|
|
||||||
rect: { x: 80, y: 300, w: 120, h: 40 },
|
|
||||||
rendered: true,
|
|
||||||
});
|
|
||||||
expect(facts.issues).toEqual([]);
|
|
||||||
});
|
|
||||||
|
|
||||||
it("collects each target once and scopes equal backend IDs", async () => {
|
it("collects each target once and scopes equal backend IDs", async () => {
|
||||||
const { cdp, logs } = fixture();
|
const { cdp, logs } = fixture();
|
||||||
const facts = await captureObservationFacts(cdp, 4);
|
const facts = await captureObservationFacts(cdp, 4);
|
||||||
expect(logs.filter((call) => call.method === "DOMSnapshot.captureSnapshot")).toHaveLength(2);
|
expect(logs.filter((call) => call.method === "DOMSnapshot.captureSnapshot")).toHaveLength(2);
|
||||||
expect(logs.filter((call) => call.method === "Accessibility.enable")).toHaveLength(2);
|
expect(logs.filter((call) => call.method === "Accessibility.enable")).toHaveLength(2);
|
||||||
expect(logs.filter((call) => call.method === "Accessibility.getFullAXTree")).toHaveLength(4);
|
expect(logs.filter((call) => call.method === "Accessibility.getFullAXTree")).toHaveLength(4);
|
||||||
expect(facts.documents.every((doc) => doc.identity)).toBe(true);
|
|
||||||
expect(logs.filter((call) => call.method === "DOM.describeNode")).toHaveLength(0);
|
|
||||||
expect(logs.filter((call) => call.method === "Page.createIsolatedWorld")).toHaveLength(4);
|
|
||||||
const main = facts.documents.find((doc) => doc.frame.frameId === "main")!;
|
const main = facts.documents.find((doc) => doc.frame.frameId === "main")!;
|
||||||
const remote = facts.documents.find((doc) => doc.frame.frameId === "remote")!;
|
const remote = facts.documents.find((doc) => doc.frame.frameId === "remote")!;
|
||||||
expect(main.index.nodes.get(2)).not.toBe(remote.index.nodes.get(2));
|
expect(main.index.nodes.get(2)).not.toBe(remote.index.nodes.get(2));
|
||||||
@@ -234,219 +156,6 @@ describe("captureObservationFacts", () => {
|
|||||||
expect(facts.finishedAt).toBeGreaterThanOrEqual(facts.startedAt);
|
expect(facts.finishedAt).toBeGreaterThanOrEqual(facts.startedAt);
|
||||||
});
|
});
|
||||||
|
|
||||||
it.each([
|
|
||||||
{ element: 99 },
|
|
||||||
{ missing: true },
|
|
||||||
])("isolates changed child identity %j and dependent descendants", async (change) => {
|
|
||||||
const { cdp } = fixture({ after: { same: change } });
|
|
||||||
const facts = await captureObservationFacts(cdp, 4);
|
|
||||||
expect(facts.documents.map((doc) => doc.frame.frameId)).toEqual(["main", "remote"]);
|
|
||||||
expect(facts.issues).toContainEqual(
|
|
||||||
expect.objectContaining({ frameId: "same", reason: "document-changed" }),
|
|
||||||
);
|
|
||||||
});
|
|
||||||
|
|
||||||
it.each([
|
|
||||||
{ after: { main: { element: 99 } } },
|
|
||||||
{ attachmentChanged: true },
|
|
||||||
])("rejects a root replacement or reattachment %j", async (options) => {
|
|
||||||
await expect(captureObservationFacts(fixture(options).cdp, 4)).rejects.toThrow(
|
|
||||||
"document identity",
|
|
||||||
);
|
|
||||||
});
|
|
||||||
|
|
||||||
it.each([
|
|
||||||
"main",
|
|
||||||
"same",
|
|
||||||
])("does not publish a previously identified %s document after identity reads fail", async (frameId) => {
|
|
||||||
const { cdp } = fixture({ after: { [frameId]: { unreadable: true } } });
|
|
||||||
if (frameId === "main")
|
|
||||||
await expect(captureObservationFacts(cdp, 4)).rejects.toThrow("document identity");
|
|
||||||
else {
|
|
||||||
const facts = await captureObservationFacts(cdp, 4);
|
|
||||||
expect(facts.documents.map((doc) => doc.frame.frameId)).toEqual(["main", "remote"]);
|
|
||||||
expect(facts.issues).toContainEqual(
|
|
||||||
expect.objectContaining({ frameId, reason: "identity-unavailable" }),
|
|
||||||
);
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
it("validates newly discovered snapshot documents without a pre-snapshot identity read", async () => {
|
|
||||||
const { cdp, logs } = fixture();
|
|
||||||
const graph = await cdp.getFrameGraph!(4);
|
|
||||||
cdp.getFrameGraph = async () => ({ ...graph, frames: graph.frames.slice(0, 1) });
|
|
||||||
const facts = await captureObservationFacts(cdp, 4);
|
|
||||||
expect(facts.documents.map((doc) => doc.frame.frameId)).toEqual(["main", "same", "nested"]);
|
|
||||||
expect(facts.documents.every((doc) => doc.identity)).toBe(true);
|
|
||||||
expect(logs.filter((call) => call.method === "Page.createIsolatedWorld")).toHaveLength(3);
|
|
||||||
expect(logs.findIndex((call) => call.method === "Page.createIsolatedWorld")).toBeGreaterThan(
|
|
||||||
logs.findIndex((call) => call.method === "Accessibility.getFullAXTree"),
|
|
||||||
);
|
|
||||||
});
|
|
||||||
|
|
||||||
it("rejects a snapshot root that no longer matches the current frame root", async () => {
|
|
||||||
const { cdp } = fixture();
|
|
||||||
const original = cdp.sendToTarget!;
|
|
||||||
cdp.sendToTarget = async (target, method, params) => {
|
|
||||||
const result = await original(target, method, params);
|
|
||||||
if (method === "DOMSnapshot.captureSnapshot" && !target.sessionId) {
|
|
||||||
const snapshot = result as {
|
|
||||||
documents: { frameId: string; nodes: { backendNodeId: number[] } }[];
|
|
||||||
};
|
|
||||||
snapshot.documents[0].nodes.backendNodeId[2] = 999;
|
|
||||||
}
|
|
||||||
return result as never;
|
|
||||||
};
|
|
||||||
cdp.send = (tabId, method, params) => cdp.sendToTarget!({ tabId }, method, params);
|
|
||||||
await expect(captureObservationFacts(cdp, 4)).rejects.toThrow("document identity");
|
|
||||||
});
|
|
||||||
|
|
||||||
it("starts after-identity reads only after every target finishes and propagates cancellation during identity cleanup", async () => {
|
|
||||||
const { cdp, logs } = fixture();
|
|
||||||
const controller = new AbortController();
|
|
||||||
const original = cdp.sendToTarget!;
|
|
||||||
let identityCleanup = 0;
|
|
||||||
cdp.sendToTarget = async (target, method, params) => {
|
|
||||||
if (method === "Page.createIsolatedWorld") {
|
|
||||||
expect(logs.filter((call) => call.method === "Accessibility.getFullAXTree")).toHaveLength(
|
|
||||||
4,
|
|
||||||
);
|
|
||||||
}
|
|
||||||
const result = await original(target, method, params);
|
|
||||||
if (
|
|
||||||
method === "Runtime.releaseObjectGroup" &&
|
|
||||||
String((params as { objectGroup?: string })?.objectGroup).startsWith(
|
|
||||||
"bsk-document-identity-",
|
|
||||||
) &&
|
|
||||||
target.sessionId === "remote"
|
|
||||||
) {
|
|
||||||
if (++identityCleanup === 1) controller.abort();
|
|
||||||
}
|
|
||||||
return result as never;
|
|
||||||
};
|
|
||||||
cdp.send = (tabId, method, params) => cdp.sendToTarget!({ tabId }, method, params);
|
|
||||||
await expect(captureObservationFacts(cdp, 4, controller.signal)).rejects.toMatchObject({
|
|
||||||
name: "AbortError",
|
|
||||||
});
|
|
||||||
expect(identityCleanup).toBe(1);
|
|
||||||
});
|
|
||||||
|
|
||||||
it.each([
|
|
||||||
1, 10, 100,
|
|
||||||
])("bounds identity reads for %i same-target documents after snapshot and AX collection", async (count) => {
|
|
||||||
const frames: CdpFrame[] = Array.from({ length: count }, (_, i) => ({
|
|
||||||
frameId: `frame-${i}`,
|
|
||||||
target: { tabId: 4 },
|
|
||||||
...(i ? { parentFrameId: "frame-0", ownerBackendNodeId: 90000 + i } : {}),
|
|
||||||
}));
|
|
||||||
const { cdp, logs } = fixture({ frames });
|
|
||||||
const original = cdp.sendToTarget!;
|
|
||||||
let active = 0;
|
|
||||||
let peak = 0;
|
|
||||||
let released = 0;
|
|
||||||
cdp.sendToTarget = async (target, method, params) => {
|
|
||||||
if (method === "Page.createIsolatedWorld") {
|
|
||||||
peak = Math.max(peak, ++active);
|
|
||||||
await new Promise((resolve) => setTimeout(resolve, 1));
|
|
||||||
}
|
|
||||||
if (method === "DOMSnapshot.captureSnapshot") {
|
|
||||||
expect(active).toBe(0);
|
|
||||||
expect(released).toBe(0);
|
|
||||||
}
|
|
||||||
if (method === "Page.createIsolatedWorld") {
|
|
||||||
expect(logs.filter((call) => call.method === "Accessibility.getFullAXTree")).toHaveLength(
|
|
||||||
count,
|
|
||||||
);
|
|
||||||
}
|
|
||||||
const result = await original(target, method, params);
|
|
||||||
if (
|
|
||||||
method === "Runtime.releaseObjectGroup" &&
|
|
||||||
String((params as { objectGroup?: string })?.objectGroup).startsWith(
|
|
||||||
"bsk-document-identity-",
|
|
||||||
)
|
|
||||||
) {
|
|
||||||
active--;
|
|
||||||
released++;
|
|
||||||
}
|
|
||||||
return result as never;
|
|
||||||
};
|
|
||||||
cdp.send = (tabId, method, params) => cdp.sendToTarget!({ tabId }, method, params);
|
|
||||||
const facts = await captureObservationFacts(cdp, 4);
|
|
||||||
expect(facts.documents.every((doc) => doc.identity)).toBe(true);
|
|
||||||
expect(peak).toBe(Math.min(count, 4));
|
|
||||||
expect(active).toBe(0);
|
|
||||||
expect(released).toBe(count);
|
|
||||||
for (const method of [
|
|
||||||
"Page.createIsolatedWorld",
|
|
||||||
"Runtime.evaluate",
|
|
||||||
"Runtime.releaseObjectGroup",
|
|
||||||
])
|
|
||||||
expect(logs.filter((call) => call.method === method)).toHaveLength(count);
|
|
||||||
expect(logs.filter((call) => call.method === "DOMSnapshot.captureSnapshot")).toHaveLength(1);
|
|
||||||
expect(logs.filter((call) => call.method === "Page.getFrameTree")).toHaveLength(0);
|
|
||||||
});
|
|
||||||
|
|
||||||
it("joins identity cleanup on cancellation without starting queued frames", async () => {
|
|
||||||
const frames: CdpFrame[] = Array.from({ length: 5 }, (_, i) => ({
|
|
||||||
frameId: `frame-${i}`,
|
|
||||||
target: { tabId: 4 },
|
|
||||||
...(i ? { parentFrameId: "frame-0", ownerBackendNodeId: 90000 + i } : {}),
|
|
||||||
}));
|
|
||||||
const { cdp, logs } = fixture({ frames });
|
|
||||||
const original = cdp.sendToTarget!;
|
|
||||||
const controller = new AbortController();
|
|
||||||
let release!: () => void;
|
|
||||||
const gate = new Promise<void>((resolve) => {
|
|
||||||
release = resolve;
|
|
||||||
});
|
|
||||||
let ready!: () => void;
|
|
||||||
const blocked = new Promise<void>((resolve) => {
|
|
||||||
ready = resolve;
|
|
||||||
});
|
|
||||||
let held = 0;
|
|
||||||
cdp.sendToTarget = async (target, method, params) => {
|
|
||||||
const result = await original(target, method, params);
|
|
||||||
if (
|
|
||||||
method === "Runtime.releaseObjectGroup" &&
|
|
||||||
String((params as { objectGroup?: string })?.objectGroup).startsWith(
|
|
||||||
"bsk-document-identity-",
|
|
||||||
)
|
|
||||||
) {
|
|
||||||
if (++held === 4) ready();
|
|
||||||
await gate;
|
|
||||||
}
|
|
||||||
return result as never;
|
|
||||||
};
|
|
||||||
cdp.send = (tabId, method, params) => cdp.sendToTarget!({ tabId }, method, params);
|
|
||||||
let settled = false;
|
|
||||||
const pending = captureObservationFacts(cdp, 4, controller.signal).finally(() => {
|
|
||||||
settled = true;
|
|
||||||
});
|
|
||||||
const rejected = expect(pending).rejects.toMatchObject({ name: "AbortError" });
|
|
||||||
await blocked;
|
|
||||||
controller.abort();
|
|
||||||
await Promise.resolve();
|
|
||||||
expect(settled).toBe(false);
|
|
||||||
release();
|
|
||||||
await rejected;
|
|
||||||
expect(held).toBe(4);
|
|
||||||
expect(logs.filter((call) => call.method === "Page.createIsolatedWorld")).toHaveLength(4);
|
|
||||||
});
|
|
||||||
|
|
||||||
it.each([
|
|
||||||
[{ after: { same: { element: 99 } } }, "omitted", false],
|
|
||||||
[{ after: { same: { unreadable: true } } }, "omitted", false],
|
|
||||||
[{ missingIdentity: true }, "document identity unverified", true],
|
|
||||||
[{}, "", true],
|
|
||||||
] as const)("publishes identity integrity without silently losing content %j", async (options, notice, retained) => {
|
|
||||||
const { cdp } = fixture(options);
|
|
||||||
const result = await captureVomObservation(cdp, 4, "https://example.com");
|
|
||||||
expect(result.frames.some((frame) => frame.frameId === "same")).toBe(retained);
|
|
||||||
if (notice) expect(result.text).toContain(notice);
|
|
||||||
else expect(result.text).not.toContain("identity");
|
|
||||||
if (!retained) expect(result.text).not.toContain("document identity unverified");
|
|
||||||
});
|
|
||||||
|
|
||||||
it("does not retry failed or missing documents and retains valid AX-only semantics", async () => {
|
it("does not retry failed or missing documents and retains valid AX-only semantics", async () => {
|
||||||
const { cdp, logs } = fixture({
|
const { cdp, logs } = fixture({
|
||||||
fail: "remote:DOMSnapshot.captureSnapshot",
|
fail: "remote:DOMSnapshot.captureSnapshot",
|
||||||
@@ -465,12 +174,6 @@ describe("captureObservationFacts", () => {
|
|||||||
);
|
);
|
||||||
});
|
});
|
||||||
|
|
||||||
it("keeps missing identity explicit without manufacturing a verified document", async () => {
|
|
||||||
const facts = await captureObservationFacts(fixture({ missingIdentity: true }).cdp, 4);
|
|
||||||
expect(facts.documents.every((doc) => !doc.identity)).toBe(true);
|
|
||||||
expect(facts.issues.filter((issue) => issue.reason === "identity-unverified")).toHaveLength(4);
|
|
||||||
});
|
|
||||||
|
|
||||||
it("excludes overlay AX in its own document without excluding equal IDs elsewhere", async () => {
|
it("excludes overlay AX in its own document without excluding equal IDs elsewhere", async () => {
|
||||||
const facts = await captureObservationFacts(fixture({ overlay: "remote" }).cdp, 4);
|
const facts = await captureObservationFacts(fixture({ overlay: "remote" }).cdp, 4);
|
||||||
const { documents } = semanticCapture(facts);
|
const { documents } = semanticCapture(facts);
|
||||||
@@ -626,8 +329,6 @@ function childSnapshot(frameId: string, backendNodeId: number) {
|
|||||||
strings,
|
strings,
|
||||||
documents: [
|
documents: [
|
||||||
{
|
{
|
||||||
scrollOffsetX: 0,
|
|
||||||
scrollOffsetY: 0,
|
|
||||||
frameId,
|
frameId,
|
||||||
nodes: {
|
nodes: {
|
||||||
parentIndex: [-1, 0],
|
parentIndex: [-1, 0],
|
||||||
@@ -655,13 +356,8 @@ function childSnapshot(frameId: string, backendNodeId: number) {
|
|||||||
describe("OOPIF capture", () => {
|
describe("OOPIF capture", () => {
|
||||||
it("captures and positions multiple OOPIF documents missing from the root snapshot", async () => {
|
it("captures and positions multiple OOPIF documents missing from the root snapshot", async () => {
|
||||||
const sendToTarget = vi.fn(async (target, method) => {
|
const sendToTarget = vi.fn(async (target, method) => {
|
||||||
if (method === "Runtime.evaluate") return { result: { value: { width: 300, height: 200 } } };
|
|
||||||
if (method === "Page.getLayoutMetrics") {
|
if (method === "Page.getLayoutMetrics") {
|
||||||
return {
|
return { cssLayoutViewport: { clientWidth: 300, clientHeight: 200, pageX: 0, pageY: 0 } };
|
||||||
visualViewport: { clientWidth: 1000 },
|
|
||||||
cssVisualViewport: { clientWidth: 1000 },
|
|
||||||
cssLayoutViewport: { clientWidth: 300, clientHeight: 200, pageX: 0, pageY: 0 },
|
|
||||||
};
|
|
||||||
}
|
}
|
||||||
if (method === "DOMSnapshot.enable" || method === "Accessibility.enable") return {};
|
if (method === "DOMSnapshot.enable" || method === "Accessibility.enable") return {};
|
||||||
if (method === "DOMSnapshot.captureSnapshot") {
|
if (method === "DOMSnapshot.captureSnapshot") {
|
||||||
@@ -683,11 +379,7 @@ describe("OOPIF capture", () => {
|
|||||||
return { model: { content: [x, 100, x + 300, 100, x + 300, 300, x, 300] } };
|
return { model: { content: [x, 100, x + 300, 100, x + 300, 300, x, 300] } };
|
||||||
}
|
}
|
||||||
if (method === "Page.getLayoutMetrics") {
|
if (method === "Page.getLayoutMetrics") {
|
||||||
return {
|
return { cssLayoutViewport: { clientWidth: 1000, clientHeight: 800 } };
|
||||||
visualViewport: { clientWidth: 1000 },
|
|
||||||
cssVisualViewport: { clientWidth: 1000 },
|
|
||||||
cssLayoutViewport: { clientWidth: 1000, clientHeight: 800 },
|
|
||||||
};
|
|
||||||
}
|
}
|
||||||
throw new Error(`unexpected root ${method}`);
|
throw new Error(`unexpected root ${method}`);
|
||||||
}) as CdpRunner["send"],
|
}) as CdpRunner["send"],
|
||||||
@@ -765,11 +457,7 @@ describe("OOPIF capture", () => {
|
|||||||
};
|
};
|
||||||
const reply = async (_target: unknown, method: string) => {
|
const reply = async (_target: unknown, method: string) => {
|
||||||
if (method === "Page.getLayoutMetrics")
|
if (method === "Page.getLayoutMetrics")
|
||||||
return {
|
return { cssLayoutViewport: { clientWidth: 300, clientHeight: 200 } };
|
||||||
visualViewport: { clientWidth: 1000 },
|
|
||||||
cssVisualViewport: { clientWidth: 1000 },
|
|
||||||
cssLayoutViewport: { clientWidth: 300, clientHeight: 200 },
|
|
||||||
};
|
|
||||||
if (method === "DOMSnapshot.captureSnapshot")
|
if (method === "DOMSnapshot.captureSnapshot")
|
||||||
return typeof _target === "number" ? childSnapshot("main", 11) : snapshot;
|
return typeof _target === "number" ? childSnapshot("main", 11) : snapshot;
|
||||||
if (method === "DOM.getBoxModel")
|
if (method === "DOM.getBoxModel")
|
||||||
@@ -827,11 +515,7 @@ describe("OOPIF capture", () => {
|
|||||||
if (method === "Accessibility.getFullAXTree") return { nodes: [] };
|
if (method === "Accessibility.getFullAXTree") return { nodes: [] };
|
||||||
if (method === "DOM.getBoxModel") throw new Error("owner geometry unavailable");
|
if (method === "DOM.getBoxModel") throw new Error("owner geometry unavailable");
|
||||||
if (method === "Page.getLayoutMetrics") {
|
if (method === "Page.getLayoutMetrics") {
|
||||||
return {
|
return { cssLayoutViewport: { clientWidth: 1000, clientHeight: 800 } };
|
||||||
visualViewport: { clientWidth: 1000 },
|
|
||||||
cssVisualViewport: { clientWidth: 1000 },
|
|
||||||
cssLayoutViewport: { clientWidth: 1000, clientHeight: 800 },
|
|
||||||
};
|
|
||||||
}
|
}
|
||||||
throw new Error(`unexpected root ${method}`);
|
throw new Error(`unexpected root ${method}`);
|
||||||
}) as CdpRunner["send"],
|
}) as CdpRunner["send"],
|
||||||
@@ -874,7 +558,7 @@ describe("OOPIF capture", () => {
|
|||||||
expect.objectContaining({ backendDOMNodeId: 101, frameId: "child" }),
|
expect.objectContaining({ backendDOMNodeId: 101, frameId: "child" }),
|
||||||
]);
|
]);
|
||||||
expect(childDocument?.domNodes.find((node) => node.backendNodeId === 101)).toEqual(
|
expect(childDocument?.domNodes.find((node) => node.backendNodeId === 101)).toEqual(
|
||||||
expect.objectContaining({ rect: null, localRect: null, rendered: true }),
|
expect.objectContaining({ rect: null, localRect: { x: 10, y: 20, w: 100, h: 40 } }),
|
||||||
);
|
);
|
||||||
});
|
});
|
||||||
});
|
});
|
||||||
@@ -884,8 +568,6 @@ function siblingCaptureFixture(
|
|||||||
beforeReply: (method: string, params: Record<string, unknown>) => Promise<void> = async () => {},
|
beforeReply: (method: string, params: Record<string, unknown>) => Promise<void> = async () => {},
|
||||||
) {
|
) {
|
||||||
const document = (id: number, owners: number[], childIndexes: number[]) => ({
|
const document = (id: number, owners: number[], childIndexes: number[]) => ({
|
||||||
scrollOffsetX: 0,
|
|
||||||
scrollOffsetY: 0,
|
|
||||||
frameId: `frame-${id}`,
|
frameId: `frame-${id}`,
|
||||||
nodes: {
|
nodes: {
|
||||||
parentIndex: [-1, ...owners.map(() => 0)],
|
parentIndex: [-1, ...owners.map(() => 0)],
|
||||||
@@ -917,11 +599,7 @@ function siblingCaptureFixture(
|
|||||||
await beforeReply(method, args);
|
await beforeReply(method, args);
|
||||||
if (method === "DOMSnapshot.captureSnapshot") return snapshot;
|
if (method === "DOMSnapshot.captureSnapshot") return snapshot;
|
||||||
if (method === "Page.getLayoutMetrics")
|
if (method === "Page.getLayoutMetrics")
|
||||||
return {
|
return { cssLayoutViewport: { clientWidth: 1000, clientHeight: 800 } };
|
||||||
visualViewport: { clientWidth: 1000 },
|
|
||||||
cssVisualViewport: { clientWidth: 1000 },
|
|
||||||
cssLayoutViewport: { clientWidth: 1000, clientHeight: 800 },
|
|
||||||
};
|
|
||||||
if (method === "DOM.getBoxModel")
|
if (method === "DOM.getBoxModel")
|
||||||
return { model: { content: [0, 0, 200, 0, 200, 100, 0, 100] } };
|
return { model: { content: [0, 0, 200, 0, 200, 100, 0, 100] } };
|
||||||
if (method === "DOM.resolveNode") return { object: { objectId: String(args.backendNodeId) } };
|
if (method === "DOM.resolveNode") return { object: { objectId: String(args.backendNodeId) } };
|
||||||
@@ -1125,11 +803,7 @@ describe("snapshot document provenance", () => {
|
|||||||
(method === "DOMSnapshot.captureSnapshot"
|
(method === "DOMSnapshot.captureSnapshot"
|
||||||
? { ...f.snapshot, documents: [f.snapshot.documents[1]] }
|
? { ...f.snapshot, documents: [f.snapshot.documents[1]] }
|
||||||
: method === "Page.getLayoutMetrics"
|
: method === "Page.getLayoutMetrics"
|
||||||
? {
|
? { cssLayoutViewport: { clientWidth: 200, clientHeight: 100 } }
|
||||||
visualViewport: { clientWidth: 1000 },
|
|
||||||
cssVisualViewport: { clientWidth: 1000 },
|
|
||||||
cssLayoutViewport: { clientWidth: 200, clientHeight: 100 },
|
|
||||||
}
|
|
||||||
: {}) as T,
|
: {}) as T,
|
||||||
};
|
};
|
||||||
const facts = await captureObservationFacts(cdp, 4);
|
const facts = await captureObservationFacts(cdp, 4);
|
||||||
@@ -1169,7 +843,7 @@ describe("sibling frame measurement scheduling", () => {
|
|||||||
return original(tabId, method, params);
|
return original(tabId, method, params);
|
||||||
};
|
};
|
||||||
const captured = await captureObservationFacts(fixture.cdp, 4);
|
const captured = await captureObservationFacts(fixture.cdp, 4);
|
||||||
expect(captured.issues.filter((issue) => issue.stage === "geometry")).toEqual([]);
|
expect(captured.issues).toEqual([]);
|
||||||
expect(captured.documents.map((doc) => doc.frame.frameId)).toEqual(
|
expect(captured.documents.map((doc) => doc.frame.frameId)).toEqual(
|
||||||
Array.from({ length: 8 }, (_, i) => `frame-${i}`),
|
Array.from({ length: 8 }, (_, i) => `frame-${i}`),
|
||||||
);
|
);
|
||||||
|
|||||||
@@ -215,11 +215,7 @@ function makeCdp(snapshot: unknown) {
|
|||||||
if (method === "DOMSnapshot.enable") return {};
|
if (method === "DOMSnapshot.enable") return {};
|
||||||
if (method === "DOMSnapshot.captureSnapshot") return snapshot;
|
if (method === "DOMSnapshot.captureSnapshot") return snapshot;
|
||||||
if (method === "Page.getLayoutMetrics") {
|
if (method === "Page.getLayoutMetrics") {
|
||||||
return {
|
return { cssLayoutViewport: { clientWidth: 1000, clientHeight: 800, pageX: 0, pageY: 0 } };
|
||||||
visualViewport: { clientWidth: 1000 },
|
|
||||||
cssVisualViewport: { clientWidth: 1000 },
|
|
||||||
cssLayoutViewport: { clientWidth: 1000, clientHeight: 800, pageX: 0, pageY: 0 },
|
|
||||||
};
|
|
||||||
}
|
}
|
||||||
if (method === "Runtime.evaluate") {
|
if (method === "Runtime.evaluate") {
|
||||||
return {
|
return {
|
||||||
@@ -281,8 +277,6 @@ describe("snapshot capture and hover", () => {
|
|||||||
if (method === "DOMSnapshot.captureSnapshot") return hoverTriggerSnapshotReply();
|
if (method === "DOMSnapshot.captureSnapshot") return hoverTriggerSnapshotReply();
|
||||||
if (method === "Page.getLayoutMetrics") {
|
if (method === "Page.getLayoutMetrics") {
|
||||||
return {
|
return {
|
||||||
visualViewport: { clientWidth: 1000 },
|
|
||||||
cssVisualViewport: { clientWidth: 1000 },
|
|
||||||
cssLayoutViewport: { clientWidth: 1000, clientHeight: 800, pageX: 0, pageY: 0 },
|
cssLayoutViewport: { clientWidth: 1000, clientHeight: 800, pageX: 0, pageY: 0 },
|
||||||
};
|
};
|
||||||
}
|
}
|
||||||
@@ -346,8 +340,6 @@ describe("snapshot capture and hover", () => {
|
|||||||
if (method === "DOMSnapshot.captureSnapshot") return twoHoverTriggerSnapshotReply();
|
if (method === "DOMSnapshot.captureSnapshot") return twoHoverTriggerSnapshotReply();
|
||||||
if (method === "Page.getLayoutMetrics") {
|
if (method === "Page.getLayoutMetrics") {
|
||||||
return {
|
return {
|
||||||
visualViewport: { clientWidth: 1000 },
|
|
||||||
cssVisualViewport: { clientWidth: 1000 },
|
|
||||||
cssLayoutViewport: { clientWidth: 1000, clientHeight: 800, pageX: 0, pageY: 0 },
|
cssLayoutViewport: { clientWidth: 1000, clientHeight: 800, pageX: 0, pageY: 0 },
|
||||||
};
|
};
|
||||||
}
|
}
|
||||||
@@ -396,8 +388,6 @@ describe("snapshot capture and hover", () => {
|
|||||||
if (method === "DOMSnapshot.captureSnapshot") return nestedHoverTriggerSnapshotReply();
|
if (method === "DOMSnapshot.captureSnapshot") return nestedHoverTriggerSnapshotReply();
|
||||||
if (method === "Page.getLayoutMetrics") {
|
if (method === "Page.getLayoutMetrics") {
|
||||||
return {
|
return {
|
||||||
visualViewport: { clientWidth: 1000 },
|
|
||||||
cssVisualViewport: { clientWidth: 1000 },
|
|
||||||
cssLayoutViewport: { clientWidth: 1000, clientHeight: 800, pageX: 0, pageY: 0 },
|
cssLayoutViewport: { clientWidth: 1000, clientHeight: 800, pageX: 0, pageY: 0 },
|
||||||
};
|
};
|
||||||
}
|
}
|
||||||
@@ -743,8 +733,6 @@ describe("snapshot capture and hover", () => {
|
|||||||
if (method === "DOMSnapshot.captureSnapshot") return fakeSnapshotReply();
|
if (method === "DOMSnapshot.captureSnapshot") return fakeSnapshotReply();
|
||||||
if (method === "Page.getLayoutMetrics") {
|
if (method === "Page.getLayoutMetrics") {
|
||||||
return {
|
return {
|
||||||
visualViewport: { clientWidth: 1000 },
|
|
||||||
cssVisualViewport: { clientWidth: 1000 },
|
|
||||||
cssLayoutViewport: { clientWidth: 1000, clientHeight: 800, pageX: 0, pageY: 200 },
|
cssLayoutViewport: { clientWidth: 1000, clientHeight: 800, pageX: 0, pageY: 200 },
|
||||||
};
|
};
|
||||||
}
|
}
|
||||||
@@ -757,7 +745,7 @@ describe("snapshot capture and hover", () => {
|
|||||||
expect(div?.rect).toMatchObject({ y: 0, h: 600 });
|
expect(div?.rect).toMatchObject({ y: 0, h: 600 });
|
||||||
});
|
});
|
||||||
|
|
||||||
it("normalizes raw snapshot bounds before viewport clipping", async () => {
|
it("keeps CSS snapshot bounds independent of legacy metrics ratio", async () => {
|
||||||
const S = ["html", "body", "div", "position", "fixed", "static", "pointer-events", "auto"];
|
const S = ["html", "body", "div", "position", "fixed", "static", "pointer-events", "auto"];
|
||||||
const i = (s: string) => S.indexOf(s);
|
const i = (s: string) => S.indexOf(s);
|
||||||
const snapshot = {
|
const snapshot = {
|
||||||
@@ -792,8 +780,6 @@ describe("snapshot capture and hover", () => {
|
|||||||
if (method === "DOMSnapshot.captureSnapshot") return snapshot;
|
if (method === "DOMSnapshot.captureSnapshot") return snapshot;
|
||||||
if (method === "Page.getLayoutMetrics") {
|
if (method === "Page.getLayoutMetrics") {
|
||||||
return {
|
return {
|
||||||
visualViewport: { clientWidth: 2000 },
|
|
||||||
cssVisualViewport: { clientWidth: 1000 },
|
|
||||||
cssLayoutViewport: { clientWidth: 1000, clientHeight: 800, pageX: 0, pageY: 0 },
|
cssLayoutViewport: { clientWidth: 1000, clientHeight: 800, pageX: 0, pageY: 0 },
|
||||||
layoutViewport: { clientWidth: 2000, clientHeight: 1600 },
|
layoutViewport: { clientWidth: 2000, clientHeight: 1600 },
|
||||||
};
|
};
|
||||||
@@ -811,8 +797,8 @@ describe("snapshot capture and hover", () => {
|
|||||||
expect(nodes.find((n) => n.backendNodeId === 12)?.localRect).toEqual({
|
expect(nodes.find((n) => n.backendNodeId === 12)?.localRect).toEqual({
|
||||||
x: 0,
|
x: 0,
|
||||||
y: 0,
|
y: 0,
|
||||||
w: 1000,
|
w: 2000,
|
||||||
h: 800,
|
h: 1600,
|
||||||
});
|
});
|
||||||
});
|
});
|
||||||
|
|
||||||
@@ -870,8 +856,6 @@ describe("snapshot capture and hover", () => {
|
|||||||
if (method === "DOMSnapshot.captureSnapshot") return snapshot;
|
if (method === "DOMSnapshot.captureSnapshot") return snapshot;
|
||||||
if (method === "Page.getLayoutMetrics") {
|
if (method === "Page.getLayoutMetrics") {
|
||||||
return {
|
return {
|
||||||
visualViewport: { clientWidth: 1000 },
|
|
||||||
cssVisualViewport: { clientWidth: 1000 },
|
|
||||||
cssLayoutViewport: { clientWidth: 1000, clientHeight: 800, pageX: 0, pageY: 0 },
|
cssLayoutViewport: { clientWidth: 1000, clientHeight: 800, pageX: 0, pageY: 0 },
|
||||||
};
|
};
|
||||||
}
|
}
|
||||||
@@ -962,8 +946,6 @@ describe("snapshot capture and hover", () => {
|
|||||||
if (method === "DOMSnapshot.captureSnapshot") return snapshot;
|
if (method === "DOMSnapshot.captureSnapshot") return snapshot;
|
||||||
if (method === "Page.getLayoutMetrics") {
|
if (method === "Page.getLayoutMetrics") {
|
||||||
return {
|
return {
|
||||||
visualViewport: { clientWidth: 1000 },
|
|
||||||
cssVisualViewport: { clientWidth: 1000 },
|
|
||||||
cssLayoutViewport: { clientWidth: 1000, clientHeight: 800, pageX: 0, pageY: 0 },
|
cssLayoutViewport: { clientWidth: 1000, clientHeight: 800, pageX: 0, pageY: 0 },
|
||||||
};
|
};
|
||||||
}
|
}
|
||||||
@@ -1053,8 +1035,6 @@ describe("snapshot capture and hover", () => {
|
|||||||
if (method === "DOMSnapshot.captureSnapshot") return snapshot;
|
if (method === "DOMSnapshot.captureSnapshot") return snapshot;
|
||||||
if (method === "Page.getLayoutMetrics") {
|
if (method === "Page.getLayoutMetrics") {
|
||||||
return {
|
return {
|
||||||
visualViewport: { clientWidth: 1000 },
|
|
||||||
cssVisualViewport: { clientWidth: 1000 },
|
|
||||||
cssLayoutViewport: { clientWidth: 1000, clientHeight: 800, pageX: 0, pageY: 0 },
|
cssLayoutViewport: { clientWidth: 1000, clientHeight: 800, pageX: 0, pageY: 0 },
|
||||||
};
|
};
|
||||||
}
|
}
|
||||||
@@ -1117,8 +1097,6 @@ describe("snapshot capture and hover", () => {
|
|||||||
},
|
},
|
||||||
},
|
},
|
||||||
{
|
{
|
||||||
scrollOffsetX: 0,
|
|
||||||
scrollOffsetY: 0,
|
|
||||||
frameId: "child",
|
frameId: "child",
|
||||||
nodes: {
|
nodes: {
|
||||||
parentIndex: [-1, 0, 1],
|
parentIndex: [-1, 0, 1],
|
||||||
@@ -1141,8 +1119,6 @@ describe("snapshot capture and hover", () => {
|
|||||||
},
|
},
|
||||||
},
|
},
|
||||||
{
|
{
|
||||||
scrollOffsetX: 0,
|
|
||||||
scrollOffsetY: 0,
|
|
||||||
frameId: "nested",
|
frameId: "nested",
|
||||||
nodes: {
|
nodes: {
|
||||||
parentIndex: [-1, 0],
|
parentIndex: [-1, 0],
|
||||||
@@ -1170,8 +1146,6 @@ describe("snapshot capture and hover", () => {
|
|||||||
if (method === "DOMSnapshot.captureSnapshot") return snapshot;
|
if (method === "DOMSnapshot.captureSnapshot") return snapshot;
|
||||||
if (method === "Page.getLayoutMetrics") {
|
if (method === "Page.getLayoutMetrics") {
|
||||||
return {
|
return {
|
||||||
visualViewport: { clientWidth: 1000 },
|
|
||||||
cssVisualViewport: { clientWidth: 1000 },
|
|
||||||
cssLayoutViewport: { clientWidth: 1000, clientHeight: 800, pageX: 0, pageY: 0 },
|
cssLayoutViewport: { clientWidth: 1000, clientHeight: 800, pageX: 0, pageY: 0 },
|
||||||
};
|
};
|
||||||
}
|
}
|
||||||
@@ -1251,8 +1225,6 @@ describe("snapshot capture and hover", () => {
|
|||||||
if (method === "DOMSnapshot.captureSnapshot") return snapshot;
|
if (method === "DOMSnapshot.captureSnapshot") return snapshot;
|
||||||
if (method === "Page.getLayoutMetrics") {
|
if (method === "Page.getLayoutMetrics") {
|
||||||
return {
|
return {
|
||||||
visualViewport: { clientWidth: 2000 },
|
|
||||||
cssVisualViewport: { clientWidth: 1000 },
|
|
||||||
cssLayoutViewport: { clientWidth: 1000, clientHeight: 800, pageX: 0, pageY: 100 },
|
cssLayoutViewport: { clientWidth: 1000, clientHeight: 800, pageX: 0, pageY: 100 },
|
||||||
layoutViewport: { clientWidth: 2000, clientHeight: 1600 },
|
layoutViewport: { clientWidth: 2000, clientHeight: 1600 },
|
||||||
};
|
};
|
||||||
@@ -1261,7 +1233,7 @@ describe("snapshot capture and hover", () => {
|
|||||||
}) as unknown as <T>(tabId: number, method: string, params?: object) => Promise<T>,
|
}) as unknown as <T>(tabId: number, method: string, params?: object) => Promise<T>,
|
||||||
};
|
};
|
||||||
const { nodes } = semanticCapture(await captureObservationFacts(cdp, 4)).captured;
|
const { nodes } = semanticCapture(await captureObservationFacts(cdp, 4)).captured;
|
||||||
expect(nodes.find((n) => n.backendNodeId === 12)?.rect?.y).toBe(400 / 2 - 100);
|
expect(nodes.find((n) => n.backendNodeId === 12)?.rect?.y).toBe(400 - 100);
|
||||||
});
|
});
|
||||||
|
|
||||||
it("collectOverlayExcludedBackendIds walks the pierced overlay host subtree", async () => {
|
it("collectOverlayExcludedBackendIds walks the pierced overlay host subtree", async () => {
|
||||||
|
|||||||
@@ -77,7 +77,7 @@ describe("document facts", () => {
|
|||||||
);
|
);
|
||||||
expect(nodes[0].attrs).toEqual({ "aria-hidden": "true", inert: "" });
|
expect(nodes[0].attrs).toEqual({ "aria-hidden": "true", inert: "" });
|
||||||
expect(nodes[0].layout).toEqual({
|
expect(nodes[0].layout).toEqual({
|
||||||
boundsSpace: "snapshot-document-layout",
|
boundsSpace: "snapshot-document-css",
|
||||||
bounds: [10, 20, 120, 40],
|
bounds: [10, 20, 120, 40],
|
||||||
styles: {
|
styles: {
|
||||||
position: "static",
|
position: "static",
|
||||||
|
|||||||
@@ -11,8 +11,7 @@ import {
|
|||||||
isAbortError as isCaptureAbort,
|
isAbortError as isCaptureAbort,
|
||||||
throwIfAborted as throwCaptureAborted,
|
throwIfAborted as throwCaptureAborted,
|
||||||
} from "./capture-abort";
|
} from "./capture-abort";
|
||||||
import { verifyDocumentIdentity } from "./document-identity";
|
import type { CapturedSceneInput } from "./facts";
|
||||||
import type { CapturedSceneInput, DocumentIdentity } from "./facts";
|
|
||||||
import { buildDocumentIndex, type CaptureIssue, type ObservationFacts } from "./facts";
|
import { buildDocumentIndex, type CaptureIssue, type ObservationFacts } from "./facts";
|
||||||
import { enrichFormControlStates } from "./form-capture";
|
import { enrichFormControlStates } from "./form-capture";
|
||||||
import {
|
import {
|
||||||
@@ -27,7 +26,6 @@ import { describeSnapshotFrames, REQUESTED_STYLES, type SnapshotReply } from "./
|
|||||||
interface TargetBatch<T extends FrameOwnedAxNode> {
|
interface TargetBatch<T extends FrameOwnedAxNode> {
|
||||||
target: CdpTarget;
|
target: CdpTarget;
|
||||||
frames: CdpFrame[];
|
frames: CdpFrame[];
|
||||||
snapshotAttachmentId?: string;
|
|
||||||
documents: NormalizedFrameDocument[];
|
documents: NormalizedFrameDocument[];
|
||||||
ax: FrameAxBatch<T>[];
|
ax: FrameAxBatch<T>[];
|
||||||
fallbackExcluded: Set<number>;
|
fallbackExcluded: Set<number>;
|
||||||
@@ -123,7 +121,6 @@ export async function captureObservationFacts<T extends FrameOwnedAxNode>(
|
|||||||
throwCaptureAborted(signal);
|
throwCaptureAborted(signal);
|
||||||
await scoped.send(tabId, "DOMSnapshot.enable", {});
|
await scoped.send(tabId, "DOMSnapshot.enable", {});
|
||||||
throwCaptureAborted(signal);
|
throwCaptureAborted(signal);
|
||||||
batch.snapshotAttachmentId = cdp.getAttachmentId?.(tabId);
|
|
||||||
const snapshot = await scoped.send<SnapshotReply>(tabId, "DOMSnapshot.captureSnapshot", {
|
const snapshot = await scoped.send<SnapshotReply>(tabId, "DOMSnapshot.captureSnapshot", {
|
||||||
computedStyles: REQUESTED_STYLES,
|
computedStyles: REQUESTED_STYLES,
|
||||||
includePaintOrder: true,
|
includePaintOrder: true,
|
||||||
@@ -249,53 +246,6 @@ export async function captureObservationFacts<T extends FrameOwnedAxNode>(
|
|||||||
const rootBatch = batches.find((batch) => !batch.target.sessionId);
|
const rootBatch = batches.find((batch) => !batch.target.sessionId);
|
||||||
const rootFrameId =
|
const rootFrameId =
|
||||||
rootBatch?.rootFrameId ?? graph?.rootFrameId ?? rootBatch?.frames[0]?.frameId ?? "root";
|
rootBatch?.rootFrameId ?? graph?.rootFrameId ?? rootBatch?.frames[0]?.frameId ?? "root";
|
||||||
const ownershipInvalid = new Set(invalid);
|
|
||||||
const identities = new Map<string, DocumentIdentity>();
|
|
||||||
const selected = new Map(currentFrames.map((frame) => [frame.frameId, frame]));
|
|
||||||
const checks = batches.flatMap((batch) => {
|
|
||||||
const docs = new Map(batch.documents.map((doc) => [doc.frame.frameId, doc]));
|
|
||||||
return batch.frames
|
|
||||||
.filter(
|
|
||||||
(frame) =>
|
|
||||||
!invalid.has(frame.frameId) &&
|
|
||||||
cdpTargetKey(selected.get(frame.frameId)!.target) === cdpTargetKey(batch.target),
|
|
||||||
)
|
|
||||||
.map((frame) => ({ batch, frame, doc: docs.get(frame.frameId) }));
|
|
||||||
});
|
|
||||||
await collectTasks(
|
|
||||||
checks,
|
|
||||||
async ({ batch, frame, doc }) => {
|
|
||||||
throwCaptureAborted(signal);
|
|
||||||
if (!batch.snapshotAttachmentId || doc?.documentElementBackendNodeId === undefined) {
|
|
||||||
issues.push({
|
|
||||||
target: frame.target,
|
|
||||||
frameId: frame.frameId,
|
|
||||||
stage: "identity",
|
|
||||||
reason: "identity-unverified",
|
|
||||||
});
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
const identity: DocumentIdentity = {
|
|
||||||
attachmentId: batch.snapshotAttachmentId,
|
|
||||||
target: frame.target,
|
|
||||||
frameId: frame.frameId,
|
|
||||||
documentElementBackendNodeId: doc.documentElementBackendNodeId,
|
|
||||||
};
|
|
||||||
const verified = await verifyDocumentIdentity(cdp, identity, signal);
|
|
||||||
const status = cdp.getAttachmentId?.(tabId) === identity.attachmentId ? verified : "changed";
|
|
||||||
if (status === "current") identities.set(frame.frameId, identity);
|
|
||||||
else {
|
|
||||||
invalid.add(frame.frameId);
|
|
||||||
issues.push({
|
|
||||||
target: frame.target,
|
|
||||||
frameId: frame.frameId,
|
|
||||||
stage: "identity",
|
|
||||||
reason: status === "changed" ? "document-changed" : "identity-unavailable",
|
|
||||||
});
|
|
||||||
}
|
|
||||||
},
|
|
||||||
signal,
|
|
||||||
);
|
|
||||||
const children = new Map<string, string[]>();
|
const children = new Map<string, string[]>();
|
||||||
for (const frame of currentFrames) {
|
for (const frame of currentFrames) {
|
||||||
if (!frame.parentFrameId) continue;
|
if (!frame.parentFrameId) continue;
|
||||||
@@ -313,7 +263,7 @@ export async function captureObservationFacts<T extends FrameOwnedAxNode>(
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
for (const frame of currentFrames) {
|
for (const frame of currentFrames) {
|
||||||
if (ownershipInvalid.has(frame.frameId))
|
if (invalid.has(frame.frameId))
|
||||||
issues.push({
|
issues.push({
|
||||||
target: frame.target,
|
target: frame.target,
|
||||||
frameId: frame.frameId,
|
frameId: frame.frameId,
|
||||||
@@ -321,12 +271,7 @@ export async function captureObservationFacts<T extends FrameOwnedAxNode>(
|
|||||||
reason: "frame-ownership-unresolved",
|
reason: "frame-ownership-unresolved",
|
||||||
});
|
});
|
||||||
}
|
}
|
||||||
if (invalid.has(rootFrameId))
|
if (invalid.has(rootFrameId)) throw new Error("observation root document ownership is ambiguous");
|
||||||
throw new Error(
|
|
||||||
ownershipInvalid.has(rootFrameId)
|
|
||||||
? "observation root document ownership is ambiguous"
|
|
||||||
: "observation document identity changed or could not be verified; observe again",
|
|
||||||
);
|
|
||||||
const frames = currentFrames.filter((frame) => !invalid.has(frame.frameId));
|
const frames = currentFrames.filter((frame) => !invalid.has(frame.frameId));
|
||||||
const frameById = new Map(frames.map((frame) => [frame.frameId, frame]));
|
const frameById = new Map(frames.map((frame) => [frame.frameId, frame]));
|
||||||
const belongs = (frame: CdpFrame) => {
|
const belongs = (frame: CdpFrame) => {
|
||||||
@@ -374,7 +319,6 @@ export async function captureObservationFacts<T extends FrameOwnedAxNode>(
|
|||||||
} = document;
|
} = document;
|
||||||
facts.push({
|
facts.push({
|
||||||
frame,
|
frame,
|
||||||
identity: identities.get(document.frameId),
|
|
||||||
index: fallback?.size ? { ...index, excludedBackendNodeIds: fallback } : index,
|
index: fallback?.size ? { ...index, excludedBackendNodeIds: fallback } : index,
|
||||||
domNodes,
|
domNodes,
|
||||||
axNodes,
|
axNodes,
|
||||||
|
|||||||
@@ -1,53 +0,0 @@
|
|||||||
import type { CdpRunner } from "../shared";
|
|
||||||
import { sendToCdpTarget } from "../shared";
|
|
||||||
import { isAbortError, throwIfAborted } from "./capture-abort";
|
|
||||||
import type { DocumentIdentity } from "./facts";
|
|
||||||
|
|
||||||
/** Compare the snapshot root with the current root in that exact frame.
|
|
||||||
* Deep serialization supplies the backend ID without a separate describeNode. */
|
|
||||||
export async function verifyDocumentIdentity(
|
|
||||||
cdp: CdpRunner,
|
|
||||||
identity: DocumentIdentity,
|
|
||||||
signal?: AbortSignal,
|
|
||||||
): Promise<"current" | "changed" | "unavailable"> {
|
|
||||||
const attached = () => cdp.getAttachmentId?.(identity.target.tabId) === identity.attachmentId;
|
|
||||||
throwIfAborted(signal);
|
|
||||||
if (!attached()) return "changed";
|
|
||||||
const objectGroup = `bsk-document-identity-${crypto.randomUUID()}`;
|
|
||||||
const send = <T>(method: string, params: object) => {
|
|
||||||
throwIfAborted(signal);
|
|
||||||
return sendToCdpTarget<T>(cdp, identity.target, method, params);
|
|
||||||
};
|
|
||||||
try {
|
|
||||||
const world = await send<{ executionContextId: number }>("Page.createIsolatedWorld", {
|
|
||||||
frameId: identity.frameId,
|
|
||||||
worldName: "bsk-document-identity",
|
|
||||||
});
|
|
||||||
const reply = await send<{
|
|
||||||
result?: { deepSerializedValue?: { type: string; value?: { backendNodeId?: number } } };
|
|
||||||
}>("Runtime.evaluate", {
|
|
||||||
expression: "document.documentElement",
|
|
||||||
contextId: world.executionContextId,
|
|
||||||
objectGroup,
|
|
||||||
serializationOptions: {
|
|
||||||
serialization: "deep",
|
|
||||||
additionalParameters: { maxNodeDepth: 0, includeShadowTree: "none" },
|
|
||||||
},
|
|
||||||
});
|
|
||||||
if (!attached()) return "changed";
|
|
||||||
const root = reply.result?.deepSerializedValue;
|
|
||||||
if (root?.type === "null") return "changed";
|
|
||||||
const id = root?.type === "node" ? root.value?.backendNodeId : undefined;
|
|
||||||
if (id === undefined) return "unavailable";
|
|
||||||
return id === identity.documentElementBackendNodeId ? "current" : "changed";
|
|
||||||
} catch (error) {
|
|
||||||
throwIfAborted(signal);
|
|
||||||
if (isAbortError(error)) throw error;
|
|
||||||
return attached() ? "unavailable" : "changed";
|
|
||||||
} finally {
|
|
||||||
await sendToCdpTarget(cdp, identity.target, "Runtime.releaseObjectGroup", {
|
|
||||||
objectGroup,
|
|
||||||
}).catch(() => {});
|
|
||||||
throwIfAborted(signal);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -6,9 +6,9 @@ import { createCaptureCheckpoint } from "./capture-abort";
|
|||||||
import type { CapturedNode } from "./capture-types";
|
import type { CapturedNode } from "./capture-types";
|
||||||
import type { FrameOwnedAxNode } from "./frame-document";
|
import type { FrameOwnedAxNode } from "./frame-document";
|
||||||
|
|
||||||
/** Bounds retain their raw snapshot document layout units until normalization. */
|
/** Bounds retain their snapshot document CSS units until normalization. */
|
||||||
export interface SnapshotLayout {
|
export interface SnapshotLayout {
|
||||||
readonly boundsSpace: "snapshot-document-layout";
|
readonly boundsSpace: "snapshot-document-css";
|
||||||
bounds?: number[];
|
bounds?: number[];
|
||||||
styles: Readonly<Record<string, string>>;
|
styles: Readonly<Record<string, string>>;
|
||||||
}
|
}
|
||||||
@@ -97,13 +97,6 @@ export async function buildDocumentIndex<T extends DecodedNode>(
|
|||||||
return { nodes, excludedBackendNodeIds };
|
return { nodes, excludedBackendNodeIds };
|
||||||
}
|
}
|
||||||
|
|
||||||
export interface DocumentIdentity {
|
|
||||||
attachmentId: string;
|
|
||||||
target: CdpTarget;
|
|
||||||
frameId: string;
|
|
||||||
documentElementBackendNodeId: number;
|
|
||||||
}
|
|
||||||
|
|
||||||
/** Narrow input shared by the existing semantic scene/hover consumers. */
|
/** Narrow input shared by the existing semantic scene/hover consumers. */
|
||||||
export interface CapturedSceneInput {
|
export interface CapturedSceneInput {
|
||||||
nodes: CapturedNode[];
|
nodes: CapturedNode[];
|
||||||
@@ -117,19 +110,12 @@ export interface CaptureIssue {
|
|||||||
projectionIssue?: FrameProjectionIssue;
|
projectionIssue?: FrameProjectionIssue;
|
||||||
target: CdpTarget;
|
target: CdpTarget;
|
||||||
frameId?: string;
|
frameId?: string;
|
||||||
stage: "dom" | "ax" | "identity" | "ownership" | "geometry" | "forms";
|
stage: "dom" | "ax" | "ownership" | "geometry" | "forms";
|
||||||
reason:
|
reason: "capture-unavailable" | "frame-ownership-unresolved" | "geometry-unavailable";
|
||||||
| "document-changed"
|
|
||||||
| "identity-unavailable"
|
|
||||||
| "identity-unverified"
|
|
||||||
| "capture-unavailable"
|
|
||||||
| "frame-ownership-unresolved"
|
|
||||||
| "geometry-unavailable";
|
|
||||||
}
|
}
|
||||||
|
|
||||||
export interface DocumentFacts<T extends FrameOwnedAxNode> {
|
export interface DocumentFacts<T extends FrameOwnedAxNode> {
|
||||||
readonly frame: CdpFrame;
|
readonly frame: CdpFrame;
|
||||||
readonly identity?: DocumentIdentity;
|
|
||||||
readonly index: DocumentIndex;
|
readonly index: DocumentIndex;
|
||||||
readonly domNodes: CapturedNode[];
|
readonly domNodes: CapturedNode[];
|
||||||
readonly axNodes: T[];
|
readonly axNodes: T[];
|
||||||
|
|||||||
@@ -4,15 +4,9 @@ import { type GeometryProjection, projectRectToViewport } from "../geometry";
|
|||||||
import {
|
import {
|
||||||
type FrameProjectionState,
|
type FrameProjectionState,
|
||||||
projectSnapshotRect,
|
projectSnapshotRect,
|
||||||
type SnapshotCoordinates,
|
|
||||||
snapshotCoordinates,
|
|
||||||
snapshotViewportRect,
|
snapshotViewportRect,
|
||||||
} from "../geometry/coordinate-types";
|
} from "../geometry/coordinate-types";
|
||||||
import {
|
import { cssViewport, GeometryContext } from "../geometry/frame-context";
|
||||||
GeometryContext,
|
|
||||||
type LayoutMetrics,
|
|
||||||
snapshotLayoutScale,
|
|
||||||
} from "../geometry/frame-context";
|
|
||||||
import {
|
import {
|
||||||
createCaptureCheckpoint,
|
createCaptureCheckpoint,
|
||||||
isAbortError as isCaptureAbort,
|
isAbortError as isCaptureAbort,
|
||||||
@@ -32,13 +26,13 @@ export interface FrameContext {
|
|||||||
projection: FrameProjectionState | null;
|
projection: FrameProjectionState | null;
|
||||||
targetProjection?: GeometryProjection | null;
|
targetProjection?: GeometryProjection | null;
|
||||||
target: CdpTarget;
|
target: CdpTarget;
|
||||||
coordinates: SnapshotCoordinates | null;
|
scrollX: number;
|
||||||
|
scrollY: number;
|
||||||
}
|
}
|
||||||
|
|
||||||
export interface NormalizedDocument {
|
export interface NormalizedDocument {
|
||||||
nodes: NodeFacts[];
|
nodes: NodeFacts[];
|
||||||
index: DocumentIndex;
|
index: DocumentIndex;
|
||||||
documentElementBackendNodeId?: number;
|
|
||||||
}
|
}
|
||||||
|
|
||||||
/** Interpret one document using a supplied projection. No live reads or frame scheduling. */
|
/** Interpret one document using a supplied projection. No live reads or frame scheduling. */
|
||||||
@@ -57,11 +51,10 @@ export async function normalizeDocument(
|
|||||||
if (pending) await pending;
|
if (pending) await pending;
|
||||||
}
|
}
|
||||||
const node = decoded.nodes[i];
|
const node = decoded.nodes[i];
|
||||||
const bounds = node.layout?.bounds ?? [];
|
|
||||||
const input = snapshotViewportRect(
|
const input = snapshotViewportRect(
|
||||||
bounds,
|
node.layout?.bounds ?? [],
|
||||||
{ target: context.target, frameId: context.frameId },
|
{ target: context.target, frameId: context.frameId },
|
||||||
context.coordinates,
|
{ x: context.scrollX, y: context.scrollY },
|
||||||
);
|
);
|
||||||
const local = input?.rect;
|
const local = input?.rect;
|
||||||
let rect =
|
let rect =
|
||||||
@@ -84,10 +77,7 @@ export async function normalizeDocument(
|
|||||||
localRect: local ? { x: local.x, y: local.y, w: local.width, h: local.height } : null,
|
localRect: local ? { x: local.x, y: local.y, w: local.width, h: local.height } : null,
|
||||||
rect: rect ? { x: rect.x, y: rect.y, w: rect.width, h: rect.height } : null,
|
rect: rect ? { x: rect.x, y: rect.y, w: rect.width, h: rect.height } : null,
|
||||||
rendered:
|
rendered:
|
||||||
bounds.length >= 4 &&
|
!!local &&
|
||||||
bounds.slice(0, 4).every(Number.isFinite) &&
|
|
||||||
bounds[2] > 0 &&
|
|
||||||
bounds[3] > 0 &&
|
|
||||||
visibility !== "hidden" &&
|
visibility !== "hidden" &&
|
||||||
visibility !== "collapse" &&
|
visibility !== "collapse" &&
|
||||||
(Number.parseFloat(opacity) || 0) > 0,
|
(Number.parseFloat(opacity) || 0) > 0,
|
||||||
@@ -99,12 +89,6 @@ export async function normalizeDocument(
|
|||||||
(node) => !node.tag.startsWith("#") && !index.excludedBackendNodeIds.has(node.backendNodeId),
|
(node) => !node.tag.startsWith("#") && !index.excludedBackendNodeIds.has(node.backendNodeId),
|
||||||
),
|
),
|
||||||
index,
|
index,
|
||||||
documentElementBackendNodeId: nodes.find(
|
|
||||||
(node) =>
|
|
||||||
node.nodeType === 1 &&
|
|
||||||
node.parentBackendNodeId !== null &&
|
|
||||||
index.nodes.get(node.parentBackendNodeId)?.nodeType === 9,
|
|
||||||
)?.backendNodeId,
|
|
||||||
};
|
};
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -148,20 +132,17 @@ export async function normalizeSnapshot(
|
|||||||
}
|
}
|
||||||
sources.set(id, doc);
|
sources.set(id, doc);
|
||||||
}
|
}
|
||||||
let metrics: LayoutMetrics = {};
|
let viewport: Viewport = { width: 0, height: 0 };
|
||||||
|
let scrollX = 0,
|
||||||
|
scrollY = 0;
|
||||||
try {
|
try {
|
||||||
metrics = await geometry.layoutMetrics(target);
|
const measured = cssViewport(await geometry.layoutMetrics(target));
|
||||||
|
viewport = { width: measured.width, height: measured.height };
|
||||||
|
scrollX = measured.scrollX;
|
||||||
|
scrollY = measured.scrollY;
|
||||||
} catch (error) {
|
} catch (error) {
|
||||||
if (isCaptureAbort(error)) throw error;
|
if (isCaptureAbort(error)) throw error;
|
||||||
}
|
}
|
||||||
const viewport: Viewport = {
|
|
||||||
width: metrics.cssLayoutViewport?.clientWidth ?? 0,
|
|
||||||
height: metrics.cssLayoutViewport?.clientHeight ?? 0,
|
|
||||||
};
|
|
||||||
const layoutUnitsPerCssPixel = snapshotLayoutScale(metrics);
|
|
||||||
const viewportAvailable = [viewport.width, viewport.height].every(
|
|
||||||
(size) => Number.isFinite(size) && size > 0,
|
|
||||||
);
|
|
||||||
|
|
||||||
const children = new Map<string, CdpFrame[]>();
|
const children = new Map<string, CdpFrame[]>();
|
||||||
const pending: CdpFrame[] = [];
|
const pending: CdpFrame[] = [];
|
||||||
@@ -207,24 +188,12 @@ export async function normalizeSnapshot(
|
|||||||
const doc = sources.get(frame.frameId);
|
const doc = sources.get(frame.frameId);
|
||||||
if (!doc) continue;
|
if (!doc) continue;
|
||||||
const source = { target, frameId: frame.frameId };
|
const source = { target, frameId: frame.frameId };
|
||||||
const coordinates = snapshotCoordinates(
|
const state: FrameProjectionState | null =
|
||||||
doc,
|
|
||||||
layoutUnitsPerCssPixel,
|
|
||||||
frame.frameId === rootFrameId
|
frame.frameId === rootFrameId
|
||||||
? { x: metrics.cssLayoutViewport?.pageX, y: metrics.cssLayoutViewport?.pageY }
|
? {
|
||||||
: undefined,
|
status: "available",
|
||||||
);
|
projection: { source, geometry: { sourceClips: [], edges: [], topViewport: viewport } },
|
||||||
let state: FrameProjectionState | null =
|
}
|
||||||
frame.frameId === rootFrameId
|
|
||||||
? viewportAvailable && coordinates
|
|
||||||
? {
|
|
||||||
status: "available",
|
|
||||||
projection: {
|
|
||||||
source,
|
|
||||||
geometry: { sourceClips: [], edges: [], topViewport: viewport },
|
|
||||||
},
|
|
||||||
}
|
|
||||||
: { status: "unavailable", source, reason: "snapshot-coordinates-unavailable" }
|
|
||||||
: (projections.get(frame.frameId) ?? null);
|
: (projections.get(frame.frameId) ?? null);
|
||||||
if (!state && frame.frameId !== rootFrameId)
|
if (!state && frame.frameId !== rootFrameId)
|
||||||
issues.push({
|
issues.push({
|
||||||
@@ -233,8 +202,6 @@ export async function normalizeSnapshot(
|
|||||||
stage: "ownership",
|
stage: "ownership",
|
||||||
reason: "frame-ownership-unresolved",
|
reason: "frame-ownership-unresolved",
|
||||||
});
|
});
|
||||||
if (!coordinates && (!state || state.status === "available"))
|
|
||||||
state = { status: "unavailable", source, reason: "snapshot-coordinates-unavailable" };
|
|
||||||
projections.set(frame.frameId, state);
|
projections.set(frame.frameId, state);
|
||||||
const projection = state?.status === "available" ? state.projection : null;
|
const projection = state?.status === "available" ? state.projection : null;
|
||||||
if (!projection || (target.sessionId && !targetProjection))
|
if (!projection || (target.sessionId && !targetProjection))
|
||||||
@@ -279,14 +246,6 @@ export async function normalizeSnapshot(
|
|||||||
projections.set(child.frameId, null);
|
projections.set(child.frameId, null);
|
||||||
continue;
|
continue;
|
||||||
}
|
}
|
||||||
if (!snapshotCoordinates(sources.get(child.frameId)!, layoutUnitsPerCssPixel)) {
|
|
||||||
projections.set(child.frameId, {
|
|
||||||
status: "unavailable",
|
|
||||||
source: childSource,
|
|
||||||
reason: "snapshot-coordinates-unavailable",
|
|
||||||
});
|
|
||||||
continue;
|
|
||||||
}
|
|
||||||
try {
|
try {
|
||||||
projections.set(
|
projections.set(
|
||||||
child.frameId,
|
child.frameId,
|
||||||
@@ -315,7 +274,8 @@ export async function normalizeSnapshot(
|
|||||||
projection: state,
|
projection: state,
|
||||||
target,
|
target,
|
||||||
...(target.sessionId ? { targetProjection } : {}),
|
...(target.sessionId ? { targetProjection } : {}),
|
||||||
coordinates,
|
scrollX: doc.scrollOffsetX ?? (frame.frameId === rootFrameId ? scrollX : 0),
|
||||||
|
scrollY: doc.scrollOffsetY ?? (frame.frameId === rootFrameId ? scrollY : 0),
|
||||||
},
|
},
|
||||||
signal,
|
signal,
|
||||||
);
|
);
|
||||||
|
|||||||
@@ -175,7 +175,7 @@ export async function decodeDocument(
|
|||||||
li === undefined
|
li === undefined
|
||||||
? undefined
|
? undefined
|
||||||
: {
|
: {
|
||||||
boundsSpace: "snapshot-document-layout" as const,
|
boundsSpace: "snapshot-document-css" as const,
|
||||||
bounds: dl?.bounds?.[li],
|
bounds: dl?.bounds?.[li],
|
||||||
styles,
|
styles,
|
||||||
};
|
};
|
||||||
|
|||||||
@@ -470,59 +470,6 @@ export interface HoverResult {
|
|||||||
dialogs?: JavaScriptDialogInfo[];
|
dialogs?: JavaScriptDialogInfo[];
|
||||||
}
|
}
|
||||||
|
|
||||||
export interface ScrollToParams {
|
|
||||||
session_id: string;
|
|
||||||
ref?: string;
|
|
||||||
selector?: string;
|
|
||||||
tab_id?: number;
|
|
||||||
timeout_ms?: number;
|
|
||||||
}
|
|
||||||
|
|
||||||
export interface ScrollToResult {
|
|
||||||
tab_id: number;
|
|
||||||
used_ref?: string;
|
|
||||||
used_selector?: string;
|
|
||||||
/** Clipped border-box bounds in top-level viewport CSS pixels; not an occlusion test. */
|
|
||||||
x: number;
|
|
||||||
y: number;
|
|
||||||
width: number;
|
|
||||||
height: number;
|
|
||||||
dialogs?: JavaScriptDialogInfo[];
|
|
||||||
}
|
|
||||||
|
|
||||||
export interface FocusParams {
|
|
||||||
session_id: string;
|
|
||||||
ref?: string;
|
|
||||||
selector?: string;
|
|
||||||
tab_id?: number;
|
|
||||||
timeout_ms?: number;
|
|
||||||
}
|
|
||||||
|
|
||||||
export interface FocusResult {
|
|
||||||
tab_id: number;
|
|
||||||
used_ref?: string;
|
|
||||||
used_selector?: string;
|
|
||||||
focused: boolean;
|
|
||||||
dialogs?: JavaScriptDialogInfo[];
|
|
||||||
}
|
|
||||||
|
|
||||||
export interface BlurParams {
|
|
||||||
session_id: string;
|
|
||||||
ref?: string;
|
|
||||||
selector?: string;
|
|
||||||
tab_id?: number;
|
|
||||||
timeout_ms?: number;
|
|
||||||
}
|
|
||||||
|
|
||||||
export interface BlurResult {
|
|
||||||
tab_id: number;
|
|
||||||
used_ref?: string;
|
|
||||||
used_selector?: string;
|
|
||||||
was_focused: boolean;
|
|
||||||
focused: boolean;
|
|
||||||
dialogs?: JavaScriptDialogInfo[];
|
|
||||||
}
|
|
||||||
|
|
||||||
export interface FillParams {
|
export interface FillParams {
|
||||||
session_id: string;
|
session_id: string;
|
||||||
value: string;
|
value: string;
|
||||||
|
|||||||
@@ -55,20 +55,10 @@ Use this default loop:
|
|||||||
```text
|
```text
|
||||||
bsk navigate <url> --session <id>
|
bsk navigate <url> --session <id>
|
||||||
bsk observe --session <id>
|
bsk observe --session <id>
|
||||||
bsk click|hover|scroll-to|focus|blur|fill|select|press ... --session <id>
|
bsk click|hover|fill|select|press ... --session <id>
|
||||||
bsk observe --session <id> # after navigation or a meaningful DOM change
|
bsk observe --session <id> # after navigation or a meaningful DOM change
|
||||||
```
|
```
|
||||||
|
|
||||||
`bsk scroll-to <ref-or-selector> --session <id>` scrolls an element and its frame owners into view.
|
|
||||||
Use a fresh element ref for iframe/shadow-root targets; CSS selectors search the main document.
|
|
||||||
The result is the visible border-box portion's bounds in top-level viewport CSS pixels after
|
|
||||||
ancestor clipping. Partial visibility is enough; hidden or fully clipped targets fail with
|
|
||||||
`permission_denied` and `data.reason=element_not_visible`. This does not test occlusion by other elements.
|
|
||||||
For a specific tab or deadline: `bsk scroll-to @e3 --session <id> --tab-id 42 --timeout 5s`.
|
|
||||||
|
|
||||||
`bsk focus <ref>` explicitly focuses a target; `bsk blur <ref>` removes focus and reports whether
|
|
||||||
it was focused. Use these for UI states triggered by focus changes.
|
|
||||||
|
|
||||||
Prefer fresh `@eN` refs over CSS selectors. Navigation invalidates refs; large DOM changes may also
|
Prefer fresh `@eN` refs over CSS selectors. Navigation invalidates refs; large DOM changes may also
|
||||||
make them stale. Observe again before the next interaction.
|
make them stale. Observe again before the next interaction.
|
||||||
|
|
||||||
@@ -124,7 +114,7 @@ This list of names is complete. Never invent a command outside it; read
|
|||||||
session start|stop|list browsers status doctor update logs
|
session start|stop|list browsers status doctor update logs
|
||||||
navigate navigate-back navigate-forward reload wait-for-navigation wait-ms
|
navigate navigate-back navigate-forward reload wait-for-navigation wait-ms
|
||||||
observe snapshot get-html screenshot console network
|
observe snapshot get-html screenshot console network
|
||||||
click hover scroll-to focus blur fill select press evaluate
|
click hover fill select press evaluate
|
||||||
tab list|create|close|select|borrow|return window resize emulate
|
tab list|create|close|select|borrow|return window resize emulate
|
||||||
upload download request-help record start|stop
|
upload download request-help record start|stop
|
||||||
```
|
```
|
||||||
|
|||||||
@@ -1,5 +1,4 @@
|
|||||||
//! `bsk click` / `bsk focus` / `bsk blur` / `bsk fill` / `bsk press`
|
//! `bsk click` / `bsk fill` / `bsk press` (M7 interaction tools).
|
||||||
//! interaction tools.
|
|
||||||
//!
|
//!
|
||||||
//! The `<target>` positional accepts either a snapshot ref (`@e3`,
|
//! The `<target>` positional accepts either a snapshot ref (`@e3`,
|
||||||
//! `e3`) or a CSS selector. Use `--ref` / `--selector` explicitly when
|
//! `e3`) or a CSS selector. Use `--ref` / `--selector` explicitly when
|
||||||
@@ -11,9 +10,8 @@ use std::time::Duration;
|
|||||||
use anyhow::Context;
|
use anyhow::Context;
|
||||||
use bsk_protocol::Method;
|
use bsk_protocol::Method;
|
||||||
use bsk_protocol::tools::{
|
use bsk_protocol::tools::{
|
||||||
BlurParams, BlurResult, ClickParams, ClickResult, FillParams, FillResult, FocusParams,
|
ClickParams, ClickResult, FillParams, FillResult, HoverParams, HoverResult, KeyModifier,
|
||||||
FocusResult, HoverParams, HoverResult, KeyModifier, MouseButton, PressParams, PressResult,
|
MouseButton, PressParams, PressResult, SelectParams, SelectResult,
|
||||||
SelectParams, SelectResult,
|
|
||||||
};
|
};
|
||||||
use clap::{Args, ValueEnum};
|
use clap::{Args, ValueEnum};
|
||||||
|
|
||||||
@@ -276,124 +274,6 @@ pub fn dispatch_hover(args: HoverArgs, format: Format) -> Result<(), CliError> {
|
|||||||
Ok(())
|
Ok(())
|
||||||
}
|
}
|
||||||
|
|
||||||
// ---------------------------------------------------------------------------
|
|
||||||
// bsk focus / bsk blur
|
|
||||||
// ---------------------------------------------------------------------------
|
|
||||||
|
|
||||||
#[derive(Debug, Clone, Args)]
|
|
||||||
pub struct FocusArgs {
|
|
||||||
/// Snapshot ref (`@e3`, `e3`) or CSS selector. Optional when `--ref`/`--selector` is used.
|
|
||||||
pub target: Option<String>,
|
|
||||||
|
|
||||||
#[arg(long = "ref")]
|
|
||||||
pub ref_: Option<String>,
|
|
||||||
|
|
||||||
#[arg(long = "selector")]
|
|
||||||
pub selector: Option<String>,
|
|
||||||
|
|
||||||
#[arg(long)]
|
|
||||||
pub session: String,
|
|
||||||
|
|
||||||
#[arg(long = "tab-id")]
|
|
||||||
pub tab_id: Option<i64>,
|
|
||||||
|
|
||||||
#[arg(long, default_value = "30s", value_parser = parse_timeout_ms)]
|
|
||||||
pub timeout: u32,
|
|
||||||
}
|
|
||||||
|
|
||||||
pub fn dispatch_focus(args: FocusArgs, format: Format) -> Result<(), CliError> {
|
|
||||||
let info = ensure_daemon().context("ensure daemon is running")?;
|
|
||||||
let (ref_, selector) = split_target(args.target, args.ref_, args.selector)?;
|
|
||||||
let params = FocusParams {
|
|
||||||
session_id: args.session,
|
|
||||||
ref_,
|
|
||||||
selector,
|
|
||||||
tab_id: args.tab_id,
|
|
||||||
timeout_ms: Some(args.timeout),
|
|
||||||
};
|
|
||||||
let reply: FocusResult = call(
|
|
||||||
info.sock_path,
|
|
||||||
Method::ToolFocus,
|
|
||||||
params,
|
|
||||||
"focus-1",
|
|
||||||
args.timeout,
|
|
||||||
)?;
|
|
||||||
match format {
|
|
||||||
Format::Json => println!(
|
|
||||||
"{}",
|
|
||||||
serde_json::to_string_pretty(&reply)
|
|
||||||
.map_err(|e| CliError::Local(anyhow::anyhow!(e)))?
|
|
||||||
),
|
|
||||||
Format::Human => {
|
|
||||||
let target =
|
|
||||||
format_used_target(reply.used_ref.as_deref(), reply.used_selector.as_deref());
|
|
||||||
println!(
|
|
||||||
"focus ok tab={} target={target} focused={}",
|
|
||||||
reply.tab_id, reply.focused
|
|
||||||
);
|
|
||||||
print_dialog_summaries(&reply.dialogs);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
Ok(())
|
|
||||||
}
|
|
||||||
|
|
||||||
#[derive(Debug, Clone, Args)]
|
|
||||||
pub struct BlurArgs {
|
|
||||||
/// Snapshot ref (`@e3`, `e3`) or CSS selector. Optional when `--ref`/`--selector` is used.
|
|
||||||
pub target: Option<String>,
|
|
||||||
|
|
||||||
#[arg(long = "ref")]
|
|
||||||
pub ref_: Option<String>,
|
|
||||||
|
|
||||||
#[arg(long = "selector")]
|
|
||||||
pub selector: Option<String>,
|
|
||||||
|
|
||||||
#[arg(long)]
|
|
||||||
pub session: String,
|
|
||||||
|
|
||||||
#[arg(long = "tab-id")]
|
|
||||||
pub tab_id: Option<i64>,
|
|
||||||
|
|
||||||
#[arg(long, default_value = "30s", value_parser = parse_timeout_ms)]
|
|
||||||
pub timeout: u32,
|
|
||||||
}
|
|
||||||
|
|
||||||
pub fn dispatch_blur(args: BlurArgs, format: Format) -> Result<(), CliError> {
|
|
||||||
let info = ensure_daemon().context("ensure daemon is running")?;
|
|
||||||
let (ref_, selector) = split_target(args.target, args.ref_, args.selector)?;
|
|
||||||
let params = BlurParams {
|
|
||||||
session_id: args.session,
|
|
||||||
ref_,
|
|
||||||
selector,
|
|
||||||
tab_id: args.tab_id,
|
|
||||||
timeout_ms: Some(args.timeout),
|
|
||||||
};
|
|
||||||
let reply: BlurResult = call(
|
|
||||||
info.sock_path,
|
|
||||||
Method::ToolBlur,
|
|
||||||
params,
|
|
||||||
"blur-1",
|
|
||||||
args.timeout,
|
|
||||||
)?;
|
|
||||||
match format {
|
|
||||||
Format::Json => println!(
|
|
||||||
"{}",
|
|
||||||
serde_json::to_string_pretty(&reply)
|
|
||||||
.map_err(|e| CliError::Local(anyhow::anyhow!(e)))?
|
|
||||||
),
|
|
||||||
Format::Human => {
|
|
||||||
let target =
|
|
||||||
format_used_target(reply.used_ref.as_deref(), reply.used_selector.as_deref());
|
|
||||||
println!(
|
|
||||||
"blur ok tab={} target={target} was_focused={} focused={}",
|
|
||||||
reply.tab_id, reply.was_focused, reply.focused
|
|
||||||
);
|
|
||||||
print_dialog_summaries(&reply.dialogs);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
Ok(())
|
|
||||||
}
|
|
||||||
|
|
||||||
// ---------------------------------------------------------------------------
|
// ---------------------------------------------------------------------------
|
||||||
// bsk fill
|
// bsk fill
|
||||||
// ---------------------------------------------------------------------------
|
// ---------------------------------------------------------------------------
|
||||||
|
|||||||
@@ -28,7 +28,6 @@ pub mod record_recovery;
|
|||||||
pub mod record_state;
|
pub mod record_state;
|
||||||
pub mod render_error;
|
pub mod render_error;
|
||||||
pub mod screenshot;
|
pub mod screenshot;
|
||||||
pub mod scroll;
|
|
||||||
pub mod session;
|
pub mod session;
|
||||||
pub mod snapshot;
|
pub mod snapshot;
|
||||||
pub mod status;
|
pub mod status;
|
||||||
@@ -48,15 +47,12 @@ use crate::cli::evaluate::EvaluateArgs;
|
|||||||
use crate::cli::get_html::GetHtmlArgs;
|
use crate::cli::get_html::GetHtmlArgs;
|
||||||
use crate::cli::human_loop::RequestHelpArgs;
|
use crate::cli::human_loop::RequestHelpArgs;
|
||||||
use crate::cli::install_skill::InstallSkillArgs;
|
use crate::cli::install_skill::InstallSkillArgs;
|
||||||
use crate::cli::interaction::{
|
use crate::cli::interaction::{ClickArgs, FillArgs, HoverArgs, PressArgs, SelectArgs};
|
||||||
BlurArgs, ClickArgs, FillArgs, FocusArgs, HoverArgs, PressArgs, SelectArgs,
|
|
||||||
};
|
|
||||||
use crate::cli::navigate::{NavigateCommand, NavigateHistoryArgs, ReloadArgs};
|
use crate::cli::navigate::{NavigateCommand, NavigateHistoryArgs, ReloadArgs};
|
||||||
use crate::cli::network::NetworkArgs;
|
use crate::cli::network::NetworkArgs;
|
||||||
use crate::cli::observe::ObserveArgs;
|
use crate::cli::observe::ObserveArgs;
|
||||||
use crate::cli::record::RecordCmd;
|
use crate::cli::record::RecordCmd;
|
||||||
use crate::cli::screenshot::ScreenshotArgs;
|
use crate::cli::screenshot::ScreenshotArgs;
|
||||||
use crate::cli::scroll::ScrollToArgs;
|
|
||||||
use crate::cli::session::SessionCmd;
|
use crate::cli::session::SessionCmd;
|
||||||
use crate::cli::snapshot::SnapshotArgs;
|
use crate::cli::snapshot::SnapshotArgs;
|
||||||
use crate::cli::tab::TabCmd;
|
use crate::cli::tab::TabCmd;
|
||||||
@@ -177,16 +173,6 @@ pub enum Command {
|
|||||||
/// Hover a snapshot ref or CSS selector.
|
/// Hover a snapshot ref or CSS selector.
|
||||||
Hover(HoverArgs),
|
Hover(HoverArgs),
|
||||||
|
|
||||||
/// Scroll a snapshot ref or CSS selector into the visible viewport.
|
|
||||||
#[command(name = "scroll-to")]
|
|
||||||
ScrollTo(ScrollToArgs),
|
|
||||||
|
|
||||||
/// Focus a snapshot ref or CSS selector.
|
|
||||||
Focus(FocusArgs),
|
|
||||||
|
|
||||||
/// Remove focus from a snapshot ref or CSS selector.
|
|
||||||
Blur(BlurArgs),
|
|
||||||
|
|
||||||
/// Fill an input / textarea / contenteditable.
|
/// Fill an input / textarea / contenteditable.
|
||||||
Fill(FillArgs),
|
Fill(FillArgs),
|
||||||
|
|
||||||
|
|||||||
@@ -1,100 +0,0 @@
|
|||||||
//! `bsk scroll-to` — bring a target element into the visible viewport.
|
|
||||||
|
|
||||||
use std::time::Duration;
|
|
||||||
|
|
||||||
use anyhow::Context;
|
|
||||||
use bsk_protocol::Method;
|
|
||||||
use bsk_protocol::tools::{ScrollToParams, ScrollToResult};
|
|
||||||
use clap::Args;
|
|
||||||
|
|
||||||
use crate::cli::dialogs::print_dialog_summaries;
|
|
||||||
use crate::cli::ensure_daemon::ensure_daemon;
|
|
||||||
use crate::cli::error::{CliError, Format};
|
|
||||||
use crate::cli::interaction::split_target;
|
|
||||||
use crate::cli::navigate::parse_timeout_ms;
|
|
||||||
|
|
||||||
#[derive(Debug, Clone, Args)]
|
|
||||||
pub struct ScrollToArgs {
|
|
||||||
/// Snapshot ref (`@e3`, `e3`) or CSS selector. Optional when `--ref`/`--selector` is used.
|
|
||||||
pub target: Option<String>,
|
|
||||||
|
|
||||||
#[arg(long = "ref")]
|
|
||||||
pub ref_: Option<String>,
|
|
||||||
|
|
||||||
#[arg(long = "selector")]
|
|
||||||
pub selector: Option<String>,
|
|
||||||
|
|
||||||
#[arg(long)]
|
|
||||||
pub session: String,
|
|
||||||
|
|
||||||
#[arg(long = "tab-id")]
|
|
||||||
pub tab_id: Option<i64>,
|
|
||||||
|
|
||||||
#[arg(long, default_value = "30s", value_parser = parse_timeout_ms)]
|
|
||||||
pub timeout: u32,
|
|
||||||
}
|
|
||||||
|
|
||||||
pub fn dispatch(args: ScrollToArgs, format: Format) -> Result<(), CliError> {
|
|
||||||
let (ref_, selector) = split_target(args.target, args.ref_, args.selector)?;
|
|
||||||
let info = ensure_daemon().context("ensure daemon is running")?;
|
|
||||||
let params = ScrollToParams {
|
|
||||||
session_id: args.session,
|
|
||||||
ref_,
|
|
||||||
selector,
|
|
||||||
tab_id: args.tab_id,
|
|
||||||
timeout_ms: Some(args.timeout),
|
|
||||||
};
|
|
||||||
let reply: ScrollToResult = crate::cli::business_rpc::call(
|
|
||||||
info.sock_path,
|
|
||||||
"scroll-to-1",
|
|
||||||
Method::ToolScrollTo,
|
|
||||||
Some(params),
|
|
||||||
ipc_timeout(args.timeout),
|
|
||||||
)?;
|
|
||||||
match format {
|
|
||||||
Format::Json => println!(
|
|
||||||
"{}",
|
|
||||||
serde_json::to_string_pretty(&reply)
|
|
||||||
.map_err(|e| CliError::Local(anyhow::anyhow!(e)))?
|
|
||||||
),
|
|
||||||
Format::Human => {
|
|
||||||
let target =
|
|
||||||
format_used_target(reply.used_ref.as_deref(), reply.used_selector.as_deref());
|
|
||||||
println!(
|
|
||||||
"scroll-to ok tab={} target={target} bounds=({}, {}, {}, {})",
|
|
||||||
reply.tab_id, reply.x, reply.y, reply.width, reply.height
|
|
||||||
);
|
|
||||||
print_dialog_summaries(&reply.dialogs);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
Ok(())
|
|
||||||
}
|
|
||||||
|
|
||||||
fn format_used_target(used_ref: Option<&str>, used_selector: Option<&str>) -> String {
|
|
||||||
used_ref
|
|
||||||
.map(|r| format!("@{r}"))
|
|
||||||
.or_else(|| used_selector.map(str::to_string))
|
|
||||||
.unwrap_or_else(|| "?".into())
|
|
||||||
}
|
|
||||||
|
|
||||||
fn ipc_timeout(timeout_ms: u32) -> Duration {
|
|
||||||
Duration::from_millis(u64::from(timeout_ms))
|
|
||||||
.checked_add(Duration::from_secs(15))
|
|
||||||
.unwrap_or(Duration::from_secs(u64::from(timeout_ms / 1_000) + 15))
|
|
||||||
}
|
|
||||||
|
|
||||||
#[cfg(test)]
|
|
||||||
mod tests {
|
|
||||||
use super::*;
|
|
||||||
|
|
||||||
#[test]
|
|
||||||
fn split_target_detects_refs_and_selectors() {
|
|
||||||
let (ref_, selector) = split_target(Some("@e3".into()), None, None).unwrap();
|
|
||||||
assert_eq!(ref_.as_deref(), Some("@e3"));
|
|
||||||
assert!(selector.is_none());
|
|
||||||
|
|
||||||
let (ref_, selector) = split_target(Some("#target".into()), None, None).unwrap();
|
|
||||||
assert!(ref_.is_none());
|
|
||||||
assert_eq!(selector.as_deref(), Some("#target"));
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -253,9 +253,6 @@ pub fn full_handler(status: DaemonStatus, state: Arc<DaemonState>) -> RpcHandler
|
|||||||
| Method::ToolReload
|
| Method::ToolReload
|
||||||
| Method::ToolClick
|
| Method::ToolClick
|
||||||
| Method::ToolHover
|
| Method::ToolHover
|
||||||
| Method::ToolScrollTo
|
|
||||||
| Method::ToolFocus
|
|
||||||
| Method::ToolBlur
|
|
||||||
| Method::ToolFill
|
| Method::ToolFill
|
||||||
| Method::ToolPress
|
| Method::ToolPress
|
||||||
| Method::ToolSelect
|
| Method::ToolSelect
|
||||||
|
|||||||
@@ -94,9 +94,6 @@ fn dispatch(cli: Cli, format: Format) -> Result<(), CliError> {
|
|||||||
Command::Reload(args) => cli::navigate::dispatch_reload(args, format),
|
Command::Reload(args) => cli::navigate::dispatch_reload(args, format),
|
||||||
Command::Click(args) => cli::interaction::dispatch_click(args, format),
|
Command::Click(args) => cli::interaction::dispatch_click(args, format),
|
||||||
Command::Hover(args) => cli::interaction::dispatch_hover(args, format),
|
Command::Hover(args) => cli::interaction::dispatch_hover(args, format),
|
||||||
Command::ScrollTo(args) => cli::scroll::dispatch(args, format),
|
|
||||||
Command::Focus(args) => cli::interaction::dispatch_focus(args, format),
|
|
||||||
Command::Blur(args) => cli::interaction::dispatch_blur(args, format),
|
|
||||||
Command::Fill(args) => cli::interaction::dispatch_fill(args, format),
|
Command::Fill(args) => cli::interaction::dispatch_fill(args, format),
|
||||||
Command::Press(args) => cli::interaction::dispatch_press(args, format),
|
Command::Press(args) => cli::interaction::dispatch_press(args, format),
|
||||||
Command::Select(args) => cli::interaction::dispatch_select(args, format),
|
Command::Select(args) => cli::interaction::dispatch_select(args, format),
|
||||||
|
|||||||
@@ -255,65 +255,6 @@ fn parses_hover_with_settle() {
|
|||||||
assert_eq!(args.settle, 300);
|
assert_eq!(args.settle, 300);
|
||||||
}
|
}
|
||||||
|
|
||||||
#[test]
|
|
||||||
fn parses_scroll_to_target() {
|
|
||||||
let cli = parse(&["bsk", "scroll-to", "@e2", "--session", "s1"]);
|
|
||||||
let Command::ScrollTo(args) = cli.command else {
|
|
||||||
panic!("expected scroll-to command");
|
|
||||||
};
|
|
||||||
assert_eq!(args.target.as_deref(), Some("@e2"));
|
|
||||||
}
|
|
||||||
|
|
||||||
#[test]
|
|
||||||
fn parses_scroll_to_explicit_target_tab_and_timeout() {
|
|
||||||
for flag in ["--ref", "--selector"] {
|
|
||||||
let cli = parse(&[
|
|
||||||
"bsk",
|
|
||||||
"scroll-to",
|
|
||||||
flag,
|
|
||||||
"e3",
|
|
||||||
"--session",
|
|
||||||
"s1",
|
|
||||||
"--tab-id",
|
|
||||||
"42",
|
|
||||||
"--timeout",
|
|
||||||
"5s",
|
|
||||||
]);
|
|
||||||
let Command::ScrollTo(args) = cli.command else {
|
|
||||||
panic!("expected scroll-to command");
|
|
||||||
};
|
|
||||||
assert_eq!(args.tab_id, Some(42));
|
|
||||||
assert_eq!(args.timeout, 5_000);
|
|
||||||
assert_eq!(
|
|
||||||
if flag == "--ref" {
|
|
||||||
args.ref_
|
|
||||||
} else {
|
|
||||||
args.selector
|
|
||||||
}
|
|
||||||
.as_deref(),
|
|
||||||
Some("e3")
|
|
||||||
);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
#[test]
|
|
||||||
fn parses_focus_target() {
|
|
||||||
let cli = parse(&["bsk", "focus", "@e2", "--session", "s1"]);
|
|
||||||
let Command::Focus(args) = cli.command else {
|
|
||||||
panic!("expected focus command");
|
|
||||||
};
|
|
||||||
assert_eq!(args.target.as_deref(), Some("@e2"));
|
|
||||||
}
|
|
||||||
|
|
||||||
#[test]
|
|
||||||
fn parses_blur_selector() {
|
|
||||||
let cli = parse(&["bsk", "blur", "--selector", "#search", "--session", "s1"]);
|
|
||||||
let Command::Blur(args) = cli.command else {
|
|
||||||
panic!("expected blur command");
|
|
||||||
};
|
|
||||||
assert_eq!(args.selector.as_deref(), Some("#search"));
|
|
||||||
}
|
|
||||||
|
|
||||||
#[test]
|
#[test]
|
||||||
fn rejects_zero_click_count() {
|
fn rejects_zero_click_count() {
|
||||||
assert!(
|
assert!(
|
||||||
|
|||||||
@@ -293,15 +293,6 @@ async fn session_user_interrupt_event_cancels_inflight_with_user_aborted() {
|
|||||||
/// catch a tool dispatched arbitrarily later.
|
/// catch a tool dispatched arbitrarily later.
|
||||||
#[tokio::test(flavor = "multi_thread", worker_threads = 4)]
|
#[tokio::test(flavor = "multi_thread", worker_threads = 4)]
|
||||||
async fn user_interrupt_rejects_next_mutating_tool_call_when_session_was_idle() {
|
async fn user_interrupt_rejects_next_mutating_tool_call_when_session_was_idle() {
|
||||||
assert_idle_interrupt_rejects(Method::ToolClick).await;
|
|
||||||
}
|
|
||||||
|
|
||||||
#[tokio::test(flavor = "multi_thread", worker_threads = 4)]
|
|
||||||
async fn user_interrupt_rejects_scroll_to_before_forwarding() {
|
|
||||||
assert_idle_interrupt_rejects(Method::ToolScrollTo).await;
|
|
||||||
}
|
|
||||||
|
|
||||||
async fn assert_idle_interrupt_rejects(method: Method) {
|
|
||||||
let (handle, sock) = spawn_daemon().await;
|
let (handle, sock) = spawn_daemon().await;
|
||||||
let mut ws = connect_ext(handle.ws_addr()).await;
|
let mut ws = connect_ext(handle.ws_addr()).await;
|
||||||
let _ = handshake_as_ext(&mut ws).await;
|
let _ = handshake_as_ext(&mut ws).await;
|
||||||
@@ -310,11 +301,10 @@ async fn assert_idle_interrupt_rejects(method: Method) {
|
|||||||
|
|
||||||
// Fake extension: answer tool.session_start, observe other
|
// Fake extension: answer tool.session_start, observe other
|
||||||
// requests but never reply. We expect the daemon to reject the
|
// requests but never reply. We expect the daemon to reject the
|
||||||
// tool call BEFORE it ever forwards a browser-input frame.
|
// tool call BEFORE it ever forwards a tool.click frame.
|
||||||
let ws_sink_for_responder = Arc::clone(&ws_sink);
|
let ws_sink_for_responder = Arc::clone(&ws_sink);
|
||||||
let observed_call_count = Arc::new(std::sync::atomic::AtomicUsize::new(0));
|
let observed_click_count = Arc::new(std::sync::atomic::AtomicUsize::new(0));
|
||||||
let observed_call_count_clone = Arc::clone(&observed_call_count);
|
let observed_click_count_clone = Arc::clone(&observed_click_count);
|
||||||
let forwarded_method = method.clone();
|
|
||||||
let responder = tokio::spawn(async move {
|
let responder = tokio::spawn(async move {
|
||||||
let mut ws_stream = ws_stream;
|
let mut ws_stream = ws_stream;
|
||||||
while let Some(Ok(msg)) = ws_stream.next().await {
|
while let Some(Ok(msg)) = ws_stream.next().await {
|
||||||
@@ -339,8 +329,8 @@ async fn assert_idle_interrupt_rejects(method: Method) {
|
|||||||
g.send(Message::Text(serde_json::to_string(&reply).unwrap()))
|
g.send(Message::Text(serde_json::to_string(&reply).unwrap()))
|
||||||
.await
|
.await
|
||||||
.unwrap();
|
.unwrap();
|
||||||
} else if req.method == forwarded_method {
|
} else if req.method == Method::ToolClick {
|
||||||
observed_call_count_clone.fetch_add(1, std::sync::atomic::Ordering::SeqCst);
|
observed_click_count_clone.fetch_add(1, std::sync::atomic::Ordering::SeqCst);
|
||||||
// Deliberately do NOT reply — daemon should reject before
|
// Deliberately do NOT reply — daemon should reject before
|
||||||
// ever forwarding to us.
|
// ever forwarding to us.
|
||||||
let _ = req;
|
let _ = req;
|
||||||
@@ -387,12 +377,12 @@ async fn assert_idle_interrupt_rejects(method: Method) {
|
|||||||
let state = handle.state();
|
let state = handle.state();
|
||||||
wait_for_session_interrupt_pending(&state, &start.session_id).await;
|
wait_for_session_interrupt_pending(&state, &start.session_id).await;
|
||||||
|
|
||||||
// The CLI now issues a browser-input (mutating). The daemon must
|
// The CLI now issues a tool.click (mutating). The daemon must
|
||||||
// reject it WITHOUT forwarding to the extension.
|
// reject it WITHOUT forwarding to the extension.
|
||||||
let outcome = ipc
|
let click_outcome = ipc
|
||||||
.call::<_, serde_json::Value>(
|
.call::<_, serde_json::Value>(
|
||||||
"input-after-interrupt",
|
"click-after-interrupt",
|
||||||
method,
|
Method::ToolClick,
|
||||||
Some(json!({
|
Some(json!({
|
||||||
"session_id": start.session_id,
|
"session_id": start.session_id,
|
||||||
"ref": "fake-ref-1",
|
"ref": "fake-ref-1",
|
||||||
@@ -401,7 +391,7 @@ async fn assert_idle_interrupt_rejects(method: Method) {
|
|||||||
)
|
)
|
||||||
.await
|
.await
|
||||||
.unwrap();
|
.unwrap();
|
||||||
let err = outcome.expect_err("browser-input must be rejected");
|
let err = click_outcome.expect_err("tool.click must be rejected");
|
||||||
assert_eq!(
|
assert_eq!(
|
||||||
err.code,
|
err.code,
|
||||||
ErrorCode::UserAborted,
|
ErrorCode::UserAborted,
|
||||||
@@ -409,11 +399,11 @@ async fn assert_idle_interrupt_rejects(method: Method) {
|
|||||||
err
|
err
|
||||||
);
|
);
|
||||||
|
|
||||||
// Crucially: the extension never saw a browser-input frame.
|
// Crucially: the extension never saw a tool.click frame.
|
||||||
assert_eq!(
|
assert_eq!(
|
||||||
observed_call_count.load(std::sync::atomic::Ordering::SeqCst),
|
observed_click_count.load(std::sync::atomic::Ordering::SeqCst),
|
||||||
0,
|
0,
|
||||||
"browser-input must NOT have been forwarded to the extension"
|
"tool.click must NOT have been forwarded to the extension"
|
||||||
);
|
);
|
||||||
|
|
||||||
responder.abort();
|
responder.abort();
|
||||||
|
|||||||
@@ -1,4 +1,5 @@
|
|||||||
//! M7 integration: drive interaction and navigation tool RPCs
|
//! M7 integration: drive the 7 new tool RPCs (navigate /
|
||||||
|
//! navigate_back / navigate_forward / reload / click / fill / press)
|
||||||
//! through the IPC + per-session queue + fake extension and assert
|
//! through the IPC + per-session queue + fake extension and assert
|
||||||
//! the wire shapes line up. The extension stub mirrors each method's
|
//! the wire shapes line up. The extension stub mirrors each method's
|
||||||
//! `*Result` so we exercise the daemon's serialise → forward →
|
//! `*Result` so we exercise the daemon's serialise → forward →
|
||||||
@@ -12,13 +13,11 @@ use bsk::daemon::{self, DaemonConfig};
|
|||||||
use bsk::ipc_client::IpcClient;
|
use bsk::ipc_client::IpcClient;
|
||||||
use bsk_protocol::system::{HandshakeParams, HandshakeResult};
|
use bsk_protocol::system::{HandshakeParams, HandshakeResult};
|
||||||
use bsk_protocol::tools::{
|
use bsk_protocol::tools::{
|
||||||
BlurParams, BlurResult, ClickParams, ClickResult, FillParams, FillResult, FocusParams,
|
ClickParams, ClickResult, FillParams, FillResult, KeyModifier, MouseButton, NavigateBackParams,
|
||||||
FocusResult, KeyModifier, MouseButton, NavigateBackParams, NavigateBackResult,
|
NavigateBackResult, NavigateForwardParams, NavigateForwardResult, NavigateParams,
|
||||||
NavigateForwardParams, NavigateForwardResult, NavigateParams, NavigateResult, PressParams,
|
NavigateResult, PressParams, PressResult, ReloadParams, ReloadResult, SelectParams,
|
||||||
PressResult, ReloadParams, ReloadResult, SelectParams, SelectResult, SessionStartParams,
|
SelectResult, SessionStartParams, SessionStartResult, WaitUntil,
|
||||||
SessionStartResult, WaitUntil,
|
|
||||||
};
|
};
|
||||||
use bsk_protocol::tools::{ScrollToParams, ScrollToResult};
|
|
||||||
use bsk_protocol::{
|
use bsk_protocol::{
|
||||||
BrowserPeerInfo, ErrorCode, Frame, Method, RequestFrame, ResponseBody, ResponseFrame, RpcError,
|
BrowserPeerInfo, ErrorCode, Frame, Method, RequestFrame, ResponseBody, ResponseFrame, RpcError,
|
||||||
};
|
};
|
||||||
@@ -383,137 +382,6 @@ async fn click_round_trips_ref_and_modifiers() {
|
|||||||
handle.shutdown().await;
|
handle.shutdown().await;
|
||||||
}
|
}
|
||||||
|
|
||||||
#[tokio::test(flavor = "multi_thread", worker_threads = 2)]
|
|
||||||
async fn focus_round_trips_verified_state() {
|
|
||||||
let (handle, sock) = spawn_daemon().await;
|
|
||||||
let mut ws = connect_ext(handle.ws_addr()).await;
|
|
||||||
let _ = do_handshake(&mut ws).await;
|
|
||||||
|
|
||||||
run_extension(ws, |req| {
|
|
||||||
assert_eq!(req.method, Method::ToolFocus);
|
|
||||||
let params = req.params.clone().unwrap();
|
|
||||||
let p: FocusParams = serde_json::from_value(params).unwrap();
|
|
||||||
assert_eq!(p.ref_.as_deref(), Some("@e3"));
|
|
||||||
ResponseBody::Ok(
|
|
||||||
serde_json::to_value(FocusResult {
|
|
||||||
tab_id: 9,
|
|
||||||
used_ref: Some("e3".into()),
|
|
||||||
used_selector: None,
|
|
||||||
focused: true,
|
|
||||||
dialogs: vec![],
|
|
||||||
})
|
|
||||||
.unwrap(),
|
|
||||||
)
|
|
||||||
});
|
|
||||||
|
|
||||||
let session_id = ipc_session_start(&sock).await;
|
|
||||||
let result: FocusResult = ipc_tool_call(
|
|
||||||
&sock,
|
|
||||||
Method::ToolFocus,
|
|
||||||
FocusParams {
|
|
||||||
session_id,
|
|
||||||
ref_: Some("@e3".into()),
|
|
||||||
selector: None,
|
|
||||||
tab_id: None,
|
|
||||||
timeout_ms: Some(5_000),
|
|
||||||
},
|
|
||||||
)
|
|
||||||
.await
|
|
||||||
.expect("focus ok");
|
|
||||||
assert!(result.focused);
|
|
||||||
assert_eq!(result.used_ref.as_deref(), Some("e3"));
|
|
||||||
handle.shutdown().await;
|
|
||||||
}
|
|
||||||
|
|
||||||
#[tokio::test(flavor = "multi_thread", worker_threads = 2)]
|
|
||||||
async fn blur_round_trips_previous_focus_state() {
|
|
||||||
let (handle, sock) = spawn_daemon().await;
|
|
||||||
let mut ws = connect_ext(handle.ws_addr()).await;
|
|
||||||
let _ = do_handshake(&mut ws).await;
|
|
||||||
|
|
||||||
run_extension(ws, |req| {
|
|
||||||
assert_eq!(req.method, Method::ToolBlur);
|
|
||||||
let params = req.params.clone().unwrap();
|
|
||||||
let p: BlurParams = serde_json::from_value(params).unwrap();
|
|
||||||
assert_eq!(p.selector.as_deref(), Some("#search"));
|
|
||||||
ResponseBody::Ok(
|
|
||||||
serde_json::to_value(BlurResult {
|
|
||||||
tab_id: 9,
|
|
||||||
used_ref: None,
|
|
||||||
used_selector: Some("#search".into()),
|
|
||||||
was_focused: true,
|
|
||||||
focused: false,
|
|
||||||
dialogs: vec![],
|
|
||||||
})
|
|
||||||
.unwrap(),
|
|
||||||
)
|
|
||||||
});
|
|
||||||
|
|
||||||
let session_id = ipc_session_start(&sock).await;
|
|
||||||
let result: BlurResult = ipc_tool_call(
|
|
||||||
&sock,
|
|
||||||
Method::ToolBlur,
|
|
||||||
BlurParams {
|
|
||||||
session_id,
|
|
||||||
ref_: None,
|
|
||||||
selector: Some("#search".into()),
|
|
||||||
tab_id: None,
|
|
||||||
timeout_ms: Some(5_000),
|
|
||||||
},
|
|
||||||
)
|
|
||||||
.await
|
|
||||||
.expect("blur ok");
|
|
||||||
assert!(result.was_focused);
|
|
||||||
assert!(!result.focused);
|
|
||||||
assert_eq!(result.used_selector.as_deref(), Some("#search"));
|
|
||||||
handle.shutdown().await;
|
|
||||||
}
|
|
||||||
|
|
||||||
#[tokio::test(flavor = "multi_thread", worker_threads = 2)]
|
|
||||||
async fn scroll_to_round_trips_visible_bounds() {
|
|
||||||
let (handle, sock) = spawn_daemon().await;
|
|
||||||
let mut ws = connect_ext(handle.ws_addr()).await;
|
|
||||||
let _ = do_handshake(&mut ws).await;
|
|
||||||
|
|
||||||
run_extension(ws, |req| {
|
|
||||||
assert_eq!(req.method, Method::ToolScrollTo);
|
|
||||||
let params = req.params.clone().unwrap();
|
|
||||||
let parsed: ScrollToParams = serde_json::from_value(params).unwrap();
|
|
||||||
assert_eq!(parsed.ref_.as_deref(), Some("@e3"));
|
|
||||||
ResponseBody::Ok(
|
|
||||||
serde_json::to_value(ScrollToResult {
|
|
||||||
tab_id: 9,
|
|
||||||
used_ref: Some("e3".into()),
|
|
||||||
used_selector: None,
|
|
||||||
x: 10.0,
|
|
||||||
y: 20.0,
|
|
||||||
width: 100.0,
|
|
||||||
height: 40.0,
|
|
||||||
dialogs: vec![],
|
|
||||||
})
|
|
||||||
.unwrap(),
|
|
||||||
)
|
|
||||||
});
|
|
||||||
|
|
||||||
let session_id = ipc_session_start(&sock).await;
|
|
||||||
let result: ScrollToResult = ipc_tool_call(
|
|
||||||
&sock,
|
|
||||||
Method::ToolScrollTo,
|
|
||||||
ScrollToParams {
|
|
||||||
session_id,
|
|
||||||
ref_: Some("@e3".into()),
|
|
||||||
selector: None,
|
|
||||||
tab_id: None,
|
|
||||||
timeout_ms: Some(5_000),
|
|
||||||
},
|
|
||||||
)
|
|
||||||
.await
|
|
||||||
.expect("scroll-to ok");
|
|
||||||
assert_eq!(result.used_ref.as_deref(), Some("e3"));
|
|
||||||
assert_eq!(result.width, 100.0);
|
|
||||||
handle.shutdown().await;
|
|
||||||
}
|
|
||||||
|
|
||||||
#[tokio::test(flavor = "multi_thread", worker_threads = 2)]
|
#[tokio::test(flavor = "multi_thread", worker_threads = 2)]
|
||||||
async fn fill_round_trips_clear_before_default() {
|
async fn fill_round_trips_clear_before_default() {
|
||||||
let (handle, sock) = spawn_daemon().await;
|
let (handle, sock) = spawn_daemon().await;
|
||||||
|
|||||||
@@ -1,42 +0,0 @@
|
|||||||
{
|
|
||||||
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
||||||
"title": "BlurParams",
|
|
||||||
"type": "object",
|
|
||||||
"required": [
|
|
||||||
"session_id"
|
|
||||||
],
|
|
||||||
"properties": {
|
|
||||||
"ref": {
|
|
||||||
"description": "Optional `@e<N>` ref allocated by the last observation. Mutually exclusive with `selector`.",
|
|
||||||
"type": [
|
|
||||||
"string",
|
|
||||||
"null"
|
|
||||||
]
|
|
||||||
},
|
|
||||||
"selector": {
|
|
||||||
"type": [
|
|
||||||
"string",
|
|
||||||
"null"
|
|
||||||
]
|
|
||||||
},
|
|
||||||
"session_id": {
|
|
||||||
"type": "string"
|
|
||||||
},
|
|
||||||
"tab_id": {
|
|
||||||
"description": "Target tab. Defaults to the Agent Window's active tab.",
|
|
||||||
"type": [
|
|
||||||
"integer",
|
|
||||||
"null"
|
|
||||||
],
|
|
||||||
"format": "int64"
|
|
||||||
},
|
|
||||||
"timeout_ms": {
|
|
||||||
"type": [
|
|
||||||
"integer",
|
|
||||||
"null"
|
|
||||||
],
|
|
||||||
"format": "uint32",
|
|
||||||
"minimum": 1.0
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,112 +0,0 @@
|
|||||||
{
|
|
||||||
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
||||||
"title": "BlurResult",
|
|
||||||
"type": "object",
|
|
||||||
"required": [
|
|
||||||
"focused",
|
|
||||||
"tab_id",
|
|
||||||
"was_focused"
|
|
||||||
],
|
|
||||||
"properties": {
|
|
||||||
"dialogs": {
|
|
||||||
"type": "array",
|
|
||||||
"items": {
|
|
||||||
"$ref": "#/definitions/JavaScriptDialogInfo"
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"focused": {
|
|
||||||
"description": "Always false for a successful blur; included for machine verification.",
|
|
||||||
"type": "boolean"
|
|
||||||
},
|
|
||||||
"tab_id": {
|
|
||||||
"type": "integer",
|
|
||||||
"format": "int64"
|
|
||||||
},
|
|
||||||
"used_ref": {
|
|
||||||
"type": [
|
|
||||||
"string",
|
|
||||||
"null"
|
|
||||||
]
|
|
||||||
},
|
|
||||||
"used_selector": {
|
|
||||||
"type": [
|
|
||||||
"string",
|
|
||||||
"null"
|
|
||||||
]
|
|
||||||
},
|
|
||||||
"was_focused": {
|
|
||||||
"description": "Whether the target held focus before the call.",
|
|
||||||
"type": "boolean"
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"definitions": {
|
|
||||||
"JavaScriptDialogHandledAction": {
|
|
||||||
"description": "How the extension resolved the dialog so CDP could continue.",
|
|
||||||
"type": "string",
|
|
||||||
"enum": [
|
|
||||||
"accepted",
|
|
||||||
"dismissed"
|
|
||||||
]
|
|
||||||
},
|
|
||||||
"JavaScriptDialogInfo": {
|
|
||||||
"description": "One observed + handled JavaScript dialog during a tool call.",
|
|
||||||
"type": "object",
|
|
||||||
"required": [
|
|
||||||
"handled",
|
|
||||||
"message",
|
|
||||||
"sequence",
|
|
||||||
"tab_id",
|
|
||||||
"type"
|
|
||||||
],
|
|
||||||
"properties": {
|
|
||||||
"default_prompt": {
|
|
||||||
"type": [
|
|
||||||
"string",
|
|
||||||
"null"
|
|
||||||
]
|
|
||||||
},
|
|
||||||
"handled": {
|
|
||||||
"$ref": "#/definitions/JavaScriptDialogHandledAction"
|
|
||||||
},
|
|
||||||
"has_browser_handler": {
|
|
||||||
"type": [
|
|
||||||
"boolean",
|
|
||||||
"null"
|
|
||||||
]
|
|
||||||
},
|
|
||||||
"message": {
|
|
||||||
"type": "string"
|
|
||||||
},
|
|
||||||
"sequence": {
|
|
||||||
"description": "Monotonic per-tab sequence for ordering within a session.",
|
|
||||||
"type": "integer",
|
|
||||||
"format": "uint64",
|
|
||||||
"minimum": 0.0
|
|
||||||
},
|
|
||||||
"tab_id": {
|
|
||||||
"type": "integer",
|
|
||||||
"format": "int64"
|
|
||||||
},
|
|
||||||
"type": {
|
|
||||||
"$ref": "#/definitions/JavaScriptDialogType"
|
|
||||||
},
|
|
||||||
"url": {
|
|
||||||
"type": [
|
|
||||||
"string",
|
|
||||||
"null"
|
|
||||||
]
|
|
||||||
}
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"JavaScriptDialogType": {
|
|
||||||
"description": "Native JS dialog kind reported by CDP.",
|
|
||||||
"type": "string",
|
|
||||||
"enum": [
|
|
||||||
"alert",
|
|
||||||
"confirm",
|
|
||||||
"prompt",
|
|
||||||
"beforeunload"
|
|
||||||
]
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,42 +0,0 @@
|
|||||||
{
|
|
||||||
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
||||||
"title": "FocusParams",
|
|
||||||
"type": "object",
|
|
||||||
"required": [
|
|
||||||
"session_id"
|
|
||||||
],
|
|
||||||
"properties": {
|
|
||||||
"ref": {
|
|
||||||
"description": "Optional `@e<N>` ref allocated by the last observation. Mutually exclusive with `selector`.",
|
|
||||||
"type": [
|
|
||||||
"string",
|
|
||||||
"null"
|
|
||||||
]
|
|
||||||
},
|
|
||||||
"selector": {
|
|
||||||
"type": [
|
|
||||||
"string",
|
|
||||||
"null"
|
|
||||||
]
|
|
||||||
},
|
|
||||||
"session_id": {
|
|
||||||
"type": "string"
|
|
||||||
},
|
|
||||||
"tab_id": {
|
|
||||||
"description": "Target tab. Defaults to the Agent Window's active tab.",
|
|
||||||
"type": [
|
|
||||||
"integer",
|
|
||||||
"null"
|
|
||||||
],
|
|
||||||
"format": "int64"
|
|
||||||
},
|
|
||||||
"timeout_ms": {
|
|
||||||
"type": [
|
|
||||||
"integer",
|
|
||||||
"null"
|
|
||||||
],
|
|
||||||
"format": "uint32",
|
|
||||||
"minimum": 1.0
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,107 +0,0 @@
|
|||||||
{
|
|
||||||
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
||||||
"title": "FocusResult",
|
|
||||||
"type": "object",
|
|
||||||
"required": [
|
|
||||||
"focused",
|
|
||||||
"tab_id"
|
|
||||||
],
|
|
||||||
"properties": {
|
|
||||||
"dialogs": {
|
|
||||||
"type": "array",
|
|
||||||
"items": {
|
|
||||||
"$ref": "#/definitions/JavaScriptDialogInfo"
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"focused": {
|
|
||||||
"description": "Whether the target holds DOM focus in its document or shadow root after the call.",
|
|
||||||
"type": "boolean"
|
|
||||||
},
|
|
||||||
"tab_id": {
|
|
||||||
"type": "integer",
|
|
||||||
"format": "int64"
|
|
||||||
},
|
|
||||||
"used_ref": {
|
|
||||||
"type": [
|
|
||||||
"string",
|
|
||||||
"null"
|
|
||||||
]
|
|
||||||
},
|
|
||||||
"used_selector": {
|
|
||||||
"type": [
|
|
||||||
"string",
|
|
||||||
"null"
|
|
||||||
]
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"definitions": {
|
|
||||||
"JavaScriptDialogHandledAction": {
|
|
||||||
"description": "How the extension resolved the dialog so CDP could continue.",
|
|
||||||
"type": "string",
|
|
||||||
"enum": [
|
|
||||||
"accepted",
|
|
||||||
"dismissed"
|
|
||||||
]
|
|
||||||
},
|
|
||||||
"JavaScriptDialogInfo": {
|
|
||||||
"description": "One observed + handled JavaScript dialog during a tool call.",
|
|
||||||
"type": "object",
|
|
||||||
"required": [
|
|
||||||
"handled",
|
|
||||||
"message",
|
|
||||||
"sequence",
|
|
||||||
"tab_id",
|
|
||||||
"type"
|
|
||||||
],
|
|
||||||
"properties": {
|
|
||||||
"default_prompt": {
|
|
||||||
"type": [
|
|
||||||
"string",
|
|
||||||
"null"
|
|
||||||
]
|
|
||||||
},
|
|
||||||
"handled": {
|
|
||||||
"$ref": "#/definitions/JavaScriptDialogHandledAction"
|
|
||||||
},
|
|
||||||
"has_browser_handler": {
|
|
||||||
"type": [
|
|
||||||
"boolean",
|
|
||||||
"null"
|
|
||||||
]
|
|
||||||
},
|
|
||||||
"message": {
|
|
||||||
"type": "string"
|
|
||||||
},
|
|
||||||
"sequence": {
|
|
||||||
"description": "Monotonic per-tab sequence for ordering within a session.",
|
|
||||||
"type": "integer",
|
|
||||||
"format": "uint64",
|
|
||||||
"minimum": 0.0
|
|
||||||
},
|
|
||||||
"tab_id": {
|
|
||||||
"type": "integer",
|
|
||||||
"format": "int64"
|
|
||||||
},
|
|
||||||
"type": {
|
|
||||||
"$ref": "#/definitions/JavaScriptDialogType"
|
|
||||||
},
|
|
||||||
"url": {
|
|
||||||
"type": [
|
|
||||||
"string",
|
|
||||||
"null"
|
|
||||||
]
|
|
||||||
}
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"JavaScriptDialogType": {
|
|
||||||
"description": "Native JS dialog kind reported by CDP.",
|
|
||||||
"type": "string",
|
|
||||||
"enum": [
|
|
||||||
"alert",
|
|
||||||
"confirm",
|
|
||||||
"prompt",
|
|
||||||
"beforeunload"
|
|
||||||
]
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,42 +0,0 @@
|
|||||||
{
|
|
||||||
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
||||||
"title": "ScrollToParams",
|
|
||||||
"type": "object",
|
|
||||||
"required": [
|
|
||||||
"session_id"
|
|
||||||
],
|
|
||||||
"properties": {
|
|
||||||
"ref": {
|
|
||||||
"description": "Optional `@e<N>` ref allocated by the last observation. Mutually exclusive with `selector`.",
|
|
||||||
"type": [
|
|
||||||
"string",
|
|
||||||
"null"
|
|
||||||
]
|
|
||||||
},
|
|
||||||
"selector": {
|
|
||||||
"type": [
|
|
||||||
"string",
|
|
||||||
"null"
|
|
||||||
]
|
|
||||||
},
|
|
||||||
"session_id": {
|
|
||||||
"type": "string"
|
|
||||||
},
|
|
||||||
"tab_id": {
|
|
||||||
"description": "Target tab. Defaults to the Agent Window's active tab.",
|
|
||||||
"type": [
|
|
||||||
"integer",
|
|
||||||
"null"
|
|
||||||
],
|
|
||||||
"format": "int64"
|
|
||||||
},
|
|
||||||
"timeout_ms": {
|
|
||||||
"type": [
|
|
||||||
"integer",
|
|
||||||
"null"
|
|
||||||
],
|
|
||||||
"format": "uint32",
|
|
||||||
"minimum": 1.0
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,123 +0,0 @@
|
|||||||
{
|
|
||||||
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
||||||
"title": "ScrollToResult",
|
|
||||||
"type": "object",
|
|
||||||
"required": [
|
|
||||||
"height",
|
|
||||||
"tab_id",
|
|
||||||
"width",
|
|
||||||
"x",
|
|
||||||
"y"
|
|
||||||
],
|
|
||||||
"properties": {
|
|
||||||
"dialogs": {
|
|
||||||
"type": "array",
|
|
||||||
"items": {
|
|
||||||
"$ref": "#/definitions/JavaScriptDialogInfo"
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"height": {
|
|
||||||
"type": "number",
|
|
||||||
"format": "double"
|
|
||||||
},
|
|
||||||
"tab_id": {
|
|
||||||
"type": "integer",
|
|
||||||
"format": "int64"
|
|
||||||
},
|
|
||||||
"used_ref": {
|
|
||||||
"type": [
|
|
||||||
"string",
|
|
||||||
"null"
|
|
||||||
]
|
|
||||||
},
|
|
||||||
"used_selector": {
|
|
||||||
"type": [
|
|
||||||
"string",
|
|
||||||
"null"
|
|
||||||
]
|
|
||||||
},
|
|
||||||
"width": {
|
|
||||||
"type": "number",
|
|
||||||
"format": "double"
|
|
||||||
},
|
|
||||||
"x": {
|
|
||||||
"description": "Bounding rectangle of the element's visible border-box portion, in top-level viewport CSS pixels, after ancestor and viewport clipping. Partial visibility is sufficient. This is not an occlusion or hit test.",
|
|
||||||
"type": "number",
|
|
||||||
"format": "double"
|
|
||||||
},
|
|
||||||
"y": {
|
|
||||||
"type": "number",
|
|
||||||
"format": "double"
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"definitions": {
|
|
||||||
"JavaScriptDialogHandledAction": {
|
|
||||||
"description": "How the extension resolved the dialog so CDP could continue.",
|
|
||||||
"type": "string",
|
|
||||||
"enum": [
|
|
||||||
"accepted",
|
|
||||||
"dismissed"
|
|
||||||
]
|
|
||||||
},
|
|
||||||
"JavaScriptDialogInfo": {
|
|
||||||
"description": "One observed + handled JavaScript dialog during a tool call.",
|
|
||||||
"type": "object",
|
|
||||||
"required": [
|
|
||||||
"handled",
|
|
||||||
"message",
|
|
||||||
"sequence",
|
|
||||||
"tab_id",
|
|
||||||
"type"
|
|
||||||
],
|
|
||||||
"properties": {
|
|
||||||
"default_prompt": {
|
|
||||||
"type": [
|
|
||||||
"string",
|
|
||||||
"null"
|
|
||||||
]
|
|
||||||
},
|
|
||||||
"handled": {
|
|
||||||
"$ref": "#/definitions/JavaScriptDialogHandledAction"
|
|
||||||
},
|
|
||||||
"has_browser_handler": {
|
|
||||||
"type": [
|
|
||||||
"boolean",
|
|
||||||
"null"
|
|
||||||
]
|
|
||||||
},
|
|
||||||
"message": {
|
|
||||||
"type": "string"
|
|
||||||
},
|
|
||||||
"sequence": {
|
|
||||||
"description": "Monotonic per-tab sequence for ordering within a session.",
|
|
||||||
"type": "integer",
|
|
||||||
"format": "uint64",
|
|
||||||
"minimum": 0.0
|
|
||||||
},
|
|
||||||
"tab_id": {
|
|
||||||
"type": "integer",
|
|
||||||
"format": "int64"
|
|
||||||
},
|
|
||||||
"type": {
|
|
||||||
"$ref": "#/definitions/JavaScriptDialogType"
|
|
||||||
},
|
|
||||||
"url": {
|
|
||||||
"type": [
|
|
||||||
"string",
|
|
||||||
"null"
|
|
||||||
]
|
|
||||||
}
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"JavaScriptDialogType": {
|
|
||||||
"description": "Native JS dialog kind reported by CDP.",
|
|
||||||
"type": "string",
|
|
||||||
"enum": [
|
|
||||||
"alert",
|
|
||||||
"confirm",
|
|
||||||
"prompt",
|
|
||||||
"beforeunload"
|
|
||||||
]
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -79,12 +79,6 @@ fn main() {
|
|||||||
dump!(ClickResult, "tool_click_result");
|
dump!(ClickResult, "tool_click_result");
|
||||||
dump!(HoverParams, "tool_hover_params");
|
dump!(HoverParams, "tool_hover_params");
|
||||||
dump!(HoverResult, "tool_hover_result");
|
dump!(HoverResult, "tool_hover_result");
|
||||||
dump!(ScrollToParams, "tool_scroll_to_params");
|
|
||||||
dump!(ScrollToResult, "tool_scroll_to_result");
|
|
||||||
dump!(FocusParams, "tool_focus_params");
|
|
||||||
dump!(FocusResult, "tool_focus_result");
|
|
||||||
dump!(BlurParams, "tool_blur_params");
|
|
||||||
dump!(BlurResult, "tool_blur_result");
|
|
||||||
dump!(FillParams, "tool_fill_params");
|
dump!(FillParams, "tool_fill_params");
|
||||||
dump!(FillResult, "tool_fill_result");
|
dump!(FillResult, "tool_fill_result");
|
||||||
dump!(PressParams, "tool_press_params");
|
dump!(PressParams, "tool_press_params");
|
||||||
|
|||||||
@@ -72,12 +72,6 @@ pub enum Method {
|
|||||||
ToolClick,
|
ToolClick,
|
||||||
#[serde(rename = "tool.hover")]
|
#[serde(rename = "tool.hover")]
|
||||||
ToolHover,
|
ToolHover,
|
||||||
#[serde(rename = "tool.scroll_to")]
|
|
||||||
ToolScrollTo,
|
|
||||||
#[serde(rename = "tool.focus")]
|
|
||||||
ToolFocus,
|
|
||||||
#[serde(rename = "tool.blur")]
|
|
||||||
ToolBlur,
|
|
||||||
#[serde(rename = "tool.fill")]
|
#[serde(rename = "tool.fill")]
|
||||||
ToolFill,
|
ToolFill,
|
||||||
#[serde(rename = "tool.press")]
|
#[serde(rename = "tool.press")]
|
||||||
@@ -174,9 +168,6 @@ impl Method {
|
|||||||
| Method::ToolNavigateForward
|
| Method::ToolNavigateForward
|
||||||
| Method::ToolReload
|
| Method::ToolReload
|
||||||
| Method::ToolClick
|
| Method::ToolClick
|
||||||
| Method::ToolScrollTo
|
|
||||||
| Method::ToolFocus
|
|
||||||
| Method::ToolBlur
|
|
||||||
| Method::ToolFill
|
| Method::ToolFill
|
||||||
| Method::ToolPress
|
| Method::ToolPress
|
||||||
| Method::ToolSelect
|
| Method::ToolSelect
|
||||||
@@ -314,9 +305,6 @@ mod tests {
|
|||||||
assert!(Method::ToolNavigateForward.is_mutating());
|
assert!(Method::ToolNavigateForward.is_mutating());
|
||||||
assert!(Method::ToolReload.is_mutating());
|
assert!(Method::ToolReload.is_mutating());
|
||||||
assert!(Method::ToolClick.is_mutating());
|
assert!(Method::ToolClick.is_mutating());
|
||||||
assert!(Method::ToolScrollTo.is_mutating());
|
|
||||||
assert!(Method::ToolFocus.is_mutating());
|
|
||||||
assert!(Method::ToolBlur.is_mutating());
|
|
||||||
assert!(Method::ToolFill.is_mutating());
|
assert!(Method::ToolFill.is_mutating());
|
||||||
assert!(Method::ToolPress.is_mutating());
|
assert!(Method::ToolPress.is_mutating());
|
||||||
assert!(Method::ToolSelect.is_mutating());
|
assert!(Method::ToolSelect.is_mutating());
|
||||||
@@ -361,9 +349,6 @@ mod tests {
|
|||||||
assert_eq!(Method::ToolHover.effect(), MethodEffect::TransientInput);
|
assert_eq!(Method::ToolHover.effect(), MethodEffect::TransientInput);
|
||||||
assert_eq!(Method::ToolObserve.effect(), MethodEffect::TransientInput);
|
assert_eq!(Method::ToolObserve.effect(), MethodEffect::TransientInput);
|
||||||
assert_eq!(Method::ToolClick.effect(), MethodEffect::BrowserMutation);
|
assert_eq!(Method::ToolClick.effect(), MethodEffect::BrowserMutation);
|
||||||
assert_eq!(Method::ToolScrollTo.effect(), MethodEffect::BrowserMutation);
|
|
||||||
assert_eq!(Method::ToolFocus.effect(), MethodEffect::BrowserMutation);
|
|
||||||
assert_eq!(Method::ToolBlur.effect(), MethodEffect::BrowserMutation);
|
|
||||||
assert_eq!(Method::Cancel.effect(), MethodEffect::ControlPlane);
|
assert_eq!(Method::Cancel.effect(), MethodEffect::ControlPlane);
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -373,9 +358,6 @@ mod tests {
|
|||||||
assert!(Method::ToolHover.requires_interrupt_gate());
|
assert!(Method::ToolHover.requires_interrupt_gate());
|
||||||
assert!(Method::ToolObserve.requires_interrupt_gate());
|
assert!(Method::ToolObserve.requires_interrupt_gate());
|
||||||
assert!(Method::ToolClick.requires_interrupt_gate());
|
assert!(Method::ToolClick.requires_interrupt_gate());
|
||||||
assert!(Method::ToolScrollTo.requires_interrupt_gate());
|
|
||||||
assert!(Method::ToolFocus.requires_interrupt_gate());
|
|
||||||
assert!(Method::ToolBlur.requires_interrupt_gate());
|
|
||||||
assert!(!Method::Cancel.requires_interrupt_gate());
|
assert!(!Method::Cancel.requires_interrupt_gate());
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@@ -1,5 +1,5 @@
|
|||||||
//! DOM interaction tools (`tool.click`, `tool.hover`, `tool.focus`,
|
//! DOM interaction tools (`tool.click`, `tool.fill`, `tool.press`,
|
||||||
//! `tool.blur`, `tool.fill`, `tool.press`, `tool.select`).
|
//! `tool.select`).
|
||||||
//!
|
//!
|
||||||
//! Element-targeted tools accept either a snapshot `ref` (`@e<N>` form,
|
//! Element-targeted tools accept either a snapshot `ref` (`@e<N>` form,
|
||||||
//! normalised against the session's RefStore) **or** a CSS selector
|
//! normalised against the session's RefStore) **or** a CSS selector
|
||||||
@@ -131,82 +131,6 @@ pub struct HoverResult {
|
|||||||
pub dialogs: Vec<JavaScriptDialogInfo>,
|
pub dialogs: Vec<JavaScriptDialogInfo>,
|
||||||
}
|
}
|
||||||
|
|
||||||
// ---------------------------------------------------------------------------
|
|
||||||
// focus / blur
|
|
||||||
// ---------------------------------------------------------------------------
|
|
||||||
|
|
||||||
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize, JsonSchema)]
|
|
||||||
pub struct FocusParams {
|
|
||||||
pub session_id: String,
|
|
||||||
/// Optional `@e<N>` ref allocated by the last observation.
|
|
||||||
/// Mutually exclusive with `selector`.
|
|
||||||
#[serde(
|
|
||||||
rename = "ref",
|
|
||||||
alias = "ref_",
|
|
||||||
default,
|
|
||||||
skip_serializing_if = "Option::is_none"
|
|
||||||
)]
|
|
||||||
pub ref_: Option<String>,
|
|
||||||
#[serde(default, skip_serializing_if = "Option::is_none")]
|
|
||||||
pub selector: Option<String>,
|
|
||||||
/// Target tab. Defaults to the Agent Window's active tab.
|
|
||||||
#[serde(default, skip_serializing_if = "Option::is_none")]
|
|
||||||
pub tab_id: Option<i64>,
|
|
||||||
#[serde(default, skip_serializing_if = "Option::is_none")]
|
|
||||||
#[schemars(range(min = 1))]
|
|
||||||
pub timeout_ms: Option<u32>,
|
|
||||||
}
|
|
||||||
|
|
||||||
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize, JsonSchema)]
|
|
||||||
pub struct FocusResult {
|
|
||||||
pub tab_id: i64,
|
|
||||||
#[serde(default, skip_serializing_if = "Option::is_none")]
|
|
||||||
pub used_ref: Option<String>,
|
|
||||||
#[serde(default, skip_serializing_if = "Option::is_none")]
|
|
||||||
pub used_selector: Option<String>,
|
|
||||||
/// Whether the target holds DOM focus in its document or shadow root after the call.
|
|
||||||
pub focused: bool,
|
|
||||||
#[serde(default, skip_serializing_if = "Vec::is_empty")]
|
|
||||||
pub dialogs: Vec<JavaScriptDialogInfo>,
|
|
||||||
}
|
|
||||||
|
|
||||||
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize, JsonSchema)]
|
|
||||||
pub struct BlurParams {
|
|
||||||
pub session_id: String,
|
|
||||||
/// Optional `@e<N>` ref allocated by the last observation.
|
|
||||||
/// Mutually exclusive with `selector`.
|
|
||||||
#[serde(
|
|
||||||
rename = "ref",
|
|
||||||
alias = "ref_",
|
|
||||||
default,
|
|
||||||
skip_serializing_if = "Option::is_none"
|
|
||||||
)]
|
|
||||||
pub ref_: Option<String>,
|
|
||||||
#[serde(default, skip_serializing_if = "Option::is_none")]
|
|
||||||
pub selector: Option<String>,
|
|
||||||
/// Target tab. Defaults to the Agent Window's active tab.
|
|
||||||
#[serde(default, skip_serializing_if = "Option::is_none")]
|
|
||||||
pub tab_id: Option<i64>,
|
|
||||||
#[serde(default, skip_serializing_if = "Option::is_none")]
|
|
||||||
#[schemars(range(min = 1))]
|
|
||||||
pub timeout_ms: Option<u32>,
|
|
||||||
}
|
|
||||||
|
|
||||||
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize, JsonSchema)]
|
|
||||||
pub struct BlurResult {
|
|
||||||
pub tab_id: i64,
|
|
||||||
#[serde(default, skip_serializing_if = "Option::is_none")]
|
|
||||||
pub used_ref: Option<String>,
|
|
||||||
#[serde(default, skip_serializing_if = "Option::is_none")]
|
|
||||||
pub used_selector: Option<String>,
|
|
||||||
/// Whether the target held focus before the call.
|
|
||||||
pub was_focused: bool,
|
|
||||||
/// Always false for a successful blur; included for machine verification.
|
|
||||||
pub focused: bool,
|
|
||||||
#[serde(default, skip_serializing_if = "Vec::is_empty")]
|
|
||||||
pub dialogs: Vec<JavaScriptDialogInfo>,
|
|
||||||
}
|
|
||||||
|
|
||||||
// ---------------------------------------------------------------------------
|
// ---------------------------------------------------------------------------
|
||||||
// fill
|
// fill
|
||||||
// ---------------------------------------------------------------------------
|
// ---------------------------------------------------------------------------
|
||||||
@@ -401,37 +325,6 @@ mod tests {
|
|||||||
assert_eq!(round, p);
|
assert_eq!(round, p);
|
||||||
}
|
}
|
||||||
|
|
||||||
#[test]
|
|
||||||
fn focus_params_serialise_ref_field_name() {
|
|
||||||
let p = FocusParams {
|
|
||||||
session_id: "abcd".into(),
|
|
||||||
ref_: Some("@e4".into()),
|
|
||||||
selector: None,
|
|
||||||
tab_id: Some(42),
|
|
||||||
timeout_ms: Some(5_000),
|
|
||||||
};
|
|
||||||
let v = serde_json::to_value(&p).unwrap();
|
|
||||||
assert_eq!(v.get("ref").and_then(|v| v.as_str()), Some("@e4"));
|
|
||||||
assert!(v.get("ref_").is_none());
|
|
||||||
let round: FocusParams = serde_json::from_value(v).unwrap();
|
|
||||||
assert_eq!(round, p);
|
|
||||||
}
|
|
||||||
|
|
||||||
#[test]
|
|
||||||
fn blur_result_round_trips_focus_state() {
|
|
||||||
let result = BlurResult {
|
|
||||||
tab_id: 42,
|
|
||||||
used_ref: Some("e4".into()),
|
|
||||||
used_selector: None,
|
|
||||||
was_focused: true,
|
|
||||||
focused: false,
|
|
||||||
dialogs: vec![],
|
|
||||||
};
|
|
||||||
let value = serde_json::to_value(&result).unwrap();
|
|
||||||
let round: BlurResult = serde_json::from_value(value).unwrap();
|
|
||||||
assert_eq!(round, result);
|
|
||||||
}
|
|
||||||
|
|
||||||
#[test]
|
#[test]
|
||||||
fn modifiers_render_as_lowercase_strings() {
|
fn modifiers_render_as_lowercase_strings() {
|
||||||
let v = serde_json::to_value(KeyModifier::Ctrl).unwrap();
|
let v = serde_json::to_value(KeyModifier::Ctrl).unwrap();
|
||||||
|
|||||||
@@ -14,7 +14,6 @@ mod record_common;
|
|||||||
mod record_v2;
|
mod record_v2;
|
||||||
mod record_v3;
|
mod record_v3;
|
||||||
pub mod script;
|
pub mod script;
|
||||||
pub mod scroll;
|
|
||||||
pub mod session;
|
pub mod session;
|
||||||
pub mod tabs;
|
pub mod tabs;
|
||||||
pub mod waits;
|
pub mod waits;
|
||||||
@@ -31,7 +30,6 @@ pub use network::*;
|
|||||||
pub use observation::*;
|
pub use observation::*;
|
||||||
pub use record::*;
|
pub use record::*;
|
||||||
pub use script::*;
|
pub use script::*;
|
||||||
pub use scroll::*;
|
|
||||||
pub use session::*;
|
pub use session::*;
|
||||||
pub use tabs::*;
|
pub use tabs::*;
|
||||||
pub use waits::*;
|
pub use waits::*;
|
||||||
|
|||||||
@@ -1,67 +0,0 @@
|
|||||||
//! Element scrolling primitive (`tool.scroll_to`).
|
|
||||||
|
|
||||||
use schemars::JsonSchema;
|
|
||||||
use serde::{Deserialize, Serialize};
|
|
||||||
|
|
||||||
use super::JavaScriptDialogInfo;
|
|
||||||
|
|
||||||
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize, JsonSchema)]
|
|
||||||
pub struct ScrollToParams {
|
|
||||||
pub session_id: String,
|
|
||||||
/// Optional `@e<N>` ref allocated by the last observation.
|
|
||||||
/// Mutually exclusive with `selector`.
|
|
||||||
#[serde(
|
|
||||||
rename = "ref",
|
|
||||||
alias = "ref_",
|
|
||||||
default,
|
|
||||||
skip_serializing_if = "Option::is_none"
|
|
||||||
)]
|
|
||||||
pub ref_: Option<String>,
|
|
||||||
#[serde(default, skip_serializing_if = "Option::is_none")]
|
|
||||||
pub selector: Option<String>,
|
|
||||||
/// Target tab. Defaults to the Agent Window's active tab.
|
|
||||||
#[serde(default, skip_serializing_if = "Option::is_none")]
|
|
||||||
pub tab_id: Option<i64>,
|
|
||||||
#[serde(default, skip_serializing_if = "Option::is_none")]
|
|
||||||
#[schemars(range(min = 1))]
|
|
||||||
pub timeout_ms: Option<u32>,
|
|
||||||
}
|
|
||||||
|
|
||||||
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize, JsonSchema)]
|
|
||||||
pub struct ScrollToResult {
|
|
||||||
pub tab_id: i64,
|
|
||||||
#[serde(default, skip_serializing_if = "Option::is_none")]
|
|
||||||
pub used_ref: Option<String>,
|
|
||||||
#[serde(default, skip_serializing_if = "Option::is_none")]
|
|
||||||
pub used_selector: Option<String>,
|
|
||||||
/// Bounding rectangle of the element's visible border-box portion, in
|
|
||||||
/// top-level viewport CSS pixels, after ancestor and viewport clipping.
|
|
||||||
/// Partial visibility is sufficient. This is not an occlusion or hit test.
|
|
||||||
pub x: f64,
|
|
||||||
pub y: f64,
|
|
||||||
pub width: f64,
|
|
||||||
pub height: f64,
|
|
||||||
#[serde(default, skip_serializing_if = "Vec::is_empty")]
|
|
||||||
pub dialogs: Vec<JavaScriptDialogInfo>,
|
|
||||||
}
|
|
||||||
|
|
||||||
#[cfg(test)]
|
|
||||||
mod tests {
|
|
||||||
use super::*;
|
|
||||||
|
|
||||||
#[test]
|
|
||||||
fn params_serialise_ref_field_name() {
|
|
||||||
let params = ScrollToParams {
|
|
||||||
session_id: "abcd".into(),
|
|
||||||
ref_: Some("@e3".into()),
|
|
||||||
selector: None,
|
|
||||||
tab_id: Some(42),
|
|
||||||
timeout_ms: Some(5_000),
|
|
||||||
};
|
|
||||||
let value = serde_json::to_value(¶ms).unwrap();
|
|
||||||
assert_eq!(value.get("ref").and_then(|v| v.as_str()), Some("@e3"));
|
|
||||||
assert!(value.get("ref_").is_none());
|
|
||||||
let round: ScrollToParams = serde_json::from_value(value).unwrap();
|
|
||||||
assert_eq!(round, params);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -84,11 +84,6 @@ Shared Rust types + JSON Schema generation. TypeScript mirrors frame shapes in
|
|||||||
4. Extension dispatcher validates sandbox rules, invokes CDP via `BrowserDriver`.
|
4. Extension dispatcher validates sandbox rules, invokes CDP via `BrowserDriver`.
|
||||||
5. Response travels CLI ← daemon ← extension; CLI prints result and exits.
|
5. Response travels CLI ← daemon ← extension; CLI prints result and exits.
|
||||||
|
|
||||||
The [scroll-to primitive reference](scroll-to.md) documents `tool.scroll_to`,
|
|
||||||
including its CLI/plugin mappings, visible-bounds contract and cancellation
|
|
||||||
behavior. It follows the same routing path and is classified as a browser
|
|
||||||
mutation for session queueing and user-interruption gating.
|
|
||||||
|
|
||||||
## Session and sandbox model
|
## Session and sandbox model
|
||||||
|
|
||||||
- **Session** = opaque ID (4 lowercase letters in v0.1) + dedicated **Agent Window**
|
- **Session** = opaque ID (4 lowercase letters in v0.1) + dedicated **Agent Window**
|
||||||
|
|||||||
@@ -1,131 +0,0 @@
|
|||||||
# Scroll-to primitive
|
|
||||||
|
|
||||||
`scroll-to` brings an existing element and its containing frames into view, then
|
|
||||||
returns the visible portion's bounds. Use it to reveal a target before inspecting
|
|
||||||
the page or taking a screenshot. It accepts an element target rather than a pixel
|
|
||||||
distance or scroll direction.
|
|
||||||
|
|
||||||
| Entry point | Name |
|
|
||||||
| --- | --- |
|
|
||||||
| CLI | `bsk scroll-to` |
|
|
||||||
| Wire protocol | `tool.scroll_to` |
|
|
||||||
| DeepSeek Harness | `browser_interact` with `action: "scroll-to"` |
|
|
||||||
|
|
||||||
## CLI
|
|
||||||
|
|
||||||
Use a session you started and a fresh ref from an observation. The ids below are
|
|
||||||
examples; substitute the session, tab and ref returned by your own calls.
|
|
||||||
|
|
||||||
```sh
|
|
||||||
bsk scroll-to @e3 --session abcd --tab-id 42 --timeout 5s --json
|
|
||||||
bsk scroll-to --selector '#details' --session abcd
|
|
||||||
```
|
|
||||||
|
|
||||||
Supply exactly one target: a positional ref or selector, `--ref`, or `--selector`.
|
|
||||||
Refs accept `@e3` and `e3`. CSS selectors search only the main document; use refs
|
|
||||||
for elements in iframes (including out-of-process iframes) or shadow roots.
|
|
||||||
Refs belong to one session and tab and may become stale after page changes.
|
|
||||||
|
|
||||||
`--session` is required. `--tab-id` defaults to the Agent Window's active tab.
|
|
||||||
`--timeout` defaults to `30s` and must be positive; durations such as `5000ms` and
|
|
||||||
`5s` are accepted. The command operates on Agent Window tabs, including user tabs
|
|
||||||
explicitly borrowed into that window.
|
|
||||||
|
|
||||||
Example JSON output:
|
|
||||||
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"tab_id": 42,
|
|
||||||
"used_ref": "e3",
|
|
||||||
"x": 10,
|
|
||||||
"y": 20,
|
|
||||||
"width": 100,
|
|
||||||
"height": 80
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
`used_ref` or `used_selector` identifies the resolved target. The optional
|
|
||||||
`dialogs` array reports JavaScript dialogs handled during the call.
|
|
||||||
|
|
||||||
## Result contract
|
|
||||||
|
|
||||||
`x` and `y` are the upper-left corner, and `width` and `height` are the size of
|
|
||||||
the visible border-box portion's bounding rectangle. All four values use
|
|
||||||
**top-level viewport CSS pixels**, after scrolling and clipping by ancestor
|
|
||||||
containers and frame viewports. They are not document or screenshot pixel
|
|
||||||
coordinates.
|
|
||||||
|
|
||||||
Partial visibility is sufficient: a 400px-high element clipped by an 80px-high
|
|
||||||
scroll container can succeed with `height: 80`. Hidden or fully clipped targets
|
|
||||||
fail. The rectangle is not an occlusion or hit test: another element can cover
|
|
||||||
the target, and the rectangle's center is not a guaranteed click point. Layout
|
|
||||||
can change after the result; use fresh refs for subsequent interactions.
|
|
||||||
|
|
||||||
## Protocol and plugin
|
|
||||||
|
|
||||||
The CLI sends a normal request through the daemon to the extension:
|
|
||||||
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"id": "scroll-1",
|
|
||||||
"method": "tool.scroll_to",
|
|
||||||
"params": {
|
|
||||||
"session_id": "abcd",
|
|
||||||
"ref": "@e3",
|
|
||||||
"tab_id": 42,
|
|
||||||
"timeout_ms": 5000
|
|
||||||
}
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
Protocol callers must supply exactly one nonempty `ref` or `selector`.
|
|
||||||
`tab_id` is optional; `timeout_ms` is a positive integer and defaults to 30000.
|
|
||||||
These target constraints are enforced by the handler. See the generated
|
|
||||||
[parameter schema](../crates/bsk-protocol/schema/tool_scroll_to_params.json) and
|
|
||||||
[result schema](../crates/bsk-protocol/schema/tool_scroll_to_result.json) for field
|
|
||||||
types. The wire response wraps the result above in `{ "id": "scroll-1", "result": ... }`.
|
|
||||||
|
|
||||||
The plugin exposes the same action with its usual camelCase parameters:
|
|
||||||
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"action": "scroll-to",
|
|
||||||
"session": "abcd",
|
|
||||||
"target": "@e3",
|
|
||||||
"tabId": 42,
|
|
||||||
"timeoutMs": 5000
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
Call this through `browser_interact` using a plugin-owned session. Its result
|
|
||||||
contains `session`, `tabId`, `x`, `y`, `width` and `height` with the same bounds
|
|
||||||
semantics. Omitted `session` uses the plugin's current session.
|
|
||||||
|
|
||||||
## Errors and interruption
|
|
||||||
|
|
||||||
The wire response uses the normal `error.code`, `error.message` and optional
|
|
||||||
`error.data.reason` fields. Common cases are:
|
|
||||||
|
|
||||||
| Code | `data.reason` | Meaning |
|
|
||||||
| --- | --- | --- |
|
|
||||||
| `invalid_params` | — | Missing/conflicting target or invalid timeout/tab id |
|
|
||||||
| `not_found` | `ref_not_found` | Ref is unknown, expired or belongs to another tab |
|
|
||||||
| `not_found` | `selector_not_found` | Main-document selector matched no element |
|
|
||||||
| `permission_denied` | `agent_window_scope` | Target tab has not been borrowed into the Agent Window |
|
|
||||||
| `permission_denied` | `element_not_visible` | No visible area remains after scrolling |
|
|
||||||
| `cancelled` | — | The call was cancelled |
|
|
||||||
| `timeout` | — | The action deadline expired |
|
|
||||||
| `cdp_failed` | varies | Browser command, frame geometry or visibility measurement failed |
|
|
||||||
|
|
||||||
The protocol classifies scroll-to as a browser mutation, so it uses the existing
|
|
||||||
per-session queue and user-interruption gate. The extension releases any retained
|
|
||||||
hover state before dispatch. Cancellation and deadline checks surround each CDP
|
|
||||||
step, including frame lookup, scrolling and measurement. Once detected, they
|
|
||||||
prevent further scrolling and a successful response; remote-object cleanup still
|
|
||||||
runs. Already performed scrolling is not rolled back, so inspect the current
|
|
||||||
page before retrying an interrupted call.
|
|
||||||
|
|
||||||
The implementation is scoped to scroll-to: it reuses frame scrolling and
|
|
||||||
coordinate projection, with a separate visibility measurement that accounts for
|
|
||||||
ancestor clipping and hidden frame owners. Shared click, hover and screenshot
|
|
||||||
geometry is unchanged.
|
|
||||||
@@ -1,41 +0,0 @@
|
|||||||
# OOPIF occupied-scrollbar regression
|
|
||||||
|
|
||||||
An iframe's content quad includes its child viewport's scrollbar space, while
|
|
||||||
`Page.getLayoutMetrics().cssLayoutViewport` excludes that space. Mapping the latter
|
|
||||||
onto the whole quad stretches positions and sizes. The full target-local viewport
|
|
||||||
must determine scale; the visible viewport must still clip content at every OOPIF
|
|
||||||
boundary and constrain target-local action points.
|
|
||||||
|
|
||||||
This fixture alternates loopback hostnames across two nested OOPIFs. It includes
|
|
||||||
scrolling, borders, padding, scaled iframe owners, a partially clipped button and
|
|
||||||
a fully clipped button. Custom scrollbars occupy different widths and heights.
|
|
||||||
The `scrollbars` query parameter accepts `both` (default), `vertical`, `horizontal`
|
|
||||||
or `none`.
|
|
||||||
|
|
||||||
Run the numerical regression with Node 22+ and a local Chrome executable:
|
|
||||||
|
|
||||||
```sh
|
|
||||||
BSK_GEOMETRY_CHROME=/path/to/chrome pnpm --filter @browser-skill/extension exec vitest run \
|
|
||||||
src/tools/__tests__/snapshot-coordinates.browser.test.ts
|
|
||||||
```
|
|
||||||
|
|
||||||
The existing browser runner is shared with the snapshot-unit regression. The test:
|
|
||||||
|
|
||||||
- Verifies actual OOPIF targets and occupied scrollbar dimensions.
|
|
||||||
- Compares snapshot and live geometry with independent DOM rectangles and clipping.
|
|
||||||
- Dispatches real root-target clicks and verifies the intended frame/button received them.
|
|
||||||
- Rejects fully clipped controls and checks snapshot measurement reuse per target.
|
|
||||||
- Covers five device-scale/browser-zoom combinations plus single-axis and no-scrollbar cases.
|
|
||||||
|
|
||||||
The runner creates and removes isolated browser profiles. It is opt-in and skipped
|
|
||||||
in normal unit runs when `BSK_GEOMETRY_CHROME` is unset.
|
|
||||||
|
|
||||||
Run the CLI fixture smoke with a connected test extension:
|
|
||||||
|
|
||||||
```sh
|
|
||||||
BSK_AUTO_UPDATE=off pnpm eval:browser smoke --case oopif-scrollbars --bsk ./target/debug/bsk
|
|
||||||
```
|
|
||||||
|
|
||||||
The smoke assertions verify both nested frames have occupied scrollbars, that the
|
|
||||||
marker is observed and that the session is closed. Numeric geometry and actual
|
|
||||||
click assertions are exercised by the browser test above, not by smoke alone.
|
|
||||||
@@ -1,39 +0,0 @@
|
|||||||
{
|
|
||||||
"$schema": "../../../schemas/case.schema.json",
|
|
||||||
"schemaVersion": 1,
|
|
||||||
"id": "oopif-scrollbars",
|
|
||||||
"title": "Nested OOPIFs with occupied scrollbars and clipped controls",
|
|
||||||
"suite": "regression",
|
|
||||||
"tags": ["geometry", "iframe", "scroll"],
|
|
||||||
"fixture": { "startPath": "/oopif-scrollbars" },
|
|
||||||
"prompts": {
|
|
||||||
"en": "Open {url}, observe the page and its frames, report the OOPIF-SCROLLBARS marker, then close the session.",
|
|
||||||
"zh-CN": "打开 {url},观察页面及其 iframe,报告 OOPIF-SCROLLBARS 标记,然后关闭会话。"
|
|
||||||
},
|
|
||||||
"coverage": ["session.start", "session.stop", "page.navigate", "inspect.observe"],
|
|
||||||
"assertions": {
|
|
||||||
"site": [
|
|
||||||
{
|
|
||||||
"label": "nested frame fixture settled",
|
|
||||||
"type": "geometry.ready",
|
|
||||||
"where": { "data.root": true },
|
|
||||||
"minCount": 1
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"label": "both child frames have occupied scrollbars",
|
|
||||||
"type": "geometry.scrollbars",
|
|
||||||
"where": { "data.vertical": true, "data.horizontal": true },
|
|
||||||
"minCount": 2
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"response": [{ "label": "observed the fixture marker", "includes": "OOPIF-SCROLLBARS" }],
|
|
||||||
"adapter": [{ "label": "browser session was closed", "key": "sessionStopped" }]
|
|
||||||
},
|
|
||||||
"smoke": {
|
|
||||||
"steps": [
|
|
||||||
{ "action": "navigate" },
|
|
||||||
{ "action": "wait-site-event", "type": "geometry.ready", "where": { "root": true } },
|
|
||||||
{ "action": "observe" }
|
|
||||||
]
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,56 +0,0 @@
|
|||||||
import { page, withRun } from "../../../lib/fixtures.mjs";
|
|
||||||
|
|
||||||
export default {
|
|
||||||
id: "oopif-scrollbars",
|
|
||||||
routes: ["/oopif-scrollbars", "/oopif-scrollbars/frame", "/oopif-scrollbars/nested"],
|
|
||||||
render({ pathname, runId, query }) {
|
|
||||||
const root = pathname === "/oopif-scrollbars";
|
|
||||||
const nested = pathname.endsWith("/nested");
|
|
||||||
const mode = query.get("scrollbars") ?? "both";
|
|
||||||
return page({
|
|
||||||
title: "OOPIF scrollbar geometry regression",
|
|
||||||
body: `
|
|
||||||
<style>
|
|
||||||
main { margin: 0; width: auto; }
|
|
||||||
body { width: 2000px; height: 2400px; }
|
|
||||||
html { overflow-anchor: none; }
|
|
||||||
${!root ? `html { overflow-x: ${mode === "vertical" || mode === "none" ? "hidden" : "scroll"}; overflow-y: ${mode === "horizontal" || mode === "none" ? "hidden" : "scroll"}; } html::-webkit-scrollbar { width: 17px; height: 11px; }` : ""}
|
|
||||||
button { position: absolute; padding: 0; border: 0; border-radius: 0; }
|
|
||||||
#probe { left: ${root ? 180 : nested ? 30 : 100}px; top: ${root ? 360 : nested ? 40 : 160}px; width: 60px; height: 20px; }
|
|
||||||
#edge { position: fixed; right: -20px; bottom: -15px; width: 80px; height: 60px; }
|
|
||||||
#outside { position: fixed; left: calc(100% + 2px); top: calc(100% + 2px); width: 10px; height: 10px; }
|
|
||||||
iframe { position: absolute; box-sizing: content-box; width: 420px; height: 320px;
|
|
||||||
left: 340px; top: 400px; border: 6px solid black; padding: 8px; transform: scale(1.2); transform-origin: 0 0; }
|
|
||||||
#nested { left: 150px; top: 210px; width: 200px; height: 120px; border-width: 4px; padding: 6px; transform: scale(0.8); }
|
|
||||||
</style>
|
|
||||||
<button id="probe" data-geometry-probe>OOPIF-SCROLLBARS</button>
|
|
||||||
${!root ? '<button id="edge" data-geometry-probe>EDGE</button><button id="outside" data-geometry-probe>OUTSIDE</button>' : ""}
|
|
||||||
${!nested ? `<iframe id="${root ? "cross" : "nested"}" name="${root ? "cross" : "nested"}" title="${root ? "outer" : "nested"} cross-site frame"></iframe>` : ""}
|
|
||||||
`,
|
|
||||||
script: `
|
|
||||||
history.scrollRestoration = "manual";
|
|
||||||
const child = document.querySelector("iframe");
|
|
||||||
if (child) {
|
|
||||||
const url = new URL(${JSON.stringify(withRun(root ? "/oopif-scrollbars/frame" : "/oopif-scrollbars/nested", runId, { scrollbars: mode }))}, location.href);
|
|
||||||
url.hostname = location.hostname === "127.0.0.1" ? "localhost" : "127.0.0.1";
|
|
||||||
child.src = url.href;
|
|
||||||
}
|
|
||||||
document.addEventListener("click", event => {
|
|
||||||
const probe = event.target.closest("[data-geometry-probe]");
|
|
||||||
if (probe) browserEval.send("geometry.clicked", { probe: probe.id });
|
|
||||||
});
|
|
||||||
window.addEventListener("load", () => {
|
|
||||||
scrollTo(${root ? "80, 240" : nested ? "10, 20" : "40, 100"});
|
|
||||||
requestAnimationFrame(() => requestAnimationFrame(() => {
|
|
||||||
document.documentElement.dataset.geometryReady = "true";
|
|
||||||
if (!${root}) browserEval.send("geometry.scrollbars", {
|
|
||||||
vertical: innerWidth > document.documentElement.clientWidth,
|
|
||||||
horizontal: innerHeight > document.documentElement.clientHeight,
|
|
||||||
});
|
|
||||||
browserEval.send("geometry.ready", { root: ${root} });
|
|
||||||
}));
|
|
||||||
});
|
|
||||||
`,
|
|
||||||
});
|
|
||||||
},
|
|
||||||
};
|
|
||||||
@@ -1,41 +0,0 @@
|
|||||||
# DOMSnapshot layout-unit regression (#195)
|
|
||||||
|
|
||||||
Source: https://github.com/Tencent/BrowserSkill/pull/195
|
|
||||||
|
|
||||||
DOMSnapshot bounds and document scroll offsets retain Blink layout units. Treating them as CSS
|
|
||||||
pixels changes both positions and sizes under device scaling/browser zoom, before iframe
|
|
||||||
projection or viewport clipping even starts.
|
|
||||||
|
|
||||||
The fixture contains a scrolled root, a scrolled same-process iframe, an OOPIF served from the
|
|
||||||
other loopback hostname, and a nested iframe in each. Owners have borders, padding and CSS
|
|
||||||
transforms. The geometry test compares the production capture's local and top-level rectangles
|
|
||||||
against independent DOM border boxes, with at most 2 CSS pixels of layout rounding. It also
|
|
||||||
checks that each target reads layout metrics only once. No credentials or personal tabs are used.
|
|
||||||
|
|
||||||
Run the geometric assertions with Node 22+ and a local Chrome executable:
|
|
||||||
|
|
||||||
```sh
|
|
||||||
BSK_GEOMETRY_CHROME=/path/to/chrome pnpm --filter @browser-skill/extension exec vitest run \
|
|
||||||
src/tools/__tests__/snapshot-coordinates.browser.test.ts
|
|
||||||
```
|
|
||||||
|
|
||||||
The test launches and cleans up its own headless Chrome profiles. It explicitly verifies the
|
|
||||||
requested browser zoom and OOPIF topology, so unsupported setups fail rather than silently
|
|
||||||
testing a different configuration. It is skipped in ordinary unit runs unless the executable
|
|
||||||
is specified. No browser download or new package dependency is required.
|
|
||||||
|
|
||||||
The corpus smoke case checks fixture readiness and observable semantics through the real CLI:
|
|
||||||
|
|
||||||
```sh
|
|
||||||
BSK_AUTO_UPDATE=off pnpm eval:browser smoke --case snapshot-coordinates --bsk ./target/debug/bsk
|
|
||||||
```
|
|
||||||
|
|
||||||
Smoke alone does **not** certify coordinate accuracy; CLI observations do not expose raw boxes.
|
|
||||||
Use the geometric test above for the regression's numeric assertions.
|
|
||||||
|
|
||||||
## Related scrollbar regression
|
|
||||||
|
|
||||||
The unit-conversion fixture keeps non-occupying OOPIF scrollbars by default. The same
|
|
||||||
browser test also runs the dedicated [OOPIF scrollbar fixture](../oopif-scrollbars/README.md),
|
|
||||||
which covers occupied scrollbars, two OOPIF boundaries, clipping and real clicks.
|
|
||||||
Append `&classic-scrollbars` to this fixture's URL to enable its normal OOPIF scrollbars.
|
|
||||||
@@ -1,99 +0,0 @@
|
|||||||
import { spawn } from "node:child_process";
|
|
||||||
import { once } from "node:events";
|
|
||||||
import { mkdir, mkdtemp, rm, writeFile } from "node:fs/promises";
|
|
||||||
import { tmpdir } from "node:os";
|
|
||||||
import { join } from "node:path";
|
|
||||||
|
|
||||||
// This regression owns its browser/profile. It never attaches to a user's Chrome.
|
|
||||||
export async function withChrome({ executable, deviceScale, zoom }, run) {
|
|
||||||
const profile = await mkdtemp(join(tmpdir(), "bsk-snapshot-coordinates-"));
|
|
||||||
let chrome;
|
|
||||||
let socket;
|
|
||||||
const pending = new Map();
|
|
||||||
try {
|
|
||||||
await mkdir(join(profile, "Default"));
|
|
||||||
await writeFile(
|
|
||||||
join(profile, "Default", "Preferences"),
|
|
||||||
JSON.stringify({
|
|
||||||
partition: { default_zoom_level: { x: Math.log(zoom) / Math.log(1.2) } },
|
|
||||||
}),
|
|
||||||
);
|
|
||||||
chrome = spawn(
|
|
||||||
executable,
|
|
||||||
[
|
|
||||||
"--headless=new",
|
|
||||||
"--no-first-run",
|
|
||||||
"--no-default-browser-check",
|
|
||||||
"--disable-extensions",
|
|
||||||
"--site-per-process",
|
|
||||||
"--remote-debugging-port=0",
|
|
||||||
"--window-size=1600,1200",
|
|
||||||
`--force-device-scale-factor=${deviceScale}`,
|
|
||||||
`--user-data-dir=${profile}`,
|
|
||||||
"about:blank",
|
|
||||||
],
|
|
||||||
{ stdio: ["ignore", "ignore", "pipe"] },
|
|
||||||
);
|
|
||||||
const endpoint = await new Promise((resolve, reject) => {
|
|
||||||
let output = "";
|
|
||||||
const timeout = setTimeout(
|
|
||||||
() => reject(new Error(`Chrome startup timed out: ${output}`)),
|
|
||||||
15_000,
|
|
||||||
);
|
|
||||||
const fail = (error) => {
|
|
||||||
clearTimeout(timeout);
|
|
||||||
reject(error);
|
|
||||||
};
|
|
||||||
chrome.once("error", fail);
|
|
||||||
chrome.once("exit", (code) => fail(new Error(`Chrome exited (${code}): ${output}`)));
|
|
||||||
chrome.stderr.on("data", (chunk) => {
|
|
||||||
output += chunk;
|
|
||||||
const match = output.match(/DevTools listening on (ws:\/\/\S+)/);
|
|
||||||
if (match) {
|
|
||||||
clearTimeout(timeout);
|
|
||||||
resolve(match[1]);
|
|
||||||
}
|
|
||||||
});
|
|
||||||
});
|
|
||||||
socket = new WebSocket(endpoint);
|
|
||||||
await new Promise((resolve, reject) => {
|
|
||||||
socket.addEventListener("open", resolve, { once: true });
|
|
||||||
socket.addEventListener("error", reject, { once: true });
|
|
||||||
});
|
|
||||||
socket.addEventListener("message", ({ data }) => {
|
|
||||||
const reply = JSON.parse(data);
|
|
||||||
const request = pending.get(reply.id);
|
|
||||||
if (!request) return;
|
|
||||||
clearTimeout(request.timeout);
|
|
||||||
pending.delete(reply.id);
|
|
||||||
if (reply.error) request.reject(new Error(JSON.stringify(reply.error)));
|
|
||||||
else request.resolve(reply.result);
|
|
||||||
});
|
|
||||||
let sequence = 0;
|
|
||||||
const send = (method, params = {}, sessionId) =>
|
|
||||||
new Promise((resolve, reject) => {
|
|
||||||
const id = ++sequence;
|
|
||||||
const timeout = setTimeout(() => {
|
|
||||||
pending.delete(id);
|
|
||||||
reject(new Error(`CDP timed out: ${method}`));
|
|
||||||
}, 10_000);
|
|
||||||
pending.set(id, { resolve, reject, timeout });
|
|
||||||
socket.send(JSON.stringify({ id, method, params, sessionId }));
|
|
||||||
});
|
|
||||||
await run(send);
|
|
||||||
} finally {
|
|
||||||
for (const request of pending.values()) {
|
|
||||||
clearTimeout(request.timeout);
|
|
||||||
request.reject(new Error("regression browser closed"));
|
|
||||||
}
|
|
||||||
socket?.close();
|
|
||||||
if (chrome && chrome.exitCode === null && chrome.signalCode === null) {
|
|
||||||
const exited = once(chrome, "exit");
|
|
||||||
const timeout = setTimeout(() => chrome.kill("SIGKILL"), 5_000);
|
|
||||||
chrome.kill();
|
|
||||||
await exited;
|
|
||||||
clearTimeout(timeout);
|
|
||||||
}
|
|
||||||
await rm(profile, { recursive: true, force: true });
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,33 +0,0 @@
|
|||||||
{
|
|
||||||
"$schema": "../../../schemas/case.schema.json",
|
|
||||||
"schemaVersion": 1,
|
|
||||||
"id": "snapshot-coordinates",
|
|
||||||
"title": "Scrolled and nested frame coordinate fixture",
|
|
||||||
"suite": "regression",
|
|
||||||
"tags": ["geometry", "iframe", "scroll"],
|
|
||||||
"fixture": { "startPath": "/snapshot-coordinates" },
|
|
||||||
"prompts": {
|
|
||||||
"en": "Open {url}, observe the page and its frames, report the GEOMETRY marker, then close the session.",
|
|
||||||
"zh-CN": "打开 {url},观察页面及其 iframe,报告 GEOMETRY 标记,然后关闭会话。"
|
|
||||||
},
|
|
||||||
"coverage": ["session.start", "session.stop", "page.navigate", "inspect.observe"],
|
|
||||||
"assertions": {
|
|
||||||
"site": [
|
|
||||||
{
|
|
||||||
"label": "root fixture scrolled and settled",
|
|
||||||
"type": "geometry.ready",
|
|
||||||
"where": { "data.root": true },
|
|
||||||
"minCount": 1
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"response": [{ "label": "observed the fixture marker", "includes": "GEOMETRY-195" }],
|
|
||||||
"adapter": [{ "label": "browser session was closed", "key": "sessionStopped" }]
|
|
||||||
},
|
|
||||||
"smoke": {
|
|
||||||
"steps": [
|
|
||||||
{ "action": "navigate" },
|
|
||||||
{ "action": "wait-site-event", "type": "geometry.ready", "where": { "root": true } },
|
|
||||||
{ "action": "observe" }
|
|
||||||
]
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,52 +0,0 @@
|
|||||||
import { page, withRun } from "../../../lib/fixtures.mjs";
|
|
||||||
|
|
||||||
export default {
|
|
||||||
id: "snapshot-coordinates",
|
|
||||||
routes: ["/snapshot-coordinates", "/snapshot-coordinates/frame", "/snapshot-coordinates/nested"],
|
|
||||||
render({ pathname, runId, query }) {
|
|
||||||
const root = pathname === "/snapshot-coordinates";
|
|
||||||
const nested = pathname.endsWith("/nested");
|
|
||||||
return page({
|
|
||||||
title: "Snapshot coordinate regression",
|
|
||||||
body: `
|
|
||||||
<style>
|
|
||||||
main { margin: 0; width: auto; }
|
|
||||||
body { width: 2000px; height: 2400px; }
|
|
||||||
html { overflow-anchor: none; }
|
|
||||||
${query.get("scrollbars") === "none" ? "html { scrollbar-width: none; }" : ""}
|
|
||||||
button { position: absolute; box-sizing: border-box; padding: 0; border: 2px solid black; border-radius: 0; }
|
|
||||||
#probe { left: ${root ? 180 : 100}px; top: ${root ? 360 : 160}px; width: 120px; height: 40px; }
|
|
||||||
iframe { position: absolute; box-sizing: content-box; width: 320px; height: 220px;
|
|
||||||
border: 6px solid black; padding: 8px; transform: scale(1.25); transform-origin: 0 0; }
|
|
||||||
#same { left: 340px; top: 400px; }
|
|
||||||
#cross { left: 820px; top: 400px; }
|
|
||||||
#nested { left: 150px; top: 210px; width: 130px; height: 70px; border-width: 2px; padding: 4px; transform: scale(0.8); }
|
|
||||||
${nested ? "#probe { left: 30px; top: 40px; width: 60px; height: 20px; }" : ""}
|
|
||||||
</style>
|
|
||||||
<button id="probe" data-geometry-probe>GEOMETRY-195</button>
|
|
||||||
${root ? `<iframe id="same" name="same" title="same-process frame" src="${withRun("/snapshot-coordinates/frame", runId)}"></iframe><iframe id="cross" name="cross" title="cross-site frame"></iframe>` : ""}
|
|
||||||
${!root && !nested ? `<iframe id="nested" name="nested" title="nested frame" src="${withRun("/snapshot-coordinates/nested", runId)}"></iframe>` : ""}
|
|
||||||
`,
|
|
||||||
script: `
|
|
||||||
history.scrollRestoration = "manual";
|
|
||||||
const cross = document.querySelector("#cross");
|
|
||||||
if (cross) {
|
|
||||||
const url = new URL(${JSON.stringify(withRun("/snapshot-coordinates/frame", runId))}, location.href);
|
|
||||||
url.hostname = location.hostname === "127.0.0.1" ? "localhost" : "127.0.0.1";
|
|
||||||
// Isolate unit conversion from the pre-existing OOPIF scrollbar-width
|
|
||||||
// projection issue. ?classic-scrollbars retains that separate reproduction.
|
|
||||||
if (!new URLSearchParams(location.search).has("classic-scrollbars")) url.searchParams.set("scrollbars", "none");
|
|
||||||
cross.src = url.href;
|
|
||||||
}
|
|
||||||
window.addEventListener("load", () => {
|
|
||||||
scrollTo(${root ? "80, 240" : nested ? "10, 20" : "40, 100"});
|
|
||||||
requestAnimationFrame(() => requestAnimationFrame(() => {
|
|
||||||
window.geometryReady = true;
|
|
||||||
document.documentElement.dataset.geometryReady = "true";
|
|
||||||
browserEval.send("geometry.ready", { root: ${root} });
|
|
||||||
}));
|
|
||||||
});
|
|
||||||
`,
|
|
||||||
});
|
|
||||||
},
|
|
||||||
};
|
|
||||||
@@ -41,23 +41,17 @@ test("case manifests are discovered, ordered, and grouped into suites", () => {
|
|||||||
"diagnostics",
|
"diagnostics",
|
||||||
"mobile-emulation",
|
"mobile-emulation",
|
||||||
"generated-form",
|
"generated-form",
|
||||||
"oopif-scrollbars",
|
|
||||||
"snapshot-coordinates",
|
|
||||||
],
|
],
|
||||||
);
|
);
|
||||||
assert.deepEqual(repositorySummary(cases, fixtureRegistry).suites, {
|
assert.deepEqual(repositorySummary(cases, fixtureRegistry).suites, { core: 6, matrix: 1 });
|
||||||
core: 6,
|
|
||||||
matrix: 1,
|
|
||||||
regression: 2,
|
|
||||||
});
|
|
||||||
});
|
});
|
||||||
|
|
||||||
test("repository validation links every case to a fixture and valid workflow evidence", () => {
|
test("repository validation links every case to a fixture and valid workflow evidence", () => {
|
||||||
assert.deepEqual(validateRepositoryCases(cases, fixtureRegistry), []);
|
assert.deepEqual(validateRepositoryCases(cases, fixtureRegistry), []);
|
||||||
const summary = repositorySummary(cases, fixtureRegistry);
|
const summary = repositorySummary(cases, fixtureRegistry);
|
||||||
assert.equal(summary.cases, 9);
|
assert.equal(summary.cases, 7);
|
||||||
assert.equal(summary.fixtureModules, 10);
|
assert.equal(summary.fixtureModules, 8);
|
||||||
assert.equal(summary.fixtureRoutes, 18);
|
assert.equal(summary.fixtureRoutes, 12);
|
||||||
});
|
});
|
||||||
|
|
||||||
test("manifest validation rejects unknown operations and incomplete workflow steps", () => {
|
test("manifest validation rejects unknown operations and incomplete workflow steps", () => {
|
||||||
|
|||||||
@@ -54,13 +54,10 @@ the `bsk` CLI and browser extension separately when a release requires it.
|
|||||||
| `browser_session` | `start`, `stop`, `list` | Manage plugin-owned Agent Window sessions. |
|
| `browser_session` | `start`, `stop`, `list` | Manage plugin-owned Agent Window sessions. |
|
||||||
| `browser_page` | `navigate`, `back`, `forward`, `reload`, `wait` | Navigate the active tab and wait for page lifecycle events. |
|
| `browser_page` | `navigate`, `back`, `forward`, `reload`, `wait` | Navigate the active tab and wait for page lifecycle events. |
|
||||||
| `browser_inspect` | `observe`, `snapshot`, `html`, `screenshot`, `console`, `network` | Read semantic or diagnostic page state and capture screenshots. |
|
| `browser_inspect` | `observe`, `snapshot`, `html`, `screenshot`, `console`, `network` | Read semantic or diagnostic page state and capture screenshots. |
|
||||||
| `browser_interact` | `click`, `hover`, `scroll-to`, `focus`, `blur`, `fill`, `select`, `press` | Interact with controls using fresh refs or selectors. |
|
| `browser_interact` | `click`, `hover`, `fill`, `select`, `press` | Interact with controls using fresh refs or selectors. |
|
||||||
| `browser_tabs` | `list`, `create`, `select`, `close`, `borrow`, `return` | Manage Agent Window tabs and temporarily borrow user tabs. |
|
| `browser_tabs` | `list`, `create`, `select`, `close`, `borrow`, `return` | Manage Agent Window tabs and temporarily borrow user tabs. |
|
||||||
| `browser_assist` | `resize`, `emulate`, `request-help` | Resize or emulate the browser and pause for human-only steps. |
|
| `browser_assist` | `resize`, `emulate`, `request-help` | Resize or emulate the browser and pause for human-only steps. |
|
||||||
|
|
||||||
For `browser_interact` with `action: "scroll-to"`, see the
|
|
||||||
[scroll-to reference](../../docs/scroll-to.md) for parameters, visible bounds and errors.
|
|
||||||
|
|
||||||
Arbitrary page-script evaluation and interaction recording are not supported.
|
Arbitrary page-script evaluation and interaction recording are not supported.
|
||||||
|
|
||||||
## Multi-session model
|
## Multi-session model
|
||||||
|
|||||||
@@ -1,7 +1,7 @@
|
|||||||
{
|
{
|
||||||
"name": "@wxg-prc-cpg/browser-skill-dsh-plugin",
|
"name": "@wxg-prc-cpg/browser-skill-dsh-plugin",
|
||||||
"description": "DeepSeek Harness tool plugin that exposes BrowserSkill browser automation (browser_* tools) to the model",
|
"description": "DeepSeek Harness tool plugin that exposes BrowserSkill browser automation (browser_* tools) to the model",
|
||||||
"version": "0.2.1",
|
"version": "0.2.0",
|
||||||
"license": "MIT",
|
"license": "MIT",
|
||||||
"publishConfig": {
|
"publishConfig": {
|
||||||
"access": "public",
|
"access": "public",
|
||||||
|
|||||||
@@ -51,13 +51,8 @@ Use `browser_inspect` action `observe` as the primary semantic page view. It ret
|
|||||||
text, and `@eN` refs. Prefer fresh refs over raw selectors. Refs invalidate after navigation and may
|
text, and `@eN` refs. Prefer fresh refs over raw selectors. Refs invalidate after navigation and may
|
||||||
also become stale after large DOM changes, so observe again before the next interaction.
|
also become stale after large DOM changes, so observe again before the next interaction.
|
||||||
|
|
||||||
Use `browser_interact` with `action=scroll-to` to bring an element into view. Its bounds are the
|
Use `browser_interact` for click, hover, fill, select, and key actions. An observation marks a
|
||||||
visible border-box portion in top-level viewport CSS pixels after ancestor clipping; partial
|
hover-only surface as `@e1 button "Products" [hover first: Shoes | Bags]`. The listed items are
|
||||||
visibility is enough. Hidden or fully clipped targets fail. This does not test occlusion by other
|
|
||||||
elements. Use fresh element refs for iframe/shadow-root targets; selectors search the main document.
|
|
||||||
|
|
||||||
Use `browser_interact` for click, hover, scroll-to, focus, blur, fill, select, and key actions. Focus and blur
|
|
||||||
explicitly enter or leave UI states triggered by focus changes. An observation marks a hover-only surface as `@e1 button "Products" [hover first: Shoes | Bags]`. The listed items are
|
|
||||||
labels, not usable refs: hover the trigger, observe again, then act on the revealed item's own ref.
|
labels, not usable refs: hover the trigger, observe again, then act on the revealed item's own ref.
|
||||||
Do not click the trigger itself unless the user wants the trigger's action.
|
Do not click the trigger itself unless the user wants the trigger's action.
|
||||||
|
|
||||||
|
|||||||
@@ -167,15 +167,12 @@ const BROWSER_TOOL_SPECS: BrowserToolSpec[] = [
|
|||||||
{
|
{
|
||||||
name: "browser_interact",
|
name: "browser_interact",
|
||||||
description:
|
description:
|
||||||
"Interact with an element in the active Agent Window tab. Actions: click, hover, scroll-to, focus, blur, fill, select, " +
|
"Interact with an element in the active Agent Window tab. Actions: click, hover, fill, select, " +
|
||||||
"press. click/hover/scroll-to/focus/blur/fill/select require target; fill also requires value; select requires " +
|
"press. click/hover/fill/select require target; fill also requires value; select requires " +
|
||||||
"values; press requires key and may optionally focus target first.",
|
"values; press requires key and may optionally focus target first.",
|
||||||
actions: {
|
actions: {
|
||||||
click: "interact.click",
|
click: "interact.click",
|
||||||
hover: "interact.hover",
|
hover: "interact.hover",
|
||||||
"scroll-to": "interact.scroll-to",
|
|
||||||
focus: "interact.focus",
|
|
||||||
blur: "interact.blur",
|
|
||||||
fill: "interact.fill",
|
fill: "interact.fill",
|
||||||
select: "interact.select",
|
select: "interact.select",
|
||||||
press: "interact.press",
|
press: "interact.press",
|
||||||
|
|||||||
@@ -562,10 +562,6 @@ export function actionForLabel(label: string): string {
|
|||||||
return "clicking";
|
return "clicking";
|
||||||
case "hover":
|
case "hover":
|
||||||
return "hovering";
|
return "hovering";
|
||||||
case "focus":
|
|
||||||
return "focusing";
|
|
||||||
case "blur":
|
|
||||||
return "blurring";
|
|
||||||
case "fill":
|
case "fill":
|
||||||
return "filling";
|
return "filling";
|
||||||
case "select":
|
case "select":
|
||||||
|
|||||||
@@ -13,7 +13,7 @@ import type { ToolDeps } from "./tools";
|
|||||||
|
|
||||||
const MODIFIERS = ["alt", "ctrl", "meta", "shift"] as const;
|
const MODIFIERS = ["alt", "ctrl", "meta", "shift"] as const;
|
||||||
|
|
||||||
/** Add interaction primitives without bypassing session ownership or observation. */
|
/** Add hover and select without bypassing session ownership or observation. */
|
||||||
export function registerPhaseOneInteractionTools(
|
export function registerPhaseOneInteractionTools(
|
||||||
deps: ToolDeps,
|
deps: ToolDeps,
|
||||||
register: ToolRegistrar,
|
register: ToolRegistrar,
|
||||||
@@ -100,171 +100,6 @@ export function registerPhaseOneInteractionTools(
|
|||||||
}),
|
}),
|
||||||
);
|
);
|
||||||
|
|
||||||
register(
|
|
||||||
defineTool({
|
|
||||||
name: "interact.scroll-to",
|
|
||||||
description:
|
|
||||||
"Scroll an element and its frame owners into view. Returns the visible portion's " +
|
|
||||||
"bounds in top-level viewport CSS pixels; fails if no visible area remains. " +
|
|
||||||
"Use a fresh ref for iframe targets; selectors search the main document.",
|
|
||||||
parameters: {
|
|
||||||
target: {
|
|
||||||
type: "string",
|
|
||||||
required: true,
|
|
||||||
description: "Element ref (@e3 / e3) or main-document CSS selector to scroll into view.",
|
|
||||||
},
|
|
||||||
session: SESSION_PARAM,
|
|
||||||
tabId: TAB_ID_PARAM,
|
|
||||||
timeoutMs: TIMEOUT_MS_PARAM,
|
|
||||||
},
|
|
||||||
output: {
|
|
||||||
schema: {
|
|
||||||
type: "object",
|
|
||||||
additionalProperties: false,
|
|
||||||
properties: {
|
|
||||||
session: { type: "string", required: true },
|
|
||||||
tabId: { type: "integer", required: true },
|
|
||||||
x: { type: "number", required: true },
|
|
||||||
y: { type: "number", required: true },
|
|
||||||
width: { type: "number", required: true },
|
|
||||||
height: { type: "number", required: true },
|
|
||||||
},
|
|
||||||
},
|
|
||||||
render: (_args, value) => [
|
|
||||||
{
|
|
||||||
type: "text",
|
|
||||||
text:
|
|
||||||
`[session ${value.session}] scrolled into view on tab ${value.tabId}: ` +
|
|
||||||
`(${value.x}, ${value.y}, ${value.width}, ${value.height})`,
|
|
||||||
},
|
|
||||||
],
|
|
||||||
},
|
|
||||||
async execute(args, exec) {
|
|
||||||
requireNonEmpty(args.target, "target");
|
|
||||||
requirePositive(args.timeoutMs, "timeoutMs");
|
|
||||||
const sessionId = registry.resolve(args.session, "browser_interact(action=scroll-to)");
|
|
||||||
const cmdArgs = ["scroll-to", "--session", sessionId];
|
|
||||||
appendTabId(cmdArgs, args.tabId);
|
|
||||||
if (args.timeoutMs !== undefined) cmdArgs.push("--timeout", `${args.timeoutMs}ms`);
|
|
||||||
appendTarget(cmdArgs, args.target);
|
|
||||||
const reply = (await runtime.run(
|
|
||||||
exec,
|
|
||||||
cmdArgs,
|
|
||||||
"scroll-to",
|
|
||||||
sessionId,
|
|
||||||
runnerTimeout(deps, args.timeoutMs),
|
|
||||||
)) as {
|
|
||||||
tab_id: number;
|
|
||||||
x: number;
|
|
||||||
y: number;
|
|
||||||
width: number;
|
|
||||||
height: number;
|
|
||||||
};
|
|
||||||
return {
|
|
||||||
session: sessionId,
|
|
||||||
tabId: reply.tab_id,
|
|
||||||
x: reply.x,
|
|
||||||
y: reply.y,
|
|
||||||
width: reply.width,
|
|
||||||
height: reply.height,
|
|
||||||
};
|
|
||||||
},
|
|
||||||
presentCall: (args) => ({
|
|
||||||
card: "terminal",
|
|
||||||
title: runtime.commandLine([
|
|
||||||
"scroll-to",
|
|
||||||
args.target,
|
|
||||||
"--session",
|
|
||||||
args.session ?? "(current)",
|
|
||||||
]),
|
|
||||||
description: "Scroll an element into view",
|
|
||||||
}),
|
|
||||||
presentResult: runtime.presentTerminalResult,
|
|
||||||
}),
|
|
||||||
);
|
|
||||||
|
|
||||||
for (const action of ["focus", "blur"] as const) {
|
|
||||||
register(
|
|
||||||
defineTool({
|
|
||||||
name: `interact.${action}`,
|
|
||||||
description:
|
|
||||||
action === "focus"
|
|
||||||
? "Focus an element and verify its DOM focus state."
|
|
||||||
: "Remove focus from an element and report whether it was focused.",
|
|
||||||
parameters: {
|
|
||||||
target: {
|
|
||||||
type: "string",
|
|
||||||
required: true,
|
|
||||||
description: "Snapshot ref (@e3 / e3) or CSS selector of the element.",
|
|
||||||
},
|
|
||||||
session: SESSION_PARAM,
|
|
||||||
tabId: TAB_ID_PARAM,
|
|
||||||
timeoutMs: TIMEOUT_MS_PARAM,
|
|
||||||
},
|
|
||||||
output: {
|
|
||||||
schema: {
|
|
||||||
type: "object",
|
|
||||||
additionalProperties: false,
|
|
||||||
properties: {
|
|
||||||
session: { type: "string", required: true },
|
|
||||||
tabId: { type: "integer", required: true },
|
|
||||||
focused: { type: "boolean", required: true },
|
|
||||||
wasFocused: {
|
|
||||||
type: "boolean",
|
|
||||||
description: "Whether the target was focused before blur.",
|
|
||||||
},
|
|
||||||
},
|
|
||||||
},
|
|
||||||
render: (_args, value) => [
|
|
||||||
{
|
|
||||||
type: "text",
|
|
||||||
text:
|
|
||||||
`[session ${value.session}] ${action} on tab ${value.tabId}: focused=${value.focused}` +
|
|
||||||
(value.wasFocused === undefined ? "" : `, wasFocused=${value.wasFocused}`),
|
|
||||||
},
|
|
||||||
],
|
|
||||||
},
|
|
||||||
async execute(args, exec) {
|
|
||||||
requireNonEmpty(args.target, "target");
|
|
||||||
requirePositive(args.timeoutMs, "timeoutMs");
|
|
||||||
const sessionId = registry.resolve(args.session, `browser_interact(action=${action})`);
|
|
||||||
const cmdArgs = [action, "--session", sessionId];
|
|
||||||
appendTabId(cmdArgs, args.tabId);
|
|
||||||
if (args.timeoutMs !== undefined) cmdArgs.push("--timeout", `${args.timeoutMs}ms`);
|
|
||||||
appendTarget(cmdArgs, args.target);
|
|
||||||
const reply = (await runtime.run(
|
|
||||||
exec,
|
|
||||||
cmdArgs,
|
|
||||||
action,
|
|
||||||
sessionId,
|
|
||||||
runnerTimeout(deps, args.timeoutMs),
|
|
||||||
)) as {
|
|
||||||
tab_id: number;
|
|
||||||
focused: boolean;
|
|
||||||
was_focused?: boolean;
|
|
||||||
};
|
|
||||||
return {
|
|
||||||
session: sessionId,
|
|
||||||
tabId: reply.tab_id,
|
|
||||||
focused: reply.focused,
|
|
||||||
...(action === "blur" ? { wasFocused: reply.was_focused } : {}),
|
|
||||||
};
|
|
||||||
},
|
|
||||||
presentCall: (args) => ({
|
|
||||||
card: "terminal",
|
|
||||||
title: runtime.commandLine([
|
|
||||||
action,
|
|
||||||
args.target,
|
|
||||||
"--session",
|
|
||||||
args.session ?? "(current)",
|
|
||||||
]),
|
|
||||||
description: action === "focus" ? "Focus an element" : "Remove focus from an element",
|
|
||||||
}),
|
|
||||||
presentResult: runtime.presentTerminalResult,
|
|
||||||
}),
|
|
||||||
);
|
|
||||||
}
|
|
||||||
|
|
||||||
register(
|
register(
|
||||||
defineTool({
|
defineTool({
|
||||||
name: "interact.select",
|
name: "interact.select",
|
||||||
|
|||||||
@@ -102,9 +102,6 @@ const ACTION_ROUTES: Record<string, readonly [string, string]> = {
|
|||||||
"inspect.network": ["browser_inspect", "network"],
|
"inspect.network": ["browser_inspect", "network"],
|
||||||
"interact.click": ["browser_interact", "click"],
|
"interact.click": ["browser_interact", "click"],
|
||||||
"interact.hover": ["browser_interact", "hover"],
|
"interact.hover": ["browser_interact", "hover"],
|
||||||
"interact.scroll-to": ["browser_interact", "scroll-to"],
|
|
||||||
"interact.focus": ["browser_interact", "focus"],
|
|
||||||
"interact.blur": ["browser_interact", "blur"],
|
|
||||||
"interact.fill": ["browser_interact", "fill"],
|
"interact.fill": ["browser_interact", "fill"],
|
||||||
"interact.select": ["browser_interact", "select"],
|
"interact.select": ["browser_interact", "select"],
|
||||||
"interact.press": ["browser_interact", "press"],
|
"interact.press": ["browser_interact", "press"],
|
||||||
@@ -203,7 +200,7 @@ const EXPECTED_ACTIONS = {
|
|||||||
browser_session: ["start", "stop", "list"],
|
browser_session: ["start", "stop", "list"],
|
||||||
browser_page: ["navigate", "back", "forward", "reload", "wait"],
|
browser_page: ["navigate", "back", "forward", "reload", "wait"],
|
||||||
browser_inspect: ["observe", "snapshot", "html", "screenshot", "console", "network"],
|
browser_inspect: ["observe", "snapshot", "html", "screenshot", "console", "network"],
|
||||||
browser_interact: ["click", "hover", "scroll-to", "focus", "blur", "fill", "select", "press"],
|
browser_interact: ["click", "hover", "fill", "select", "press"],
|
||||||
browser_tabs: ["list", "create", "select", "close", "borrow", "return"],
|
browser_tabs: ["list", "create", "select", "close", "borrow", "return"],
|
||||||
browser_assist: ["resize", "emulate", "request-help"],
|
browser_assist: ["resize", "emulate", "request-help"],
|
||||||
} as const;
|
} as const;
|
||||||
@@ -502,85 +499,6 @@ describe("interaction tools", () => {
|
|||||||
]);
|
]);
|
||||||
});
|
});
|
||||||
|
|
||||||
it.each([
|
|
||||||
"focus",
|
|
||||||
"blur",
|
|
||||||
] as const)("interact.%s maps focus state, target, tab and timeout", async (action) => {
|
|
||||||
const { tools, calls } = setup({
|
|
||||||
"session start": START_REPLY("s1"),
|
|
||||||
[action]: {
|
|
||||||
tab_id: 7,
|
|
||||||
focused: action === "focus",
|
|
||||||
...(action === "blur" ? { was_focused: true } : {}),
|
|
||||||
},
|
|
||||||
});
|
|
||||||
await startSession(tools);
|
|
||||||
const target = action === "focus" ? "@e3" : "#field";
|
|
||||||
const value = await tools
|
|
||||||
.get(`interact.${action}`)
|
|
||||||
?.execute({ target, tabId: 7, timeoutMs: 150_000 }, makeExec());
|
|
||||||
expect(value).toEqual({
|
|
||||||
session: "s1",
|
|
||||||
tabId: 7,
|
|
||||||
focused: action === "focus",
|
|
||||||
...(action === "blur" ? { wasFocused: true } : {}),
|
|
||||||
});
|
|
||||||
expect(calls[1].args).toEqual([
|
|
||||||
action,
|
|
||||||
"--session",
|
|
||||||
"s1",
|
|
||||||
"--tab-id",
|
|
||||||
"7",
|
|
||||||
"--timeout",
|
|
||||||
"150000ms",
|
|
||||||
target,
|
|
||||||
]);
|
|
||||||
expect(calls[1].options.timeoutMs).toBe(165_000);
|
|
||||||
});
|
|
||||||
|
|
||||||
it.each([
|
|
||||||
"focus",
|
|
||||||
"blur",
|
|
||||||
"scroll-to",
|
|
||||||
] as const)("interact.%s validates arguments and session ownership before running", async (action) => {
|
|
||||||
const { tools, calls } = setup({ "session start": START_REPLY("s1") });
|
|
||||||
await startSession(tools);
|
|
||||||
const tool = tools.get(`interact.${action}`)!;
|
|
||||||
await expect(tool.execute({}, makeExec())).rejects.toThrow(/invalid arguments/i);
|
|
||||||
await expect(tool.execute({ target: " " }, makeExec())).rejects.toThrow(/non-empty/i);
|
|
||||||
await expect(tool.execute({ target: "e1", timeoutMs: 0 }, makeExec())).rejects.toThrow(
|
|
||||||
/greater than zero/i,
|
|
||||||
);
|
|
||||||
await expect(tool.execute({ target: "e1", session: "foreign" }, makeExec())).rejects.toThrow(
|
|
||||||
/session/i,
|
|
||||||
);
|
|
||||||
expect(calls).toHaveLength(1);
|
|
||||||
});
|
|
||||||
|
|
||||||
it.each(["@e3", "#target"])("interact.scroll-to maps %s, bounds and timeout", async (target) => {
|
|
||||||
const { tools, calls } = setup({
|
|
||||||
"session start": START_REPLY("s1"),
|
|
||||||
"scroll-to": { tab_id: 7, x: 10, y: 20, width: 100, height: 80 },
|
|
||||||
});
|
|
||||||
await startSession(tools);
|
|
||||||
expect(
|
|
||||||
await tools
|
|
||||||
.get("interact.scroll-to")
|
|
||||||
?.execute({ target, tabId: 7, timeoutMs: 150_000 }, makeExec()),
|
|
||||||
).toEqual({ session: "s1", tabId: 7, x: 10, y: 20, width: 100, height: 80 });
|
|
||||||
expect(calls[1].args).toEqual([
|
|
||||||
"scroll-to",
|
|
||||||
"--session",
|
|
||||||
"s1",
|
|
||||||
"--tab-id",
|
|
||||||
"7",
|
|
||||||
"--timeout",
|
|
||||||
"150000ms",
|
|
||||||
target,
|
|
||||||
]);
|
|
||||||
expect(calls[1].options.timeoutMs).toBe(165_000);
|
|
||||||
});
|
|
||||||
|
|
||||||
it("interact.fill passes value and --no-clear", async () => {
|
it("interact.fill passes value and --no-clear", async () => {
|
||||||
const { tools, calls } = setup(responses);
|
const { tools, calls } = setup(responses);
|
||||||
await startSession(tools);
|
await startSession(tools);
|
||||||
|
|||||||
+3
-9
@@ -174,22 +174,16 @@ function updateChangelog(version) {
|
|||||||
|
|
||||||
const today = new Date().toISOString().slice(0, 10);
|
const today = new Date().toISOString().slice(0, 10);
|
||||||
const escapedVer = version.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
|
const escapedVer = version.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
|
||||||
const versionHeading = new RegExp(`^## \\[${escapedVer}\\](?:\\s|$)`, "m");
|
|
||||||
|
|
||||||
// First: fill in any date-placeholder line for this version (e.g. "## [0.2.0] - 2026-09-XX")
|
// First: fill in any date-placeholder line for this version (e.g. "## [0.2.0] - 2026-09-XX")
|
||||||
const versionPlaceholder = new RegExp(`^## \\[${escapedVer}\\]\\s*-\\s*\\d{4}-\\d{2}-XX`, "m");
|
const versionPlaceholder = new RegExp(`^## \\[${escapedVer}\\]\\s*-\\s*\\d{4}-\\d{2}-XX`, "m");
|
||||||
if (versionPlaceholder.test(content)) {
|
if (versionPlaceholder.test(content)) {
|
||||||
content = content.replace(versionPlaceholder, `## [${version}] - ${today}`);
|
content = content.replace(versionPlaceholder, `## [${version}] - ${today}`);
|
||||||
} else if (!versionHeading.test(content)) {
|
} else {
|
||||||
// Preserve prepared release entries; new versions go before the release history.
|
// Otherwise: insert a new section after [Unreleased]
|
||||||
const heading = `## [${version}] - ${today}`;
|
|
||||||
const unreleased = /^## \[Unreleased\]/m;
|
const unreleased = /^## \[Unreleased\]/m;
|
||||||
if (unreleased.test(content)) {
|
if (unreleased.test(content)) {
|
||||||
content = content.replace(unreleased, `## [Unreleased]\n\n${heading}`);
|
content = content.replace(unreleased, `## [Unreleased]\n\n## [${version}] - ${today}`);
|
||||||
} else if (/^## /m.test(content)) {
|
|
||||||
content = content.replace(/^## /m, `${heading}\n\n## `);
|
|
||||||
} else {
|
|
||||||
content = `${content.trimEnd()}\n\n${heading}\n`;
|
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|||||||
+2
-12
@@ -55,20 +55,10 @@ Use this default loop:
|
|||||||
```text
|
```text
|
||||||
bsk navigate <url> --session <id>
|
bsk navigate <url> --session <id>
|
||||||
bsk observe --session <id>
|
bsk observe --session <id>
|
||||||
bsk click|hover|scroll-to|focus|blur|fill|select|press ... --session <id>
|
bsk click|hover|fill|select|press ... --session <id>
|
||||||
bsk observe --session <id> # after navigation or a meaningful DOM change
|
bsk observe --session <id> # after navigation or a meaningful DOM change
|
||||||
```
|
```
|
||||||
|
|
||||||
`bsk scroll-to <ref-or-selector> --session <id>` scrolls an element and its frame owners into view.
|
|
||||||
Use a fresh element ref for iframe/shadow-root targets; CSS selectors search the main document.
|
|
||||||
The result is the visible border-box portion's bounds in top-level viewport CSS pixels after
|
|
||||||
ancestor clipping. Partial visibility is enough; hidden or fully clipped targets fail with
|
|
||||||
`permission_denied` and `data.reason=element_not_visible`. This does not test occlusion by other elements.
|
|
||||||
For a specific tab or deadline: `bsk scroll-to @e3 --session <id> --tab-id 42 --timeout 5s`.
|
|
||||||
|
|
||||||
`bsk focus <ref>` explicitly focuses a target; `bsk blur <ref>` removes focus and reports whether
|
|
||||||
it was focused. Use these for UI states triggered by focus changes.
|
|
||||||
|
|
||||||
Prefer fresh `@eN` refs over CSS selectors. Navigation invalidates refs; large DOM changes may also
|
Prefer fresh `@eN` refs over CSS selectors. Navigation invalidates refs; large DOM changes may also
|
||||||
make them stale. Observe again before the next interaction.
|
make them stale. Observe again before the next interaction.
|
||||||
|
|
||||||
@@ -124,7 +114,7 @@ This list of names is complete. Never invent a command outside it; read
|
|||||||
session start|stop|list browsers status doctor update logs
|
session start|stop|list browsers status doctor update logs
|
||||||
navigate navigate-back navigate-forward reload wait-for-navigation wait-ms
|
navigate navigate-back navigate-forward reload wait-for-navigation wait-ms
|
||||||
observe snapshot get-html screenshot console network
|
observe snapshot get-html screenshot console network
|
||||||
click hover scroll-to focus blur fill select press evaluate
|
click hover fill select press evaluate
|
||||||
tab list|create|close|select|borrow|return window resize emulate
|
tab list|create|close|select|borrow|return window resize emulate
|
||||||
upload download request-help record start|stop
|
upload download request-help record start|stop
|
||||||
```
|
```
|
||||||
|
|||||||
Reference in new issue
Block a user