Skip to main content

 

 

 

 

Template:OutSystems/Documentation_KB/Breadcrumb_New_Layout

 

 

Template:OutSystems/OSLanguageSwitcher

 

Applies only to Mobile Apps and Reactive Web Apps

 

 

OutSystems

Device

Template:OutSystems/Documentation_KB/ContentCollaboration
  • Edit
    Collaborate with us
    Edit this page on GitHub
  • Provides methods to access native capabilities of the device.

    Summary

    Functions
    whenReady Promise that is resolved when the 'deviceready' event is caught.

    Functions

    whenReady

    whenReady(): Promise<void>

    Promise that is resolved when the 'deviceready' event is caught.

    You should bind your code on this promise (whenReady().then(...)) instead of using the traditional approach of binding the event on document.addEventListener("deviceready", ...). The event fires when Cordova is fully loaded, i.e. it signals that Cordova's device APIs are loaded and are ready for use.

    Example:

    // get device information
    if (cordova) {
      $public.Device.whenReady().then(function() {
        $parameters.DeviceModel = device.model;
        $parameters.CordovaVersion = device.cordova;
        $parameters.Platform = device.platform;
        $parameters.UUID = device.uuid;
        $parameters.Version = device.version;
        $parameters.Manufacturer = device.manufacturer;
        $parameters.IsSimulator = device.isVirtual;
        $parameters.SerialNumber = device.serial;
        $resolve();
      });
    } else {
      // fallback when testing on desktop browser
      $resolve();
    }
    

    Returns: Promise<void>

    A Promise object that is fulfilled when the 'deviceready' event is caught.

    • Was this article helpful?