Skip to content

Chrome DevTools for coding agents

4.2 KB
Raw Blame
/**
 * @license
 * Copyright 2026 Google LLC
 * SPDX-License-Identifier: Apache-2.0
 */

import assert from 'node:assert';
import fs from 'node:fs/promises';
import path from 'node:path';
import {describe, it} from 'node:test';
import {pathToFileURL} from 'node:url';

import {
  assertDaemonIsRunning,
  createCliSession,
  createTempDir,
  runCli,
  startCli,
  stopDaemonForCleanup,
} from '../utils.js';

// Each test uses its own daemon session, so the tests run in parallel.
describe('chrome-devtools', {concurrency: true}, () => {
  it('can invoke list_pages', async t => {
    const sessionId = createCliSession(t);
    const startResult = await startCli(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 t => {
    const sessionId = createCliSession(t);
    const startResult = await startCli(sessionId);
    assert.strictEqual(
      startResult.status,
      0,
      `start command failed: ${startResult.stderr}`,
    );

    const result = await runCli(['take_screenshot', '1'], sessionId);
    assert.strictEqual(
      result.status,
      0,
      `take_screenshot command failed: ${result.stderr}`,
    );
    assert(
      result.stdout.includes('.png'),
      'take_screenshot output is unexpected',
    );
  });

  it('can evaluate inline and local JavaScript', async t => {
    const sessionId = createCliSession(t);
    using rootDirectory = createTempDir('evaluate-script-cli-');
    const daemonDirectory = path.join(rootDirectory.path, 'daemon');
    const clientDirectory = path.join(rootDirectory.path, 'client');
    await fs.mkdir(daemonDirectory);
    await fs.mkdir(clientDirectory);

    const sourcePath = path.join(clientDirectory, 'script.js');
    const outputPath = path.join(clientDirectory, 'result.json');
    await fs.writeFile(
      sourcePath,
      'document.title = "Local script"; document.title',
      'utf8',
    );
    try {
      const startResult = await startCli(sessionId, [], {
        cwd: daemonDirectory,
      });
      assert.strictEqual(
        startResult.status,
        0,
        `start command failed: ${startResult.stderr}`,
      );

      // The three evaluations do not depend on each other, so they run in
      // parallel.
      const [inlineResult, fileResult, fileUrlResult] = await Promise.all([
        runCli(['evaluate_script', '() => 6 * 7', '--pageId', '1'], sessionId, {
          cwd: clientDirectory,
        }),
        runCli(
          [
            'evaluate_script',
            '--pageId',
            '1',
            '--sourcePath',
            sourcePath,
            '--format',
            'script',
            '--filePath',
            outputPath,
          ],
          sessionId,
          {cwd: clientDirectory},
        ),
        runCli(
          [
            'evaluate_script',
            '--pageId',
            '1',
            '--sourcePath',
            pathToFileURL(sourcePath).href,
            '--format',
            'script',
          ],
          sessionId,
          {cwd: clientDirectory},
        ),
      ]);

      assert.strictEqual(
        inlineResult.status,
        0,
        `inline evaluation failed: ${inlineResult.stderr}`,
      );
      assert.match(inlineResult.stdout, /\b42\b/);

      assert.strictEqual(
        fileResult.status,
        0,
        `file evaluation failed: ${fileResult.stderr}`,
      );
      assert.strictEqual(
        JSON.parse(await fs.readFile(outputPath, 'utf8')),
        'Local script',
      );

      assert.strictEqual(
        fileUrlResult.status,
        0,
        `file URL evaluation failed: ${fileUrlResult.stderr}`,
      );
      assert.match(fileUrlResult.stdout, /Local script/);
    } finally {
      // Stop the daemon before the temporary directory, its working
      // directory, is removed.
      await stopDaemonForCleanup(sessionId);
    }
  });
});