Chrome DevTools for coding agents
/**
* @license
* Copyright 2026 Google LLC
* SPDX-License-Identifier: Apache-2.0
*/
import assert from 'node:assert';
import {describe, it} from 'node:test';
import {createCliSession, runCli, startCli} from '../utils.js';
// Each test uses its own daemon session, so the tests run in parallel.
describe('chrome-devtools', {concurrency: true}, () => {
it('fails to invoke list_network_requests when categoryNetwork is disabled', async t => {
const sessionId = createCliSession(t);
await startCli(sessionId, ['--categoryNetwork=false']);
const result = await runCli(['list_network_requests', '1'], sessionId);
assert.strictEqual(result.status, 0);
assert(
result.stdout.includes(
'Tool list_network_requests is in category Network which is currently disabled',
),
'error message is unexpected: ' + result.stdout,
);
assert(
result.stdout.includes('chrome-devtools start --categoryNetwork=true'),
'restart command suggestion is missing: ' + result.stdout,
);
});
it('fails to invoke click_at when experimentalVision is disabled (default)', async t => {
const sessionId = createCliSession(t);
await startCli(sessionId);
const result = await runCli(['click_at', '1', '100', '100'], sessionId);
assert.strictEqual(result.status, 0);
assert(
result.stdout.includes(
'Tool click_at requires experimental feature --experimentalVision and is currently disabled',
),
'error message is unexpected: ' + result.stdout,
);
assert(
result.stdout.includes('chrome-devtools start --experimentalVision=true'),
'restart command suggestion is miss: ' + result.stdout,
);
});
it('fails to invoke evaluate_script when javascriptEvaluation is disabled', async t => {
const sessionId = createCliSession(t);
await startCli(sessionId, ['--no-javascript-evaluation']);
// The three commands do not change daemon state, so they run in
// parallel.
const [result, navResult, initScriptResult] = await Promise.all([
runCli(['evaluate_script', '() => 1'], sessionId),
runCli(['navigate_page', '1', '--url', 'javascript:alert(1)'], sessionId),
runCli(
[
'navigate_page',
'1',
'--initScript',
'alert(1)',
'--timeout',
'invalid',
],
sessionId,
),
]);
assert.strictEqual(result.status, 0);
assert(
result.stdout.includes(
'Tool evaluate_script requires flag --javascriptEvaluation and is currently disabled',
),
'error message is unexpected: ' + result.stdout,
);
assert(
result.stdout.includes(
'chrome-devtools start --javascriptEvaluation=true',
),
'restart command suggestion is missing: ' + result.stdout,
);
assert.strictEqual(navResult.status, 0);
assert(
navResult.stdout.includes(
'Navigating to javascript: URLs is not allowed when JavaScript evaluation is disabled.',
),
'error message is unexpected: ' + navResult.stdout,
);
assert.strictEqual(initScriptResult.status, 0);
assert(
initScriptResult.stdout.includes(
'Input validation error: Invalid arguments for tool navigate_page: timeout: Invalid input: expected number, received null, Unrecognized key: "initScript"',
),
'error message is unexpected: ' + initScriptResult.stdout,
);
});
});