findBridgePortForWorkspace function

Future<int> findBridgePortForWorkspace(String name, { String host = '127.0.0.1', int minPort = defaultVSCodeBridgePort, int maxPort = maxVSCodeBridgePort, BridgePortProbe probe = _defaultProbe, BridgeIdentityFetcher fetchIdentity = fetchBridgeWorkspaceName, })

Scans the CLI bridge port range for the window whose workspace matches name and returns its port.

Ports are probed in ascending order from minPort to maxPort (inclusive, defaulting to the full defaultVSCodeBridgePort–maxVSCodeBridgePort range). For each responsive port the bridge's workspace identity is fetched and compared to name (normalised so the bare workspace name, a .code-workspace filename, and VS Code's " (Workspace)" multi-root suffix all match each other). The first matching port is returned.

Throws a BridgeWorkspaceNotFoundException if no responsive bridge in the range reports a matching workspace.

Implementation

Future<int> findBridgePortForWorkspace(
  String name, {
  String host = '127.0.0.1',
  int minPort = defaultVSCodeBridgePort,
  int maxPort = maxVSCodeBridgePort,
  BridgePortProbe probe = _defaultProbe,
  BridgeIdentityFetcher fetchIdentity = fetchBridgeWorkspaceName,
}) async {
  final target = normalizeWorkspaceName(name);
  for (var port = minPort; port <= maxPort; port++) {
    if (!await probe(host, port)) continue;
    final identity = await fetchIdentity(host, port);
    if (identity == null) continue;
    if (normalizeWorkspaceName(identity) == target) return port;
  }
  throw BridgeWorkspaceNotFoundException(name, minPort, maxPort);
}