Skip to content

Generated API reference

A resolved hardware product identifier.

readonly family: DeviceFamily

readonly identifier: string

readonly model: string


Presentation values derived from an OS build without losing the original build string.

readonly copyValue: string

readonly displayValue: string

readonly optional rawBuild?: string


A known build from the package catalog.

readonly build: string

readonly known: true

readonly platform: "iOS" | "iPadOS"

readonly releaseChannel: OsReleaseChannel

readonly optional releaseLabel?: string

readonly version: string


Input accepted by OS resolution and formatting helpers.

readonly build: string

readonly productIdentifier: string


A build that is not present in the package catalog.

readonly build: string

readonly known: false

readonly platform: OsPlatform

DeviceFamily = "iPhone" | "iPad"

A supported hardware family. New families may be added in minor releases.


OsPlatform = "iOS" | "iPadOS" | "unknown"

A platform name derived from the device family and known OS version.


OsReleaseChannel = "stable" | "beta" | "release-candidate" | "rapid-security-response"

The release stage encoded by a known build.


OsVersionResolution = KnownOsVersion | UnknownOsVersion

The lossless result of resolving an OS build.

formatOsVersion(input): FormattedOsVersion

Format a build for display and copying while preserving the original build value.

OsVersionInput

FormattedOsVersion


getDevice(productIdentifier): DeviceInfo | undefined

Resolve an exact Apple product identifier to structured device information.

string

DeviceInfo | undefined


getDeviceModelName(productIdentifier): string | undefined

Resolve an exact Apple product identifier to its marketing model name.

string

string | undefined


getOsVersion(input): OsVersionResolution

Resolve an exact OS build number while preserving unknown future builds.

OsVersionInput

OsVersionResolution