standard.feInfo

Queries general front-end properties.

Syntax

ui.Interface.frontCall("standard", "feInfo",
 [name], [result]) 
  1. name - The name of the property.
  2. result - The value of the property.

Usage

The feInfo front call returns a front-end property value depending on the property name passed in as the parameter.

Some feInfo options take an optional parameter, such as screenResolution:
CALL ui.Interface.frontCall("standard", "feInfo", ["screenResolution", 2], [resolution])
Table 1. Property names and descriptions for the standard.feInfo front call

feInfo property values

Property name Description
colorScheme

Returns the current brightness mode of the display device / user agent.

The possible values returned are: "light" or "dark".

dataDirectory

Returns the directory name that can be used for temporary files on the front-end side. This directory is cleaned at front-end start-up and end, and is common to all front-end instances.

The possible values returned are:

  • With Genero Application Server, this is not applicable.
  • With Genero Desktop Client, the local cache directory. For example, "/home/username/.cache/Four Js/Genero Desktop".
  • With Genero Mobile for Android™, this is the GMA application cache directory. Content may be erased, once the app is closed.
  • With Genero Mobile for iOS, this is the temporary directory in the application sandbox (iOS NSTemporaryDirectory() system call). Content may be erased, once the app is closed.
deviceModel Returns the name of the device, for example "iPad4,5".
deviceId
  • With Genero Mobile for iOS, returns the identifierForVendor.
  • With Genero Mobile for Android, returns the ANDROID_ID.
feName
The code identifying the type of front-end component.
Tip:

To save a network round trip, it is recommended to use ui.Interface.getFrontEndName() instead.

The possible values returned are:

  • "Genero Desktop Client" for Genero Desktop Client.
  • "GBC" for Genero Browser Client.
  • "GMA" for Genero Mobile for Android.
  • "GMI" for Genero Mobile for iOS.
fePath

The installation directory of the front-end executable.

  • With Genero Desktop Client, it returns the path to the installation directory of the GDC.
  • With Genero Application Server, it returns the path to the installation directory of the GAS.
  • With Genero Mobile for Android, it returns the installation directory. For example, "/data/data/com.fourjs.gma/fgl".
  • With Genero Mobile for iOS, it returns the installation directory. For example: "/private/var/mobile/Applications/B3E6-C48A-ED4EFA". Below the installation directory are the "Documents" (which is by default pwd), "GMI.app" (deployed p-code resides in GMI.app/app/) and "tmp" directories.
Important:

The installation path returned by this front call may change in future versions, do not base application code on this. On mobile devices, consider using the os.Path.pwd utility function to get the application working directory when executing programs.

freeStorageSpace Returns the number of bytes available on the (mobile) device.
ip

Returns the IP address of the network interface used for the GUI connection.

For mobile platforms, this is the preferred IP address of the device. If there is WIFI, either the IPv4 address is returned (for example: 192.168.0.12) or if there is no IPv4 address, the IPv6 address is returned (for example: 2a02:810a:82c0:478:d462:e334:6a1d:fb78). If there is no WIFI, either the cellular IPv4 or IPv6 address is returned. If there is no network, NULL is returned.

numScreens

Number of screens available on the front-end platform.

On typical front-end platforms and devices, the number of screens is 1. In some rare cases, a desktop computer can be configured with more than one screen.

osType

The operating system type where the front-end is running.

Possible return values include "WINDOWS", "LINUX", "OSX", "ANDROID", "IOS".

osVersion

The version of the operating system.

Example of returned values: "4.3", "5.10.15".

ppi

Returns the screen pixel density of the front-end platform (Pixels Per Inch). This front call takes an optional screen number as parameter (1 is the default).

  • With Genero Mobile for iOS, it returns the PixelsPerInch of an iOS device.
  • With Genero Mobile for Android, it returns the DPI (ppi == dpi)
screenResolution

Returns the screen resolution of the front-end platform. This front call takes an optional screen number as parameter (1 is the default).

Example of returned values: "1200x1824", "1920x1104".

Note:

For mobile devices, the value can change depending on the device orientation.

target

Returns the build platform target code name, identifying the operating system the front-end binary was compiled. This front call is provided for debugging purpose, do not base code on the returned value, it can change if the target OS version is upgraded for example. Use the ostype property instead.

Example of returned values:
  • "w64v110" = Windows® 64 bits, Visual C++ 11.
  • "d32a040" = Android 4.0 ARM 32 bits.
  • "d32x040" = Android 4.0 x86 32 bits.
  • "i32a070" = iOS 7.0 ARM 32 bits.
  • "i32x070" = iOS 7.0 x86 32 bits.
windowSize

Returns the current size of the front-end view-port.

  • For mobile front-ends, this is the size of the mobile screen.
  • For Genero Desktop Client, this is the size of the window container.
  • For Genero Browser Client, this is the size of the browser webview.

Example of returned values: "1200x1824", "1920x1104".

userPreferredLang

Returns the language and territory of the locale defined on the front-end platform, in the language_territory format.

  • For Genero Desktop Client and mobile front-ends, the front-end locale is defined by the operating system.
  • For Genero Browser Client, the front-end locale is defined in the web browser preferences.