front_end/testing/TargetHelpers.ts

// Copyright 2026 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

import * as ProtocolClient from '../core/protocol_client/protocol_client.js';
import * as SDK from '../core/sdk/sdk.js';
import type * as Protocol from '../generated/protocol.js';

import {MockCDPConnection} from './MockCDPConnection.js';

let uniqueTargetId = 0;

export function createTarget({
  id,
  name,
  type = SDK.Target.Type.FRAME,
  parentTarget,
  subtype,
  url = 'http://example.com',
  connection,
  targetManager = SDK.TargetManager.TargetManager.instance(),
}: {
  id?: Protocol.Target.TargetID,
  name?: string,
  type?: SDK.Target.Type,
  parentTarget?: SDK.Target.Target,
  subtype?: string,
  url?: string,
  connection?: ProtocolClient.CDPConnection.CDPConnection,
  targetManager?: SDK.TargetManager.TargetManager,
} = {}) {
  if (!id) {
    if (!uniqueTargetId++) {
      id = 'test' as Protocol.Target.TargetID;
    } else {
      id = ('test' + uniqueTargetId) as Protocol.Target.TargetID;
    }
  }
  if (!ProtocolClient.ConnectionTransport.ConnectionTransport.getFactory()) {
    // We are not running with `describeWithMockConnection` so create a fresh mock connection.
    // Because child targets inherit the SessionRouter/CDPConnection from the parent, we'll throw if a
    // connection is passed together with a parent target as it would have no effect.
    if (parentTarget && connection) {
      throw new Error(
          'Can\'t create child targets with it\'s own connection. Child targets share the connection with their parent.');
    }
    if (!connection && !parentTarget) {
      connection = new MockCDPConnection([]);
    }
  }
  return targetManager.createTarget(
      id, name ?? id, type, parentTarget ? parentTarget : null, /* sessionId=*/ parentTarget ? id : undefined,
      /* suspended=*/ false, connection, {targetId: id, url, subtype} as Protocol.Target.TargetInfo);
}