@capacitor/device

What is @capacitor/device?

@capacitor/device is a Capacitor plugin that provides access to device information such as the device model, operating system, and unique identifiers. It allows developers to retrieve various details about the device on which their app is running.

What are @capacitor/device's main functionalities?

Get Device Info

This feature allows you to retrieve general information about the device, such as the model, operating system, and manufacturer.

const { Device } = require('@capacitor/device');

async function getDeviceInfo() {
  const info = await Device.getInfo();
  console.log(info);
}

getDeviceInfo();

Get Battery Info

This feature allows you to get information about the device's battery status, including the battery level and whether the device is charging.

const { Device } = require('@capacitor/device');

async function getBatteryInfo() {
  const info = await Device.getBatteryInfo();
  console.log(info);
}

getBatteryInfo();

Get Language Code

This feature allows you to retrieve the device's current language code, which can be useful for localization purposes.

const { Device } = require('@capacitor/device');

async function getLanguageCode() {
  const info = await Device.getLanguageCode();
  console.log(info);
}

getLanguageCode();

Get Unique ID

This feature allows you to get a unique identifier for the device, which can be used for tracking or analytics purposes.

const { Device } = require('@capacitor/device');

async function getUniqueId() {
  const info = await Device.getId();
  console.log(info);
}

getUniqueId();

Other packages similar to @capacitor/device

react-native-device-info

react-native-device-info is a React Native library that provides device information such as device model, system version, and unique identifiers. It offers similar functionalities to @capacitor/device but is specifically designed for React Native applications.

cordova-plugin-device

cordova-plugin-device is a Cordova plugin that provides information about the device's hardware and software. It offers functionalities similar to @capacitor/device but is intended for use with Cordova-based projects.

expo-device

expo-device is an Expo module that provides information about the device, such as the device model, operating system, and unique identifiers. It is similar to @capacitor/device but is designed for use with Expo and React Native projects.

README

@capacitor/device

The Device API exposes internal information about the device, such as the model and operating system version, along with user information such as unique ids.

Install

npm install @capacitor/device
npx cap sync

Example

import { Device } from '@capacitor/device';

const logDeviceInfo = async () => {
  const info = await Device.getInfo();

  console.log(info);
};

const logBatteryInfo = async () => {
  const info = await Device.getBatteryInfo();

  console.log(info);
};

API

• getId()
• getInfo()
• getBatteryInfo()
• getLanguageCode()
• getLanguageTag()
• Interfaces
• Type Aliases

getId()

getId() => Promise<DeviceId>

Return an unique identifier for the device.

Returns: Promise<DeviceId>

Since: 1.0.0

---

getInfo()

getInfo() => Promise<DeviceInfo>

Return information about the underlying device/os/platform.

Returns: Promise<DeviceInfo>

Since: 1.0.0

---

getBatteryInfo()

getBatteryInfo() => Promise<BatteryInfo>

Return information about the battery.

Returns: Promise<BatteryInfo>

Since: 1.0.0

---

getLanguageCode()

getLanguageCode() => Promise<GetLanguageCodeResult>

Get the device's current language locale code.

Returns: Promise<GetLanguageCodeResult>

Since: 1.0.0

---

getLanguageTag()

getLanguageTag() => Promise<LanguageTag>

Get the device's current language locale tag.

Returns: Promise<LanguageTag>

Since: 4.0.0

---

Interfaces

DeviceId

Prop	Type	Description	Since
uuid	string	The UUID of the device as available to the app. This identifier may change on modern mobile platforms that only allow per-app install UUIDs. On web, a random identifier is generated and stored on localStorage for subsequent calls. If localStorage is not available a new random identifier will be generated on every call.	1.0.0

DeviceInfo

Prop	Type	Description	Since
name	string	The name of the device. For example, "John's iPhone". This is only supported on iOS and Android 7.1 or above.	1.0.0
model	string	The device model. For example, "iPhone13,4".	1.0.0
platform	'ios' | 'android' | 'web'	The device platform (lowercase).	1.0.0
operatingSystem	OperatingSystem	The operating system of the device.	1.0.0
osVersion	string	The version of the device OS.	1.0.0
manufacturer	string	The manufacturer of the device.	1.0.0
isVirtual	boolean	Whether the app is running in a simulator/emulator.	1.0.0
memUsed	number	Approximate memory used by the current app, in bytes. Divide by 1048576 to get the number of MBs used.	1.0.0
diskFree	number	How much free disk space is available on the the normal data storage path for the os, in bytes. On Android it returns the free disk space on the "system" partition holding the core Android OS. On iOS this value is not accurate.	1.0.0
diskTotal	number	The total size of the normal data storage path for the OS, in bytes. On Android it returns the disk space on the "system" partition holding the core Android OS.	1.0.0
realDiskFree	number	How much free disk space is available on the the normal data storage, in bytes.	1.1.0
realDiskTotal	number	The total size of the normal data storage path, in bytes.	1.1.0
webViewVersion	string	The web view browser version	1.0.0

BatteryInfo

Prop	Type	Description	Since
batteryLevel	number	A percentage (0 to 1) indicating how much the battery is charged.	1.0.0
isCharging	boolean	Whether the device is charging.	1.0.0

GetLanguageCodeResult

Prop	Type	Description	Since
value	string	Two character language code.	1.0.0

LanguageTag

Prop	Type	Description	Since
value	string	Returns a well-formed IETF BCP 47 language tag.	4.0.0

Type Aliases

OperatingSystem

'ios' | 'android' | 'windows' | 'mac' | 'unknown'