The Platform service can be used to get information about your current device. You can get all of the platforms associated with the device using the platforms method, including whether the app is being viewed from a tablet, if it's on a mobile device or browser, and the exact platform (iOS, Android, etc). You can also get the orientation of the device, if it uses right-to-left language direction, and much much more. With this information you can completely customize your app to fit any device.

Usage

  1. import { Platform } from '@ionic/angular';
  3. @Component({...})
  4. export MyPage {
  5.   constructor(public plt: Platform) {
  7.   }
  8. }

Methods

is(platformName: Platforms) => boolean

Depending on the platform the user is on, is(platformName) will return true or false. Note that the same app can return true for more than one platform name. For example, an app running from an iPad would return true for the platform names: mobile, ios, ipad, and tablet. Additionally, if the app was running from Cordova then cordova would be true.

Parameters

NameTypeDescription
platformNamePlatformsName of the platform. Available options are android, capacitor, cordova, desktop, electron, hybrid, ios, ipad, iphone, mobile, phablet, pwa, tablet

Platforms

Below is a table listing all the possible Platforms values along with corresponding descriptions.

Platform NameDescription
androida device running Android
capacitora device running Capacitor
cordovaa device running Cordova
desktopa desktop device
electrona desktop device running Electron
hybrida device running Capacitor or Cordova
iosa device running iOS
ipadan iPad device
iphonean iPhone device
mobilea mobile device
phableta phablet device
pwaa PWA app
tableta tablet device

platforms() => string[]

Depending on what device you are on, platforms can return multiple values. Each possible value is a hierarchy of platforms. For example, on an iPhone, it would return mobile, ios, and iphone.

ready() => Promise<string>

Returns a promise when the platform is ready and native functionality can be called. If the app is running from within a web browser, then the promise will resolve when the DOM is ready. When the app is running from an application engine such as Cordova, then the promise will resolve when Cordova triggers the deviceready event. The resolved value is the readySource, which states the platform that was used.

For example, when Cordova is ready, the resolved ready source is cordova. The default ready source value will be dom. The readySource is useful if different logic should run depending on the platform the app is running from. For example, only Capacitor and Cordova can execute the status bar plugin, so the web should not run status bar plugin logic.

isRTL() => boolean

Returns if this app is using right-to-left language direction or not. We recommend the app's index.html file already has the correct dir attribute value set, such as <html dir="ltr"> or <html dir="rtl">. W3C: Structural markup and right-to-left text in HTML

isLandscape() => boolean

Returns true if the app is in landscape mode.

isPortrait() => boolean

Returns true if the app is in portrait mode.

width() => number

Gets the width of the platform's viewport using window.innerWidth.

height() => number

Gets the height of the platform's viewport using window.innerHeight.

url() => string

Get the current url.

testUserAgent(expression: string) => boolean

Returns true if the expression is included in the user agent string.

Parameters

NameTypeDescription
expressionstringThe string to check in the user agent