Chrome DevTools for coding agents
feat: Add pagination list_network_requests (#145)
Oz Tamir4c909bb8d7c4
diff --git a/docs/tool-reference.md b/docs/tool-reference.mdindex 84d4fc9d..60b45e79 100644--- a/docs/tool-reference.md+++ b/docs/tool-reference.md@@ -262,7 +262,10 @@**Description:** List all requests for the currently selected page-**Parameters:** None+**Parameters:**++- **pageIdx** (integer) _(optional)_: Page number to return (0-based). When omitted, returns the first page.+- **pageSize** (integer) _(optional)_: Maximum number of requests to return. When omitted, returns all requests.---diff --git a/src/McpResponse.ts b/src/McpResponse.tsindex e1af6f9c..48428365 100644--- a/src/McpResponse.ts+++ b/src/McpResponse.ts@@ -13,6 +13,7 @@ import {} from './formatters/networkFormatter.js';import {formatA11ySnapshot} from './formatters/snapshotFormatter.js';import {formatConsoleEvent} from './formatters/consoleFormatter.js';+import {paginate, type PaginationOptions} from './utils/pagination.js';export class McpResponse implements Response {#includePages: boolean = false;@@ -23,6 +24,7 @@ export class McpResponse implements Response {#textResponseLines: string[] = [];#formattedConsoleData?: string[];#images: ImageContentData[] = [];+ #networkRequestsPaginationOptions?: PaginationOptions;setIncludePages(value: boolean): void {this.#includePages = value;@@ -32,8 +34,20 @@ export class McpResponse implements Response {this.#includeSnapshot = value;}- setIncludeNetworkRequests(value: boolean): void {+ setIncludeNetworkRequests(+ value: boolean,+ options?: {pageSize?: number; pageIdx?: number},+ ): void {this.#includeNetworkRequests = value;+ if (!value || !options) {+ this.#networkRequestsPaginationOptions = undefined;+ return;+ }++ this.#networkRequestsPaginationOptions = {+ pageSize: options.pageSize,+ pageIdx: options.pageIdx,+ };}setIncludeConsoleData(value: boolean): void {@@ -58,6 +72,9 @@ export class McpResponse implements Response {get attachedNetworkRequestUrl(): string | undefined {return this.#attachedNetworkRequestUrl;}+ get networkRequestsPageIdx(): number | undefined {+ return this.#networkRequestsPaginationOptions?.pageIdx;+ }appendResponseLine(value: string): void {this.#textResponseLines.push(value);@@ -162,7 +179,30 @@ Call browser_handle_dialog to handle it before continuing.`);const requests = context.getNetworkRequests();response.push('## Network requests');if (requests.length) {- for (const request of requests) {+ const paginationResult = paginate(+ requests,+ this.#networkRequestsPaginationOptions,+ );+ if (paginationResult.invalidPage) {+ response.push('Invalid page number provided. Showing first page.');+ }++ const {startIndex, endIndex, currentPage, totalPages} =+ paginationResult;+ response.push(+ `Showing ${startIndex + 1}-${endIndex} of ${requests.length} (Page ${currentPage + 1} of ${totalPages}).`,+ );++ if (this.#networkRequestsPaginationOptions) {+ if (paginationResult.hasNextPage) {+ response.push(`Next page: ${currentPage + 1}`);+ }+ if (paginationResult.hasPreviousPage) {+ response.push(`Previous page: ${currentPage - 1}`);+ }+ }++ for (const request of paginationResult.items) {response.push(getShortDescriptionForRequest(request));}} else {diff --git a/src/tools/ToolDefinition.ts b/src/tools/ToolDefinition.tsindex 926a104c..8c626750 100644--- a/src/tools/ToolDefinition.ts+++ b/src/tools/ToolDefinition.ts@@ -42,7 +42,10 @@ export type ImageContentData = {export interface Response {appendResponseLine(value: string): void;setIncludePages(value: boolean): void;- setIncludeNetworkRequests(value: boolean): void;+ setIncludeNetworkRequests(+ value: boolean,+ options?: {pageSize?: number; pageIdx?: number},+ ): void;setIncludeConsoleData(value: boolean): void;setIncludeSnapshot(value: boolean): void;attachImage(value: ImageContentData): void;diff --git a/src/tools/network.ts b/src/tools/network.tsindex c14fe9ff..d4746b96 100644--- a/src/tools/network.ts+++ b/src/tools/network.ts@@ -15,9 +15,29 @@ export const listNetworkRequests = defineTool({category: ToolCategories.NETWORK,readOnlyHint: true,},- schema: {},- handler: async (_request, response) => {- response.setIncludeNetworkRequests(true);+ schema: {+ pageSize: z+ .number()+ .int()+ .positive()+ .optional()+ .describe(+ 'Maximum number of requests to return. When omitted, returns all requests.',+ ),+ pageIdx: z+ .number()+ .int()+ .min(0)+ .optional()+ .describe(+ 'Page number to return (0-based). When omitted, returns the first page.',+ ),+ },+ handler: async (request, response) => {+ response.setIncludeNetworkRequests(true, {+ pageSize: request.params.pageSize,+ pageIdx: request.params.pageIdx,+ });},});diff --git a/src/utils/pagination.ts b/src/utils/pagination.tsnew file mode 100644index 00000000..dbd35b99--- /dev/null+++ b/src/utils/pagination.ts@@ -0,0 +1,87 @@+/**+ * @license+ * Copyright 2025 Google LLC+ * SPDX-License-Identifier: Apache-2.0+ */++export type PaginationOptions = {+ pageSize?: number;+ pageIdx?: number;+};++export type PaginationResult<TItem> = {+ items: readonly TItem[];+ currentPage: number;+ totalPages: number;+ hasNextPage: boolean;+ hasPreviousPage: boolean;+ startIndex: number;+ endIndex: number;+ invalidPage: boolean;+};++const DEFAULT_PAGE_SIZE = 20;++export function paginate<TItem>(+ items: readonly TItem[],+ options?: PaginationOptions,+): PaginationResult<TItem> {+ const total = items.length;++ if (!options || noPaginationOptions(options)) {+ return {+ items,+ currentPage: 0,+ totalPages: 1,+ hasNextPage: false,+ hasPreviousPage: false,+ startIndex: 0,+ endIndex: total,+ invalidPage: false,+ };+ }++ const pageSize = options.pageSize ?? DEFAULT_PAGE_SIZE;+ const totalPages = Math.max(1, Math.ceil(total / pageSize));+ const {currentPage, invalidPage} = resolvePageIndex(+ options.pageIdx,+ totalPages,+ );++ const startIndex = currentPage * pageSize;+ const pageItems = items.slice(startIndex, startIndex + pageSize);+ const endIndex = startIndex + pageItems.length;++ return {+ items: pageItems,+ currentPage,+ totalPages,+ hasNextPage: currentPage < totalPages - 1,+ hasPreviousPage: currentPage > 0,+ startIndex,+ endIndex,+ invalidPage,+ };+}++function noPaginationOptions(options: PaginationOptions): boolean {+ return options.pageSize === undefined && options.pageIdx === undefined;+}++function resolvePageIndex(+ pageIdx: number | undefined,+ totalPages: number,+): {+ currentPage: number;+ invalidPage: boolean;+} {+ if (pageIdx === undefined) {+ return {currentPage: 0, invalidPage: false};+ }++ if (pageIdx < 0 || pageIdx >= totalPages) {+ return {currentPage: 0, invalidPage: true};+ }++ return {currentPage: pageIdx, invalidPage: false};+}diff --git a/tests/McpResponse.test.ts b/tests/McpResponse.test.tsindex 40f775f7..41cbdc94 100644--- a/tests/McpResponse.test.ts+++ b/tests/McpResponse.test.ts@@ -185,6 +185,7 @@ Call browser_handle_dialog to handle it before continuing.`,result[0].text,`# test response## Network requests+Showing 1-1 of 1 (Page 1 of 1).http://example.com GET [pending]`,);});@@ -217,6 +218,7 @@ Status: [pending]### Request Headers- content-size:10## Network requests+Showing 1-1 of 1 (Page 1 of 1).http://example.com GET [pending]`,);});@@ -261,3 +263,70 @@ Log>`),});});});++describe('McpResponse network pagination', () => {+ it('returns all requests when pagination is not provided', async () => {+ await withBrowser(async (response, context) => {+ const requests = Array.from({length: 5}, () => getMockRequest());+ context.getNetworkRequests = () => requests;+ response.setIncludeNetworkRequests(true);+ const result = await response.handle('test', context);+ const text = (result[0].text as string).toString();+ assert.ok(text.includes('Showing 1-5 of 5 (Page 1 of 1).'));+ assert.ok(!text.includes('Next page:'));+ assert.ok(!text.includes('Previous page:'));+ });+ });++ it('returns first page by default', async () => {+ await withBrowser(async (response, context) => {+ const requests = Array.from({length: 30}, (_, idx) =>+ getMockRequest({method: `GET-${idx}`}),+ );+ context.getNetworkRequests = () => {+ return requests;+ };+ response.setIncludeNetworkRequests(true, {pageSize: 10});+ const result = await response.handle('test', context);+ const text = (result[0].text as string).toString();+ assert.ok(text.includes('Showing 1-10 of 30 (Page 1 of 3).'));+ assert.ok(text.includes('Next page: 1'));+ assert.ok(!text.includes('Previous page:'));+ });+ });++ it('returns subsequent page when pageIdx provided', async () => {+ await withBrowser(async (response, context) => {+ const requests = Array.from({length: 25}, (_, idx) =>+ getMockRequest({method: `GET-${idx}`}),+ );+ context.getNetworkRequests = () => requests;+ response.setIncludeNetworkRequests(true, {+ pageSize: 10,+ pageIdx: 1,+ });+ const result = await response.handle('test', context);+ const text = (result[0].text as string).toString();+ assert.ok(text.includes('Showing 11-20 of 25 (Page 2 of 3).'));+ assert.ok(text.includes('Next page: 2'));+ assert.ok(text.includes('Previous page: 0'));+ });+ });++ it('handles invalid page number by showing first page', async () => {+ await withBrowser(async (response, context) => {+ const requests = Array.from({length: 5}, () => getMockRequest());+ context.getNetworkRequests = () => requests;+ response.setIncludeNetworkRequests(true, {+ pageSize: 2,+ pageIdx: 10, // Invalid page number+ });+ const result = await response.handle('test', context);+ const text = (result[0].text as string).toString();+ assert.ok(+ text.includes('Invalid page number provided. Showing first page.'),+ );+ assert.ok(text.includes('Showing 1-2 of 5 (Page 1 of 3).'));+ });+ });+});diff --git a/tests/tools/network.test.ts b/tests/tools/network.test.tsindex a563d051..43a78051 100644--- a/tests/tools/network.test.ts+++ b/tests/tools/network.test.ts@@ -18,6 +18,7 @@ describe('network', () => {await withBrowser(async (response, context) => {await listNetworkRequests.handler({params: {}}, response, context);assert.ok(response.includeNetworkRequests);+ assert.strictEqual(response.networkRequestsPageIdx, undefined);});});});