Function resolveDevice

src/kernel/device.ts:224–283

(
  devices: DeviceInfo[],
  selector: DeviceSelector,
  context: DeviceSelectionContext = {},
)

}

export async function resolveDevice(
  devices: DeviceInfo[],
  selector: DeviceSelector,
  context: DeviceSelectionContext = {},
): Promise<DeviceInfo> {
  let candidates = devices.filter((device) => matchesDeviceSelector(device, selector));

  if (selector.udid) {
    const match = candidates.find(
      (device) => device.id === selector.udid && isApplePlatform(device.platform),
    );
    if (!match)
      throw new AppError('DEVICE_NOT_FOUND', `No Apple device with UDID ${selector.udid}`);
    return match;
  }

  if (selector.serial) {
    const match = candidates.find(
      (device) => device.id === selector.serial && device.platform === 'android',
    );
    if (!match)
      throw new AppError('DEVICE_NOT_FOUND', `No Android device with serial ${selector.serial}`);
    return match;
  }

  if (context.allowStoppedAndroidAvdPlaceholders !== true) {
    candidates = candidates.filter((device) => !isStoppedAndroidAvdPlaceholder(device));
  }

  if (selector.deviceName) {
    const normalizedName = normalizeDeviceName(selector.deviceName);
    const match = candidates.find((device) => normalizeDeviceName(device.name) === normalizedName);
    if (!match) throw new AppError('DEVICE_NOT_FOUND', `No device named ${selector.deviceName}`);
    return match;
  }

  if (isAppleDeviceCandidateSet(candidates)) {
    candidates = sortAppleDevicesForSelection(candidates);
  }

  const onlyCandidate = candidates[0];
  if (onlyCandidate !== undefined && candidates.length === 1) return onlyCandidate;

  if (candidates.length === 0) {
    throwNoDevicesFound(selector, context);
  }

  const virtual = candidates.filter((device) => device.kind !== 'device');
  const selectable = virtual.length > 0 ? virtual : candidates;
  const booted = selectable.filter((device) => device.booted);
  const onlyBooted = booted[0];
  if (onlyBooted && booted.length === 1 && !isAppleDeviceCandidateSet(selectable)) {
    return onlyBooted;
  }
  const selected = isAppleDeviceCandidateSet(selectable)
    ? selectable[0]
    : (booted[0] ?? selectable[0]);
  if (!selected) throwNoDevicesFound(selector, context);