Function getSimulatorState

src/platforms/apple/core/simulator.ts:248–273

(deviceOrUdid: DeviceInfo | string)

}

export async function getSimulatorState(deviceOrUdid: DeviceInfo | string): Promise<string | null> {
  const udid = typeof deviceOrUdid === 'string' ? deviceOrUdid : deviceOrUdid.id;
  const simctlArgs =
    typeof deviceOrUdid === 'string'
      ? buildSimctlArgs(['list', 'devices', '-j'])
      : buildSimctlArgsForDevice(deviceOrUdid, ['list', 'devices', '-j']);
  const result = await runXcrun(simctlArgs, {
    allowFailure: true,
    timeoutMs: IOS_SIMCTL_LIST_TIMEOUT_MS,
  });
  if (result.exitCode !== 0) return null;

  try {
    const payload = JSON.parse(String(result.stdout ?? '')) as {
      devices: Record<string, { udid: string; state: string }[]>;
    };

    for (const runtime of Object.values(payload.devices ?? {})) {
      const match = runtime.find((entry) => entry.udid === udid);
      if (match) return match.state;
    }
    return null;
  } catch {
    return null;
  }
}