System

Retrieves the time zone currently used by the device.

function getCurrentTimezone() {
    return blackberry.system.getCurrentTimezone(); // e.g. "America/New_York"
}

Returns the information of current system font, which is composed of the font family and font size.

Returns the JavaScript Object that contains fontFamily and fontSize properties.

<script type="text/javascript">
// Check system font information
var fontInfo = blackberry.system.getFontInfo();
alert("The font family of current system font is " + fontInfo.fontFamily + "\n" + "The size of current system font is " + fontInfo.fontSize);
</script>

Retrieves the list of all time zones supported by the device. The time zones are based on the Olson time zone database. For more information, refer to IANA.

This method will determine if the BlackBerry PlayBook or the BlackBerry Smartphone device is capable of the given service.

hasCapability() returns true if the BlackBerry device is capable of the service; false otherwise.

The supported string values for 'capability' are:
input.keyboard.issuretype (returns if the user is currently using SureType),
input.touch,
media.audio.capture,
media.video.capture,
media.recording,
location.gps,
location.maps,
storage.memorycard (checks for an EXTERNAL SD card only),
network.bluetooth,
network.wlan (WLAN wireless family includes 802.11, 802.11a, 802.11b, 802.11g),
network.3gpp (3GPP wireless family includes GPRS, EDGE, UMTS, GERAN, UTRAN, and GAN),
network.cdma (CDMA wireless family includes CDMA1x and EVDO),
and network.iden.

Returns true if the device is capable of the given service.

This method returns true so long as the device is connected to any network. This can be used in conjunction with the network property to find out what kind of coverage it is in. On the smartphone this can be used in conjunction with blackberry.system.event.onCoverageChange to track changes.

Returns true if the BlackBerry PlayBook or the BlackBerry Smartphone device has any network interface active, otherwise returns false. Always returns true on the PlayBook simulator. Please note, that on the PlayBook device, there might be a small delay of 2-3 seconds between the time the device connects until the method returns true.

Determines the level of access to the requested module.

The possible return values: 0 - ALLOW 1 - DENY

Returns whether USB MassStorage mode is active.

Always returns false on the BlackBerry PlayBook since Mass Storage Mode is not supported. All memory is presented as a network share when connected by USB and is not blocked.

Set the image that appears as the background of the Home screen on a BlackBerry device.

This event is fired by the system. If you want to listen to the event you can do so using the blackberry.event.addEventListener function and remove the listener using the blackberry.event.removeEventListener function.
The batterycritical event is triggered whenever the battery level changes to the value lower than 5%.

<script type="text/javascript">

function onBatteryCritical(info) {
  alert("The battery level is critical: " + info.level + (info.isPlugged?".":" and will shutdown soon. Save your work or connect device to a charging source."));
}

blackberry.event.addEventListener("batterycritical", onBatteryCritical);

</script>

This event is fired by the system. If you want to listen to the event you can do so using the blackberry.event.addEventListener function and remove the listener using the blackberry.event.removeEventListener function.
The batterylow event is triggered whenever the battery level changes to the value lower than 15%.

<script type="text/javascript">

function onBatteryLow(info) {
  alert("The battery level is low: " + info.level + (info.isPlugged?".":". Consider connecting your device to a charging source."));
}

blackberry.event.addEventListener("batterylow", onBatteryLow);

</script>

This event is fired by the system. If you want to listen to the event you can do so using the blackberry.event.addEventListener function and remove the listener using the blackberry.event.removeEventListener function.
The batterystatus event is triggered whenever the:

• battery level changes
• device starts to receive a charge
• device stops receiving a charge

<script type="text/javascript">

function onBatteryStatusChange(info) {
  alert("The playbook " + info.isPlugged?"is ":"is not " + "plugged in with " + info.level + "% battery remaining");
}

blackberry.event.addEventListener("batterystatus", onBatteryStatusChange);

</script>

This event is fired by the system. If you want to listen to the event you can do so using the blackberry.event.addEventListener function and remove the listener using the blackberry.event.removeEventListener function.
The fontchanged event is triggered whenever the font setting of the system is changed.

<script type="text/javascript">

function onFontChange(fontInfo) {
  alert("The system font has changed to " + fontInfo.fontFamily + " size " + fontInfo.fontSize);
}

blackberry.event.addEventListener("fontchanged", onFontChange);
</script>

This event is fired by the system. If you want to listen to the event you can do so using the blackberry.event.addEventListener function and remove the listener using the blackberry.event.removeEventListener function.
The languagechanged event is triggered whenever the language setting of the device is changed.

<script type="text/javascript">

function onLanguageChange(newLanguage) {
  alert("The laguage has changed to " + newLanguage);
}

blackberry.event.addEventListener("languagechanged", onLanguageChange);
</script>

This event is fired by the system. If you want to listen to the event you can do so using the blackberry.event.addEventListener function and remove the listener using the blackberry.event.removeEventListener function.
The regionChanged event is triggered whenever the regional setting of the device is changed.

<script type="text/javascript">

function onRegionChange(newRegion) {
  alert("The current region has changed to " + newRegion);
}

blackberry.event.addEventListener("regionchanged", onRegionChange);
</script>

Returns the hardware identifier for the device.

Returns the current UI language for the device. Examples of possible values include, but are not limited to "fr_CA", "en_CA", "en_US", and "es_ES". The format of the response conforms to BCP47.

Returns the model number of the BlackBerry PlayBook or the BlackBerry Smartphone device.

Returns the name of the device.

Returns the current country setting for the device. The region determines the format of items such as the date, time, numbers, and the calendar. Examples of possible values include, but are not limited to "fr_CA", "en_CA", "en_US", and "es_ES". The format of the response conforms to BCP47.

Returns the current version of the operating system, for example, 1.0.0.0.

Returns the current version of the operating system, for example, 1.0.0.0.

Returned by hasPermission() indicating that the module requested is accessible.

Returned by hasPermission() indicating that the module is not accessible.

The objects in hasPermission will always be ALLOW (0). They will correspond to all the entries in the whitelist. If they are not whitelisted, they are omitted from the list. Similarly, all of the objects in hasCapability will be true, otherwise they will be omitted.

 {
    "data":{
        "hasCapability":[
            "location.gps",
            "media.audio.capture",
            "media.video.capture",
            "media.recording",
            "network.bluetooth",
            "network.wlan"
        ],
        "softwareVersion":"QNX",
        "hasPermission":[
            "blackberry.invoke",
            "blackberry.system",
            "blackberry.app",
            "blackberry.app.event",
            "blackberry.system.event",
            "blackberry.ui.dialog",
            "blackberry.utils"
        ],
        "model":100669958,
        "hasDataCoverage":true,
        "scriptApiVersion":"1.0.0.0",
        "isMassStorageActive":false
    }
} 

<html>
<head>
    <script type="text/javascript" src="js/jquery-1.4.2.js" ></script>
    <script type="text/javascript" src="js/jquery.form.js" ></script>
    <script type="text/javascript" src="js/jquery.populate.js" ></script>

    <script type="text/javascript">
         function getSystemData(){
             $.ajax({
                 type: "get",
                 url: "http://localhost:8472/blackberry/system/get",
                 success: function(msg){
                     $('#mySystemDiv').populate(JSON.parse(msg).data);
                 }
              });
          }
     </script>

</head>
<body>

   <input type="button" onclick="getSystemData();" value="Populate - System"/>
   <div id="mySystemDiv">
       Software Version: <span id="softwareVersion"></span><br/>
       Mass Storage Active: <span id="isMassStorageActive"></span>
   </div>

</body>
</html>