Files
chromedevtools--chrome-devt…/tests/e2e/chrome-devtools-commands.test.ts
2026-07-13 12:30:05 +08:00

147 lines
4.0 KiB
TypeScript

/**
* @license
* Copyright 2026 Google LLC
* SPDX-License-Identifier: Apache-2.0
*/
import assert from 'node:assert';
import crypto from 'node:crypto';
import {describe, it, afterEach, beforeEach} from 'node:test';
import {
assertDaemonIsNotRunning,
assertDaemonIsRunning,
runCli,
} from '../utils.js';
describe('chrome-devtools', () => {
let sessionId: string;
beforeEach(async () => {
sessionId = crypto.randomUUID();
await runCli(['stop'], sessionId);
await assertDaemonIsNotRunning(sessionId);
});
afterEach(async () => {
await runCli(['stop'], sessionId);
await assertDaemonIsNotRunning(sessionId);
});
it('can invoke list_pages', async () => {
await assertDaemonIsNotRunning(sessionId);
const startResult = await runCli(['start'], sessionId);
assert.strictEqual(
startResult.status,
0,
`start command failed: ${startResult.stderr}`,
);
const listPagesResult = await runCli(['list_pages'], sessionId);
assert.strictEqual(
listPagesResult.status,
0,
`list_pages command failed: ${listPagesResult.stderr}`,
);
assert(
listPagesResult.stdout.includes('about:blank'),
'list_pages output is unexpected',
);
await assertDaemonIsRunning(sessionId);
});
it('can take screenshot', async () => {
const startResult = await runCli(['start'], sessionId);
assert.strictEqual(
startResult.status,
0,
`start command failed: ${startResult.stderr}`,
);
const result = await runCli(['take_screenshot'], sessionId);
assert.strictEqual(
result.status,
0,
`take_screenshot command failed: ${result.stderr}`,
);
assert(
result.stdout.includes('.png'),
'take_screenshot output is unexpected',
);
});
it('fails to invoke list_network_requests when categoryNetwork is disabled', async () => {
await runCli(['start', '--categoryNetwork=false'], sessionId);
const result = await runCli(['list_network_requests'], 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 () => {
await runCli(['start'], sessionId);
const result = await runCli(['click_at', '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('can record a performance trace', async () => {
const startResult = await runCli(
['start', '--performanceCrux=false'],
sessionId,
);
assert.strictEqual(
startResult.status,
0,
`start command failed: ${startResult.stderr}`,
);
const emulateResult = await runCli(
['emulate', '--cpuThrottlingRate', '2'],
sessionId,
);
assert.strictEqual(
emulateResult.status,
0,
`emulate command failed: ${emulateResult.stderr}`,
);
const result = await runCli(['performance_start_trace'], sessionId);
assert.strictEqual(
result.status,
0,
`performance_start_trace command failed: ${result.stderr}`,
);
assert(
result.stdout.includes('The performance trace has been stopped.'),
'performance_start_trace output is unexpected: ' + result.stdout,
);
assert(
result.stdout.includes('CPU throttling: 2x'),
'performance_start_trace output is unexpected: ' + result.stdout,
);
});
});