event.js 11 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346
  1. var request = require("request");
  2. var qs = require("querystring");
  3. var uuid = require("uuid");
  4. var should = require("should");
  5. var sinon = require("sinon");
  6. var url = require("url");
  7. var ua = require("../lib/index.js");
  8. var utils = require("../lib/utils.js")
  9. var config = require("../lib/config.js")
  10. describe("ua", function () {
  11. describe("#event", function () {
  12. var _enqueue;
  13. beforeEach(function () {
  14. _enqueue = sinon.stub(ua.Visitor.prototype, "_enqueue", function () {
  15. if (arguments.length === 3 && typeof arguments[2] === 'function') {
  16. arguments[2]();
  17. }
  18. return this;
  19. });
  20. });
  21. afterEach(function () {
  22. _enqueue.restore()
  23. });
  24. it("should be available via the #e shortcut", function () {
  25. var visitor = ua()
  26. visitor.e.should.equal(visitor.event)
  27. });
  28. it("should accept arguments (category, action)", function () {
  29. var category = Math.random().toString();
  30. var action = Math.random().toString();
  31. var visitor = ua()
  32. var result = visitor.event(category, action);
  33. visitor._context = result._context;
  34. result.should.eql(visitor, "should return a visitor that is identical except for the context");
  35. result.should.be.instanceof(ua.Visitor);
  36. result._context.should.eql(_enqueue.args[0][1], "the pageview params should be persisted as the context of the visitor clone")
  37. _enqueue.calledOnce.should.equal(true, "#_enqueue should have been called once");
  38. _enqueue.args[0][0].should.equal("event");
  39. _enqueue.args[0][1].should.have.keys("ec", "ea")
  40. _enqueue.args[0][1].ec.should.equal(category);
  41. _enqueue.args[0][1].ea.should.equal(action);
  42. });
  43. it("should accept arguments (category, action, fn)", function () {
  44. var category = Math.random().toString();
  45. var action = Math.random().toString();
  46. var fn = sinon.spy()
  47. ua().event(category, action, fn);
  48. _enqueue.calledOnce.should.equal(true, "#_enqueue should have been called once");
  49. _enqueue.args[0][0].should.equal("event");
  50. _enqueue.args[0][1].should.have.keys("ec", "ea")
  51. _enqueue.args[0][1].ec.should.equal(category);
  52. _enqueue.args[0][1].ea.should.equal(action);
  53. fn.calledOnce.should.equal(true, "callback should have been called once")
  54. });
  55. it("should accept arguments (category, action, label)", function () {
  56. var category = Math.random().toString();
  57. var action = Math.random().toString();
  58. var label = Math.random().toString();
  59. ua().event(category, action, label);
  60. _enqueue.calledOnce.should.equal(true, "#_enqueue should have been called once");
  61. _enqueue.args[0][0].should.equal("event");
  62. _enqueue.args[0][1].should.have.keys("ec", "ea", "el")
  63. _enqueue.args[0][1].ec.should.equal(category);
  64. _enqueue.args[0][1].ea.should.equal(action);
  65. _enqueue.args[0][1].el.should.equal(label);
  66. });
  67. it("should accept arguments (category, action, label, fn)", function () {
  68. var category = Math.random().toString();
  69. var action = Math.random().toString();
  70. var label = Math.random().toString();
  71. var fn = sinon.spy()
  72. ua().event(category, action, label, fn);
  73. _enqueue.calledOnce.should.equal(true, "#_enqueue should have been called once");
  74. _enqueue.args[0][0].should.equal("event");
  75. _enqueue.args[0][1].should.have.keys("ec", "ea", "el")
  76. _enqueue.args[0][1].ec.should.equal(category);
  77. _enqueue.args[0][1].ea.should.equal(action);
  78. _enqueue.args[0][1].el.should.equal(label);
  79. fn.calledOnce.should.equal(true, "callback should have been called once")
  80. });
  81. it("should accept arguments (category, action, label, value)", function () {
  82. var category = Math.random().toString();
  83. var action = Math.random().toString();
  84. var label = Math.random().toString();
  85. var value = Math.random();
  86. ua().event(category, action, label, value);
  87. _enqueue.calledOnce.should.equal(true, "#_enqueue should have been called once");
  88. _enqueue.args[0][0].should.equal("event");
  89. _enqueue.args[0][1].should.have.keys("ec", "ea", "el", "ev")
  90. _enqueue.args[0][1].ec.should.equal(category);
  91. _enqueue.args[0][1].ea.should.equal(action);
  92. _enqueue.args[0][1].el.should.equal(label);
  93. _enqueue.args[0][1].ev.should.equal(value);
  94. });
  95. it("should accept arguments (category, action, label, value, fn)", function () {
  96. var category = Math.random().toString();
  97. var action = Math.random().toString();
  98. var label = Math.random().toString();
  99. var value = Math.random();
  100. var fn = sinon.spy()
  101. ua().event(category, action, label, value, fn);
  102. _enqueue.calledOnce.should.equal(true, "#_enqueue should have been called once");
  103. _enqueue.args[0][0].should.equal("event");
  104. _enqueue.args[0][1].should.have.keys("ec", "ea", "el", "ev")
  105. _enqueue.args[0][1].ec.should.equal(category);
  106. _enqueue.args[0][1].ea.should.equal(action);
  107. _enqueue.args[0][1].el.should.equal(label);
  108. _enqueue.args[0][1].ev.should.equal(value);
  109. fn.calledOnce.should.equal(true, "callback should have been called once")
  110. });
  111. it("should accept arguments (category, action, label, value, params, fn)", function () {
  112. var category = Math.random().toString();
  113. var action = Math.random().toString();
  114. var label = Math.random().toString();
  115. var value = Math.random();
  116. var params = {"p": "/" + Math.random()}
  117. var fn = sinon.spy()
  118. ua().event(category, action, label, value, params, fn);
  119. _enqueue.calledOnce.should.equal(true, "#_enqueue should have been called once");
  120. _enqueue.args[0][0].should.equal("event");
  121. _enqueue.args[0][1].should.have.keys("ec", "ea", "el", "ev", "p")
  122. _enqueue.args[0][1].ec.should.equal(category);
  123. _enqueue.args[0][1].ea.should.equal(action);
  124. _enqueue.args[0][1].el.should.equal(label);
  125. _enqueue.args[0][1].ev.should.equal(value);
  126. _enqueue.args[0][1].p.should.equal(params.p);
  127. fn.calledOnce.should.equal(true, "callback should have been called once")
  128. });
  129. it("should accept arguments (params)", function () {
  130. var params = {
  131. ec: Math.random().toString(),
  132. ea: Math.random().toString(),
  133. el: Math.random().toString(),
  134. ev: Math.random(),
  135. "p": "/" + Math.random(),
  136. "empty": null
  137. }
  138. var json = JSON.stringify(params)
  139. ua().event(params);
  140. _enqueue.calledOnce.should.equal(true, "#_enqueue should have been called once");
  141. _enqueue.args[0][0].should.equal("event");
  142. _enqueue.args[0][1].should.have.keys("ec", "ea", "el", "ev", "p")
  143. _enqueue.args[0][1].ec.should.equal(params.ec);
  144. _enqueue.args[0][1].ea.should.equal(params.ea);
  145. _enqueue.args[0][1].el.should.equal(params.el);
  146. _enqueue.args[0][1].ev.should.equal(params.ev);
  147. _enqueue.args[0][1].p.should.equal(params.p);
  148. JSON.stringify(params).should.equal(json, "params should not have been modified")
  149. });
  150. it("should accept arguments (params, fn)", function () {
  151. var params = {
  152. ec: Math.random().toString(),
  153. ea: Math.random().toString(),
  154. el: Math.random().toString(),
  155. ev: Math.random(),
  156. "p": "/" + Math.random()
  157. }
  158. var fn = sinon.spy()
  159. ua().event(params, fn);
  160. _enqueue.calledOnce.should.equal(true, "#_enqueue should have been called once");
  161. _enqueue.args[0][0].should.equal("event");
  162. _enqueue.args[0][1].should.have.keys("ec", "ea", "el", "ev", "p")
  163. _enqueue.args[0][1].ec.should.equal(params.ec);
  164. _enqueue.args[0][1].ea.should.equal(params.ea);
  165. _enqueue.args[0][1].el.should.equal(params.el);
  166. _enqueue.args[0][1].ev.should.equal(params.ev);
  167. _enqueue.args[0][1].p.should.equal(params.p);
  168. fn.calledOnce.should.equal(true, "callback should have been called once")
  169. });
  170. it("should use the dp attribute as p for providing a event path", function () {
  171. var params = {
  172. ec: Math.random().toString(),
  173. ea: Math.random().toString(),
  174. "dp": "/" + Math.random(),
  175. }
  176. var json = JSON.stringify(params)
  177. ua().event(params);
  178. _enqueue.calledOnce.should.equal(true, "#_enqueue should have been called once");
  179. _enqueue.args[0][0].should.equal("event");
  180. _enqueue.args[0][1].should.have.keys("ec", "ea", "p")
  181. _enqueue.args[0][1].ec.should.equal(params.ec);
  182. _enqueue.args[0][1].ea.should.equal(params.ea);
  183. _enqueue.args[0][1].p.should.equal(params.dp);
  184. JSON.stringify(params).should.equal(json, "params should not have been modified")
  185. });
  186. it("should allow daisy-chaining and re-using parameters", function () {
  187. var params = {
  188. ec: Math.random().toString(),
  189. ea: Math.random().toString(),
  190. el: Math.random().toString(),
  191. ev: Math.random()
  192. }
  193. ua().event(params).event()
  194. _enqueue.calledTwice.should.equal(true, "#_enqueue should have been called twice, once for each event");
  195. _enqueue.args[0][0].should.equal(_enqueue.args[1][0]);
  196. _enqueue.args[0][1].ec.should.equal(_enqueue.args[1][1].ec);
  197. _enqueue.args[0][1].ea.should.equal(_enqueue.args[1][1].ea);
  198. _enqueue.args[0][1].el.should.equal(_enqueue.args[1][1].el);
  199. _enqueue.args[0][1].ev.should.equal(_enqueue.args[1][1].ev);
  200. });
  201. it("should extend and overwrite params when daisy-chaining", function () {
  202. var params = {
  203. ec: Math.random().toString(),
  204. ea: Math.random().toString(),
  205. el: Math.random().toString(),
  206. ev: Math.random()
  207. }
  208. var category = Math.random().toString();
  209. ua().event(params).event(category)
  210. _enqueue.calledTwice.should.equal(true, "#_enqueue should have been called twice, once for each event");
  211. _enqueue.args[0][0].should.equal(_enqueue.args[1][0]);
  212. _enqueue.args[0][1].ea.should.equal(_enqueue.args[1][1].ea);
  213. _enqueue.args[0][1].el.should.equal(_enqueue.args[1][1].el);
  214. _enqueue.args[0][1].ev.should.equal(_enqueue.args[1][1].ev);
  215. _enqueue.args[0][1].ec.should.equal(params.ec);
  216. _enqueue.args[1][1].ec.should.equal(category);
  217. });
  218. it("should re-use the path when daisy-chained to a pageview", function () {
  219. var path = "/" + Math.random()
  220. var params = {
  221. ec: Math.random().toString(),
  222. ea: Math.random().toString(),
  223. el: Math.random().toString(),
  224. ev: Math.random()
  225. }
  226. ua().pageview(path).event(params).event(params);
  227. _enqueue.calledThrice.should.equal(true, "#_enqueue should have been called twice, once for the pageview, once for the pageview");
  228. _enqueue.args[1][1].p.should.equal(path)
  229. _enqueue.args[2][1].p.should.equal(path)
  230. })
  231. it("should fail without event category", function () {
  232. var fn = sinon.spy()
  233. var action = Math.random().toString();
  234. var visitor = ua()
  235. var result = visitor.event(null, action, fn);
  236. visitor._context = result._context;
  237. result.should.eql(visitor, "should return a visitor that is identical except for the context");
  238. result.should.be.instanceof(ua.Visitor);
  239. result._context.should.eql({}, "the transaction params should not be persisted")
  240. _enqueue.called.should.equal(false, "#_enqueue should have not been called once");
  241. fn.calledOnce.should.equal(true, "callback should have been called once");
  242. fn.args[0][0].should.be.instanceof(Error);
  243. fn.thisValues[0].should.equal(visitor);
  244. });
  245. it("should fail without event action", function () {
  246. var fn = sinon.spy()
  247. var category = Math.random().toString();
  248. var visitor = ua()
  249. var result = visitor.event(category, null, fn);
  250. visitor._context = result._context;
  251. result.should.eql(visitor, "should return a visitor that is identical except for the context");
  252. result.should.be.instanceof(ua.Visitor);
  253. result._context.should.eql({}, "the transaction params should not be persisted")
  254. _enqueue.called.should.equal(false, "#_enqueue should have not been called once");
  255. fn.calledOnce.should.equal(true, "callback should have been called once");
  256. fn.args[0][0].should.be.instanceof(Error);
  257. fn.thisValues[0].should.equal(visitor);
  258. });
  259. });
  260. });