Merge branch 'master' into production

Author: jinwoo-kim-nhn

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "tui-code-snippet",
-  "version": "1.2.9",
+  "version": "1.3.0",
   "description": "TOAST UI Utility: CodeSnippet",
   "main": "dist/tui-code-snippet.js",
   "scripts": {

package.json

@@ -21,7 +21,8 @@ var object = require('./object');
  * @param {function} iteratee Callback function
  * @param {Object} [context] Context(this) of callback function
  * @memberof tui.util
-  * //-- #1. Get Module --//
+ * @example
+ * //-- #1. Get Module --//
  * var util = require('tui-code-snippet'); // node, commonjs
  * var util = tui.util; // distribution file
  *
@@ -96,6 +97,7 @@ function forEachOwnProperties(obj, iteratee, context) {
  * @param {function} iteratee Callback function
  * @param {Object} [context] Context(this) of callback function
  * @memberof tui.util
+ * @example
  * //-- #1. Get Module --//
  * var util = require('tui-code-snippet'); // node, commonjs
  * var util = tui.util; // distribution file
@@ -136,6 +138,7 @@ function forEach(obj, iteratee, context) {
  * @param {Object} [context] Context(this) of callback function
  * @returns {Array} A new array composed of returned values from callback function
  * @memberof tui.util
+ * @example
  * //-- #1. Get Module --//
  * var util = require('tui-code-snippet'); // node, commonjs
  * var util = tui.util; // distribution file

src/js/collection.js

@@ -27,6 +27,7 @@ extend(util, require('./func'));
 extend(util, require('./inheritance'));
 extend(util, require('./string'));
 extend(util, require('./tricks'));
+extend(util, require('./request'));
 
 util.browser = require('./browser');
 util.popup = require('./window');

src/js/index.js

@@ -0,0 +1,51 @@
+/**
+ * @fileoverview This module has some functions for handling object as collection.
+ * @author NHN Ent.
+ *         FE Development Lab <dl_javascript@nhnent.com>
+ */
+'use strict';
+
+var object = require('./object');
+var collection = require('./collection');
+
+/**
+ * Request image ping.
+ * @param {String} url url for ping request
+ * @param {Object} trackingInfo infos for make query string
+ * @returns {HTMLElement}
+ * @memberof tui.util
+ * @example
+ * //-- #1. Get Module --//
+ * var util = require('tui-code-snippet'); // node, commonjs
+ * var util = tui.util; // distribution file
+ *
+ * //-- #2. Use property --//
+ * util.imagePing('https://www.google-analytics.com/collect', {
+ *     v: 1,
+ *     t: 'event',
+ *     tid: 'trackingid',
+ *     cid: 'cid',
+ *     dp: 'dp',
+ *     dh: 'dh'
+ * });
+ */
+function imagePing(url, trackingInfo) {
+    var queryString = collection.map(object.keys(trackingInfo), function(key, index) {
+        var startWith = index === 0 ? '' : '&';
+
+        return startWith + key + '=' + trackingInfo[key];
+    }).join('');
+    var trackingElement = document.createElement('img');
+
+    trackingElement.src = url + '?' + queryString;
+
+    trackingElement.style.display = 'none';
+    document.body.appendChild(trackingElement);
+    document.body.removeChild(trackingElement);
+
+    return trackingElement;
+}
+
+module.exports = {
+    imagePing: imagePing
+};

src/js/request.js

@@ -0,0 +1,24 @@
+'use strict';
+
+var request = require('../src/js/request');
+
+describe('module:request', function() {
+    describe('imagePing', function() {
+        beforeEach(function() {
+            document.body.innerHTML = '';
+        });
+
+        it('should add tracking dom in body', function() {
+            var trackingElement = request.imagePing('https://www.google-analytics.com/collect', {
+                v: 1,
+                t: 'event',
+                tid: 'tracnkingid',
+                cid: 'cid',
+                dp: 'dp',
+                dh: 'dh'
+            });
+
+            expect(trackingElement.src).toBe('https://www.google-analytics.com/collect?v=1&t=event&tid=tracnkingid&cid=cid&dp=dp&dh=dh');
+        });
+    });
+});