Newer Version Available

This content describes an older version of this product. View Latest

$Browser

The $Browser global value provider returns information about the hardware and operating system of the browser accessing the application.
Attribute Description
formFactor Returns a FormFactor enum value based on the type of hardware the browser is running on.
  • DESKTOP for a desktop client
  • PHONE for a phone including a mobile phone with a browser and a smartphone
isAndroid Indicates whether the browser is running on an Android device (true) or not (false).
isIOS Due to changes made by Apple, $Browser is deprecated because it no longer distinguishes between iPad and MacOS desktop.
isIPad Due to changes made by Apple, $Browser is deprecated because it no longer distinguishes between iPad and MacOS desktop.
isIPhone Not available in all implementations. Indicates whether the browser is running on an iPhone (true) or not (false).
isPhone Indicates whether the browser is running on a phone including a mobile phone with a browser and a smartphone (true), or not (false).
isTablet Indicates whether the browser is running on a tablet with Android 2.2 or later (true) or not (false).

Due to changes made by Apple, isTablet is deprecated for iOS devices because $Browser no longer distinguishes between iPad and MacOS desktop.

Note

isWindowsPhone Indicates whether the browser is running on a Windows phone (true) or not (false). This attribute detects only Windows phones and doesn’t detect tablets or other touch-enabled Windows 8 devices.

Example

This example shows usage of the $Browser global value provider.

1<aura:component>
2    {!$Browser.isTablet}
3    {!$Browser.isPhone}
4    {!$Browser.isAndroid}
5    {!$Browser.formFactor}
6</aura:component>

Similarly, you can check browser information in a client-side controller using $A.get().

1({
2    checkBrowser: function(component) {
3        var device = $A.get("$Browser.formFactor");
4        alert("You are using a " + device);
5    }
6})