chromium-bidi 2.1.2: Exception

Clean-room public code sample — generation instructions

Write a brand-new, minimal, self-contained code sample in this clean-room directory.
Do not copy, paraphrase, or reference any existing project source. Work only from this spec.

A csx.json manifest scaffold already exists. Do not recreate it from memory. Preserve its case.goal, packages and symbols; fill its empty case.contract with exact assertions and correct its environment, commands and verifierAdapter for the files you generate.

Goal: verify chromium-bidi.Exception in pkg:npm/chromium-bidi@2.1.2
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:npm/chromium-bidi@2.1.2
Demonstrate these symbols/APIs:
  - chromium-bidi.Exception

Rules:
  - One focused purpose; the smallest project that proves the goal.
  - Include a contract test (test/contract.*) that runs OFFLINE and exits 0 exactly when the goal behavior works.
  - Pin every dependency with a lockfile so resolution is reproducible.
  - No secrets, credentials, or tokens. No real URLs (only example.com or localhost). No absolute paths.
  - No personal names, emails, company names, or project identifiers of any kind.
  - No binaries and no generated output (node_modules, dist, target, venv, .git, .env).
  - Keep it under 200 files and 256KB packed.

{"case":{"caseId":"case:sha256:a1309acd2f58a903cf72325887d6b6c78e70ca95a2a6fc53a0ebb80ddf2ca539","contract":["Exception constructor sets error code, message and optional stacktrace","Exception subclasses inherit from Exception with predefined error names","Exception.toErrorResponse formats standard BiDi error payload with stacktrace field","NoSuchElementException.toErrorResponse formats error response with no such element code","NoSuchScriptException.toErrorResponse formats error response with undefined stacktrace","Protocol parser throws InvalidArgumentException inheriting from Exception on invalid input"],"goal":"verify chromium-bidi.Exception in pkg:npm/chromium-bidi@2.1.2","kind":"HOW","packages":["pkg:npm/chromium-bidi@2.1.2"],"schemaVersion":1,"symbols":["chromium-bidi.Exception"]},"contractCommand":["node","test/contract.js"],"environment":{"arch":"x64","distro":"ubuntu","ecosystem":"npm","libc":"glibc","libcVersion":"2.39","os":"linux","osVersionBucket":"24","packageManager":"npm","schemaVersion":1},"license":"MIT-0","packages":["pkg:npm/chromium-bidi@2.1.2"],"schemaVersion":1,"subject":"pkg:npm/chromium-bidi@2.1.2","symbols":["chromium-bidi.Exception"],"verifierAdapter":"node-typescript@1"}

'use strict';

const {
  Exception,
  InvalidArgumentException,
  NoSuchElementException,
  NoSuchScriptException,
  NoSuchFrameException,
  InvalidSelectorException,
  UnknownErrorException,
  UnsupportedOperationException,
} = require('chromium-bidi/lib/cjs/protocol/protocol.js');

const {
  Script,
  BrowsingContext,
} = require('chromium-bidi/lib/cjs/protocol-parser/protocol-parser.js');

function createException(error, message, stacktrace) {
  return new Exception(error, message, stacktrace);
}

function createNoSuchElementException(message, stacktrace) {
  return new NoSuchElementException(message, stacktrace);
}

function createNoSuchScriptException(message, stacktrace) {
  return new NoSuchScriptException(message, stacktrace);
}

function formatErrorResponse(exception, commandId) {
  return exception.toErrorResponse(commandId);
}

function parseEvaluateScript(params) {
  return Script.parseEvaluateParams(params);
}

module.exports = {
  Exception,
  InvalidArgumentException,
  NoSuchElementException,
  NoSuchScriptException,
  NoSuchFrameException,
  InvalidSelectorException,
  UnknownErrorException,
  UnsupportedOperationException,
  createException,
  createNoSuchElementException,
  createNoSuchScriptException,
  formatErrorResponse,
  parseEvaluateScript,
};

{
  "name": "sample-4170787998",
  "version": "1.0.0",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "sample-4170787998",
      "version": "1.0.0",
      "license": "MIT-0",
      "dependencies": {
        "chromium-bidi": "2.1.2"
      }
    },
    "node_modules/chromium-bidi": {
      "version": "2.1.2",
      "resolved": "https://registry.npmjs.org/chromium-bidi/-/chromium-bidi-2.1.2.tgz",
      "integrity": "sha512-vtRWBK2uImo5/W2oG6/cDkkHSm+2t6VHgnj+Rcwhb0pP74OoUb4GipyRX/T/y39gYQPhioP0DPShn+A7P6CHNw==",
      "license": "Apache-2.0",
      "dependencies": {
        "mitt": "^3.0.1",
        "zod": "^3.24.1"
      },
      "peerDependencies": {
        "devtools-protocol": "*"
      }
    },
    "node_modules/devtools-protocol": {
      "version": "0.0.1686980",
      "resolved": "https://registry.npmjs.org/devtools-protocol/-/devtools-protocol-0.0.1686980.tgz",
      "integrity": "sha512-NnnxGO1/cRffXL29DqGysbfgCcsYoIxprtmXgh+UDXFvhTwhRBewcRdGlEXvc3cmROi04JRmd2PqCURsijW25A==",
      "license": "BSD-3-Clause",
      "peer": true
    },
    "node_modules/mitt": {
      "version": "3.0.1",
      "resolved": "https://registry.npmjs.org/mitt/-/mitt-3.0.1.tgz",
      "integrity": "sha512-vKivATfr97l2/QBCYAkXYDbrIWPM2IIKEl7YPhjCvKlG3kE2gm+uBo6nEXK3M5/Ffh/FLpKExzOQ3JJoJGFKBw==",
      "license": "MIT"
    },
    "node_modules/zod": {
      "version": "3.25.76",
      "resolved": "https://registry.npmjs.org/zod/-/zod-3.25.76.tgz",
      "integrity": "sha512-gzUt/qt81nXsFGKIFcC3YnfEAx5NkunCfnDlvuBSSFS02bcXu4Lmea0AFIUwbLWxWPx3d9p8S5QoaujKcNQxcQ==",
      "license": "MIT",
      "funding": {
        "url": "https://github.com/sponsors/colinhacks"
      }
    }
  }
}

{
  "name": "sample-4170787998",
  "version": "1.0.0",
  "description": "verify chromium-bidi.Exception in pkg:npm/chromium-bidi@2.1.2",
  "main": "index.js",
  "scripts": {
    "test": "node test/contract.js"
  },
  "keywords": [],
  "author": "",
  "license": "MIT-0",
  "dependencies": {
    "chromium-bidi": "2.1.2"
  }
}

{
  "schemaVersion": 1,
  "goal": "verify chromium-bidi.Exception in pkg:npm/chromium-bidi@2.1.2",
  "kind": "HOW",
  "packages": [
    "pkg:npm/chromium-bidi@2.1.2"
  ],
  "symbols": [
    "chromium-bidi.Exception"
  ]
}

'use strict';

const assert = require('assert');
const {
  Exception,
  InvalidArgumentException,
  NoSuchElementException,
  NoSuchScriptException,
  NoSuchFrameException,
  InvalidSelectorException,
  UnknownErrorException,
  UnsupportedOperationException,
  createException,
  createNoSuchElementException,
  createNoSuchScriptException,
  formatErrorResponse,
  parseEvaluateScript,
} = require('../index.js');

async function runContract() {
  // 1. Exception constructor sets error code, message and optional stacktrace
  const baseEx = createException('unknown error', 'A protocol error occurred', 'mock-stack-trace');
  assert(baseEx instanceof Error, 'Exception must be an instance of Error');
  assert(baseEx instanceof Exception, 'Exception must be an instance of Exception');
  assert.strictEqual(baseEx.error, 'unknown error');
  assert.strictEqual(baseEx.message, 'A protocol error occurred');
  assert.strictEqual(baseEx.stacktrace, 'mock-stack-trace');

  // 2. Exception subclasses inherit from Exception with predefined error names
  const elementEx = createNoSuchElementException('Element #header not found', 'stack-line-1');
  assert(elementEx instanceof Error, 'NoSuchElementException must be an instance of Error');
  assert(elementEx instanceof Exception, 'NoSuchElementException must be an instance of Exception');
  assert(elementEx instanceof NoSuchElementException, 'NoSuchElementException must be an instance of NoSuchElementException');
  assert.strictEqual(elementEx.error, 'no such element');
  assert.strictEqual(elementEx.message, 'Element #header not found');
  assert.strictEqual(elementEx.stacktrace, 'stack-line-1');

  const scriptEx = createNoSuchScriptException('Script execution timed out');
  assert(scriptEx instanceof Exception, 'NoSuchScriptException must be an instance of Exception');
  assert.strictEqual(scriptEx.error, 'no such script');
  assert.strictEqual(scriptEx.stacktrace, undefined);

  const frameEx = new NoSuchFrameException('Frame not found');
  assert(frameEx instanceof Exception, 'NoSuchFrameException must be an instance of Exception');
  assert.strictEqual(frameEx.error, 'no such frame');

  const selectorEx = new InvalidSelectorException('Invalid CSS selector');
  assert(selectorEx instanceof Exception, 'InvalidSelectorException must be an instance of Exception');
  assert.strictEqual(selectorEx.error, 'invalid selector');

  const unknownEx = new UnknownErrorException('Internal server error');
  assert(unknownEx instanceof Exception, 'UnknownErrorException must be an instance of Exception');
  assert.strictEqual(unknownEx.error, 'unknown error');

  const unsupportedEx = new UnsupportedOperationException('Feature disabled');
  assert(unsupportedEx instanceof Exception, 'UnsupportedOperationException must be an instance of Exception');
  assert.strictEqual(unsupportedEx.error, 'unsupported operation');

  // 3. Exception.toErrorResponse formats standard BiDi error payload with stacktrace field
  const basePayload = formatErrorResponse(baseEx, 10);
  assert.deepStrictEqual(basePayload, {
    type: 'error',
    id: 10,
    error: 'unknown error',
    message: 'A protocol error occurred',
    stacktrace: 'mock-stack-trace',
  });

  // 4. NoSuchElementException.toErrorResponse formats error response with no such element code
  const elementPayload = formatErrorResponse(elementEx, 20);
  assert.deepStrictEqual(elementPayload, {
    type: 'error',
    id: 20,
    error: 'no such element',
    message: 'Element #header not found',
    stacktrace: 'stack-line-1',
  });

  // 5. NoSuchScriptException.toErrorResponse formats error response with undefined stacktrace
  const scriptPayload = formatErrorResponse(scriptEx, 30);
  assert.deepStrictEqual(scriptPayload, {
    type: 'error',
    id: 30,
    error: 'no such script',
    message: 'Script execution timed out',
    stacktrace: undefined,
  });

  // 6. Protocol parser throws InvalidArgumentException inheriting from Exception on invalid input
  assert.throws(
    () => {
      parseEvaluateScript({ expression: 12345 });
    },
    (err) => {
      assert(err instanceof Exception, 'Parser error must be an instance of Exception');
      assert(err instanceof InvalidArgumentException, 'Parser error must be InvalidArgumentException');
      assert.strictEqual(err.error, 'invalid argument');
      assert(err.message.includes('expression'), 'Error message should indicate invalid expression parameter');
      return true;
    }
  );

  console.log('Contract tests passed successfully.');
}

runContract().catch((err) => {
  console.error('Contract test failed:', err);
  process.exit(1);
});