Add function to allow setting Useragent (close #744)

Author: miike

core/README.md

@@ -33,6 +33,7 @@ coreInstance.setPlatform('web');
 coreInstance.setUserId('user-321');
 coreInstance.setColorDepth(24);
 coreInstance.setViewport(600, 400);
+coreInstance.setUseragent('Snowplow/0.0.1');
 
 // Track a page view with URL and title
 var pageViewPayload = coreInstance.trackPageView('http://www.example.com', 'landing page');

core/lib/core.ts

@@ -336,6 +336,15 @@ export function trackerCore(base64: boolean, callback?: (PayloadData) => void) {
 			addPayloadPair('ip', ip);
 		},
 
+		/**
+		 * Set the Useragent
+		 *
+		 * @param useragent string
+		 */
+		setUseragent: function (useragent: string) {
+			addPayloadPair('ua', useragent);
+		},
+
 		trackUnstructEvent: trackSelfDescribingEvent,
 
 		trackSelfDescribingEvent: trackSelfDescribingEvent,

core/tests/unit/core.js

@@ -697,6 +697,7 @@ define([
 			tracker.setColorDepth(24);
 			tracker.setTimezone('Europe London');
 			tracker.setIpAddress('37.151.33.154');
+			tracker.setUseragent('SnowplowJavascript/0.0.1');
 			var url = 'http://www.example.com';
 			var page = 'title page';
 			var expected = {
@@ -712,7 +713,8 @@ define([
 				vp: '500x800',
 				cd: 24,
 				tz: 'Europe London',
-				ip: '37.151.33.154'
+				ip: '37.151.33.154',
+				ua: 'SnowplowJavascript/0.0.1'
 			};
 
 			compare(tracker.trackPageView(url, page), expected, 'setXXX methods should work correctly');