Expo

Documentation

Device

Provides access to system information about the physical device, such as its manufacturer and model.

For managed apps, you'll need to run expo install expo-device. To use it in a bare React Native app, follow its installation instructions.

import * as Device from 'expo-device';

true if the app is running on a real device and false if running in a simulator or emulator. On web, this always returns true.

The device brand. The consumer-visible brand of the product/hardware. On web, this value is null.

Device.brand; // Android: "google", "xiaomi"; iOS: "Apple"; web: null

The actual device manufacturer of the product or hardware. This value of this field may be null if it cannot be determined.

Device.manufacturer; // Android: "Google", "xiaomi"; iOS: "Apple"; web: "Google", null
Click here to view the Android documentation about the difference between brand and manufacturer.

The human-friendly name of the device model. This is the name that people would typically use to refer to the device rather than a programmatic model identifier. This value of this field may be null if it cannot be determined.

Device.modelName; // Android: "Pixel 2"; iOS: "iPhone XS Max"; web: "iPhone", null

iOS only. The internal model ID of the device. This is useful for programmatically identifying the type of device and is not a human-friendly string. On web and Android, this value is null.

Device.modelId; // iOS: "iPhone7,2"; Android: null; web: null

Android only. The specific configuration or name of the industrial design. It represents the device's name when it was designed during manufacturing into mass production. On Android, it corresponds to Build.DEVICE. On web and iOS, this value is null.

Device.designName; // Android: "kminilte"; iOS: null; web: null

Android only. The device's overall product name chosen by the device implementer containing the development name or code name of the device. Corresponds to Build.PRODUCT. On web and iOS, this value is null.

Device.productName; // Android: "kminiltexx"; iOS: null; web: null

The device year class of this device. On web, this value is null.

The device's total memory, in bytes. This is the total memory accessible to the kernel, but not necessarily to a single app. This is basically the amount of RAM the device has, not including below-kernel fixed allocations like DMA buffers, RAM for the baseband CPU, etc… On web, this value is null.

Device.totalMemory; // 17179869184

A list of supported processor architecture versions. The device expects the binaries it runs to be compiled for one of these architectures. This value is null if the supported architectures could not be determined, particularly on web.

Device.supportedCpuArchitectures; // ['arm64 v8', 'Intel x86-64h Haswell', 'arm64-v8a', 'armeabi-v7a", 'armeabi']

The name of the OS running on the device.

Device.osName; // Android: "Android"; iOS: "iOS" or "iPadOS"; web: "iOS", "Android", "Windows"

The human-readable OS version string. Note that the version string may not always contain three numbers separated by dots.

Device.osVersion; // Android: "4.0.3"; iOS: "12.3.1"; web: "11.0", "8.1.0"

The build ID of the OS that more precisely identifies the version of the OS. On Android, this corresponds to Build.DISPLAY (not Build.ID) and currently is a string as described here. On iOS, this corresponds to kern.osversion and is the detailed OS version sometimes displayed next to the more human-readable version. On web, this value is null.

Device.osBuildId; // Android: "PSR1.180720.075"; iOS: "16F203"; web: null

The internal build ID of the OS running on the device. On Android, this corresponds to Build.ID. On iOS, this is the same value as Device.osBuildId. On web, this value is null.

Device.osInternalBuildId; // Android: "MMB29K"; iOS: "16F203"; web: null,

Android only. A string that uniquely identifies the build of the currently running system OS. On web and iOS, this value is null. On Android, it follows this template:
$(BRAND)/$(PRODUCT)/$(DEVICE)/$(BOARD):$(VERSION.RELEASE)/$(ID)/$(VERSION.INCREMENTAL):$(TYPE)/\$(TAGS)

Device.osBuildFingerprint;
// Android: "google/sdk_gphone_x86/generic_x86:9/PSR1.180720.075/5124027:user/release-keys";
// iOS: null; web: null

Android only. The Android SDK version of the software currently running on this hardware device. This value never changes while a device is booted, but it may increase when the hardware manufacturer provides an OS update. See here to see all possible version codes and corresponding versions. On web and iOS, this value is null.

Device.platformApiLevel; // Android: 19; iOS: null; web: null

The human-readable name of the device, which may be set by the device's user. If the device name is unavailable, particularly on web, this value is null.

Device.deviceName; // "Vivian's iPhone XS"

Checks the type of the device as a Device.DeviceType enum value.
On Android, for devices other than TVs, the device type is determined by the screen resolution (screen diagonal size), so the result may not be completely accurate. If the screen diagonal length is between 3" and 6.9", the method returns DeviceType.PHONE. For lengths between 7" and 18", the method returns DeviceType.TABLET. Otherwise, the method returns DeviceType.UNKNOWN.

Returns a promise that resolves to a Device.DeviceType enum value.
Examples
await Device.getDeviceTypeAsync();
// DeviceType.PHONE

Gets the uptime since the last reboot of the device, in milliseconds.

Returns a promise that resolves to a number that represents the milliseconds since last reboot. Android devices dp not count time spent in deep sleep. On web, this throws an UnavailabilityError.
Examples
await Device.getUptimeAsync();
// 4371054

Android only. Returns the maximum amount of memory that the Java VM will attempt to use. If there is no inherent limit then Number.MAX_SAFE_INTEGER is returned.

Returns a promise that resolves to the maximum available memory that the Java vm will use, in bytes. On iOS and web, this throws an UnavailabilityError.
Examples
await Device.getMaxMemoryAsync();
// 402653184

WARNING: This method is experimental and is not completely reliable. See description below.
Checks whether the device has been rooted (Android) or jailbroken (iOS). This is not completely reliable because there exist solutions to bypass root-detection on both iOS and Android. Further, many root-detection checks can be bypassed via reverse engineering.
On Android, it's implemented in a way to find all possible files paths that contain the "su" executable but some devices that are not rooted may also have this executable. Therefore, there's no guarantee that this method will always return correctly.
On iOS, these jailbreak checks are used to detect if a device is rooted/jailbroken. However, since there are closed-sourced solutions such as xCon that aim to hook every known method and function responsible for informing an application of a jailbroken device, this method may not reliably detect devices that have xCon or similar packages installed.
On web, this always resolves to false even if the device is rooted.

Returns a promise that resolves to a boolean that specifies whether this device is rooted. Examples
await Device.isRootedExperimentalAsync();
// true or false

Android only. Returns whether applications can be installed for this user via the system's Intent#ACTION_INSTALL_PACKAGE mechanism rather than through the OS's default app store, like Google Play.

Returns a promise that resolves to a boolean that represents whether the calling package is allowed to request package installation. On iOS and web, this throws an UnavailabilityError.
Examples
await Device.isSideLoadingEnabled();
// true or false

Android only. Gets a list of features that are available on the system. The feature names are platform-specific. See here to view Android official docs about this implementation.

Returns a promise that resolves to an array of strings, each of which is a platform-specific name of a feature available on the current device. On iOS and web, this always resolves to an empty array.
Examples
await Device.getPlatformFeaturesAsync();
// [
//   'android.software.adoptable_storage',
//   'android.hardware.sensor.accelerometer',
//   'android.software.backup',
//   'android.hardware.touchscreen',
// ]

Android only. Tells if the device has a specific system feature.

  • feature (string) -- The platform-specific name of the feature to check for on the device. You can get all available system features with Device.getSystemFeatureAsync(). See here to view acceptable feature strings.

Returns a promise that resolves to a boolean value indicating whether the device has the specified system feature. On iOS and web, this always resolves to false.
Examples
await Device.hasPlatformFeatureAsync('amazon.hardware.fire_tv');
// true or false

An enum of the different types of devices supported by Expo, with these values:
  • UNKNOWN -- An unrecognized device type
  • PHONE -- Mobile phone handsets, typically with a touch screen and held in one hand
  • TABLET -- Tablet computers, typically with a touch screen that is larger than a phone's
  • DESKTOP -- Desktop or laptop computers, typically with a keyboard and mouse
  • TV -- TV-based interfaces

CodeDescription
ERR_DEVICE_ROOT_DETECTIONError code thrown for isRootedExperimentalAsync. This may be thrown if there's no read access to certain system files.