51Degrees logo
Check out the latest documentation.

What's Covered

51Degrees device detector returns all detection results as a string. This tutorial demonstrates how to return results for the IsMobile property value as a boolean.

Code and Explanation

Getting started example of using 51Degrees device detection. The example shows how to:
  1. Set the configuration using a json object 

    										
var config = {"dataFile" : require("fiftyonedegreeslitetrie"),
              "properties" : "IsMobile",
              "stronglyTyped" : true
};

    Note: stronglyTyped does not need to be set explicitly as true is the default

  2. Instantiate the 51Degrees device detection provider with this connfiguration 

    										
var provider = new fiftyonedegrees.provider(config);
  3. Produce a match for a single HTTP User-Agent header 

    										
var match = provider.getMatch(userAgent);

  4. Extract the value of the IsMobile property as boolean 

    										
match.IsMobile;
This example should be run in the examples directory as the path to the data file is relative.
Full Source File 
									
var fiftyonedegrees = require("fiftyonedegreescore");

// Set the config.
var config = {"dataFile" : require("fiftyonedegreeslitetrie"),
              "properties" : "IsMobile",
              "logLevel" : "none",
              "stronglyTyped" : true
             };

var provider = new fiftyonedegrees.provider(config);

// User-Agent string of an iPhone mobile device.
var mobileUserAgent = ("Mozilla/5.0 (iPhone; CPU iPhone OS 7_1 like Mac OS X" +
") AppleWebKit/537.51.2 (KHTML, like Gecko) 'Version/7.0 Mobile/11D167 " +
"Safari/9537.53")

// User-Agent string of Firefox Web browser version 41 on desktop.
var desktopUserAgent = ("Mozilla/5.0 (Windows NT 6.3; WOW64; rv:41.0) " +
"Gecko/20100101 Firefox/41.0")
// User-Agent string of a MediaHub device.
var mediaHubUserAgent = ("Mozilla/5.0 (Linux; Android 4.4.2; X7 Quad Core " +
"Build/KOT49H) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 " +
"Chrome/30.0.0.0 Safari/537.36")

console.log('Unlike other examples, stronglyTyped is set to \'true\' ' +
            'in the config. This is the default if not set.\n');

console.log('Mobile User-Agent: ' + mobileUserAgent)

// Determines whether the mobile User-Agent is a mobile device.
var match = provider.getMatch(mobileUserAgent);
if (match.IsMobile){
    console.log('   Mobile\n');
} else {
    console.log('   Non-Mobile\n');
}

console.log('Desktop User-Agent: ' + desktopUserAgent)

// Determines whether the desktop User-Agent is a mobile device.
var match = provider.getMatch(desktopUserAgent);
if (match.IsMobile){
    console.log('   Mobile\n');
} else {
    console.log('   Non-Mobile\n');
}

console.log('MediaHub User-Agent: ' + mediaHubUserAgent)

// Determines whether the MediaHub User-Agent is a mobile device.
var match = provider.getMatch(mediaHubUserAgent);
if (match.IsMobile){
    console.log('   Mobile\n');
} else {
    console.log('   Non-Mobile\n');
}
Full Source File

Summary

In this tutorial you have seen how to use the detector to retrieve the IsMobile property for a pre-defined User-Agent string. It sets a boolean value to true or false from the original string value of "True" or "False", making if statements simpler to test.

More Tutorials