This version of the documentation is outdated!
Click here for the latest released version.
device.name
Get the device's model name.
var string = device.name;
Description
device.name
returns the name of the device's model or product. This value is set by the device manufacturer and may be different across versions of the same product.
Supported Platforms
- Android
- BlackBerry WebWorks (OS 5.0 and higher)
- iPhone
- Windows Phone 7 ( Mango )
Quick Example
// Android: Nexus One returns "Passion" (Nexus One code name)
// Motorola Droid returns "voles"
// BlackBerry: Torch 9800 returns "9800"
// iPhone: All devices returns a name set by iTunes e.g. "Joe's iPhone"
//
var name = device.name;
Full Example
<!DOCTYPE html>
<html>
<head>
<title>Device Properties Example</title>
<script type="text/javascript" charset="utf-8" src="cordova-1.6.1.js"></script>
<script type="text/javascript" charset="utf-8">
// Wait for Cordova to load
//
document.addEventListener("deviceready", onDeviceReady, false);
// Cordova is ready
//
function onDeviceReady() {
var element = document.getElementById('deviceProperties');
element.innerHTML = 'Device Name: ' + device.name + '<br />' +
'Device Cordova: ' + device.cordova + '<br />' +
'Device Platform: ' + device.platform + '<br />' +
'Device UUID: ' + device.uuid + '<br />' +
'Device Version: ' + device.version + '<br />';
}
</script>
</head>
<body>
<p id="deviceProperties">Loading device properties...</p>
</body>
</html>
Android Quirks
- Gets the product name instead of the model name.
- The product name is often the code name given during production.
- e.g. Nexus One returns "Passion", Motorola Droid returns "voles"
iPhone Quirks
- Gets the device's custom name instead of the device model name.
- The custom name is set by the owner in iTunes.
- e.g. "Joe's iPhone"
Windows Phone 7 Quirks
- returns the manufacturer specified device name, for example, the Samsung Focus returns 'SGH-i917'