dispatch.html 18 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526
  1. <!DOCTYPE html>
  2. <html>
  3. <head>
  4. <title>Virtual World Framework</title>
  5. <script type="text/javascript" src="qunit.js"></script>
  6. <script type="text/javascript" src="../lib/async.js"></script>
  7. <script type="text/javascript" src="../lib/crypto.js"></script>
  8. <script type="text/javascript" src="../lib/md5.js"></script>
  9. <script type="text/javascript" src="../lib/alea.js"></script>
  10. <script type="text/javascript" src="../lib/mash.js"></script>
  11. <script type="text/javascript" src="../lib/vwf.js"></script>
  12. <script type="text/javascript" src="../lib/require.js"></script>
  13. <script type="text/javascript">
  14. require( {
  15. baseUrl: "../lib",
  16. paths: {
  17. jquery: "jquery-1.10.2.min",
  18. },
  19. }, [
  20. "domReady",
  21. "utility.js",
  22. "jquery",
  23. "vwf/configuration",
  24. "vwf/kernel/model",
  25. "vwf/model/javascript",
  26. "vwf/model/object",
  27. "vwf/model/stage/log",
  28. "vwf/kernel/view",
  29. "vwf/kernel/utility",
  30. "vwf/utility",
  31. "logger",
  32. ], function( ready, testUtility ) {
  33. // Test dispatching events.
  34. ready( function() {
  35. vwf.initialize(
  36. /* models */ [ "vwf/model/javascript", "vwf/model/object" ],
  37. /* views */ [ ]
  38. );
  39. var emptyParameters = [ {} ]; // eventData == {}
  40. var emptyNodeParameters = { "": [ {} ] }; // eventNodeData == {} for all nodes
  41. // Regular, non-dispatching event to the top.
  42. asyncTest( "Regular event top", function() {
  43. createFixture( function( topID, middleID, bottomID, baseID, cleanup ) {
  44. vwf.fireEvent( topID, "test" );
  45. deepEqual( vwf.execute( baseID, "this.properties.targets" ), [ "top bubble" ], "top fireEvent only visits top" );
  46. cleanup();
  47. start();
  48. } );
  49. } );
  50. // Dispatching event to the top.
  51. asyncTest( "Dispatching event top", function() {
  52. createFixture( function( topID, middleID, bottomID, baseID, cleanup ) {
  53. vwf.dispatchEvent( topID, "test", emptyParameters, emptyNodeParameters );
  54. deepEqual( vwf.execute( baseID, "this.properties.targets" ), [ "top bubble" ], "top dispatchEvent only visits top" );
  55. cleanup();
  56. start();
  57. } );
  58. } );
  59. // Regular, non-dispatching event to the bottom.
  60. asyncTest( "Regular event bottom", function() {
  61. createFixture( function( topID, middleID, bottomID, baseID, cleanup ) {
  62. vwf.fireEvent( bottomID, "test" );
  63. deepEqual( vwf.execute( baseID, "this.properties.targets" ), [ "bottom bubble" ], "bottom fireEvent only visits bottom" );
  64. cleanup();
  65. start();
  66. } );
  67. } );
  68. // Dispatching event to the bottom.
  69. asyncTest( "Dispatching event bottom", function() {
  70. createFixture( function( topID, middleID, bottomID, baseID, cleanup ) {
  71. vwf.dispatchEvent( bottomID, "test", emptyParameters, emptyNodeParameters );
  72. deepEqual( vwf.execute( baseID, "this.properties.targets" ), [ "top capture", "middle capture", "bottom bubble", "middle bubble", "top bubble" ],
  73. "bottom fireEvent captures from and bubbles to top" );
  74. cleanup();
  75. start();
  76. } );
  77. } );
  78. // Handled (cancelled) at target.
  79. asyncTest( "Handle at target", function() {
  80. createFixture( false, false, { capture: false, bubble: true }, function( topID, middleID, bottomID, baseID, cleanup ) {
  81. vwf.dispatchEvent( bottomID, "test", emptyParameters, emptyNodeParameters );
  82. deepEqual( vwf.execute( baseID, "this.properties.targets" ), [ "top capture", "middle capture", "bottom bubble" ],
  83. "handling at target prevents bubbling" );
  84. cleanup();
  85. start();
  86. } );
  87. } );
  88. // Handled (cancelled) at middle during capture.
  89. asyncTest( "Handle at middle capture", function() {
  90. createFixture( false, { capture: true }, false, function( topID, middleID, bottomID, baseID, cleanup ) {
  91. vwf.dispatchEvent( bottomID, "test", emptyParameters, emptyNodeParameters );
  92. deepEqual( vwf.execute( baseID, "this.properties.targets" ), [ "top capture", "middle capture" ],
  93. "handling at middle capture prevents further capture and bubbling" );
  94. cleanup();
  95. start();
  96. } );
  97. } );
  98. // Handled (cancelled) at middle during bubbling.
  99. asyncTest( "Handle at middle bubble", function() {
  100. createFixture( false, { capture: false, bubble: true }, false, function( topID, middleID, bottomID, baseID, cleanup ) {
  101. vwf.dispatchEvent( bottomID, "test", emptyParameters, emptyNodeParameters );
  102. deepEqual( vwf.execute( baseID, "this.properties.targets" ), [ "top capture", "middle capture", "bottom bubble", "middle bubble" ],
  103. "handling at middle bubble prevents further bubbling" );
  104. cleanup();
  105. start();
  106. } );
  107. } );
  108. // Implicit "handled" return value from the handlers.
  109. asyncTest( "Implicit 'handled'", function() {
  110. createFixture( {}, {}, {}, function( topID, middleID, bottomID, baseID, cleanup ) {
  111. vwf.dispatchEvent( bottomID, "test", emptyParameters, emptyNodeParameters );
  112. deepEqual( vwf.execute( baseID, "this.properties.targets" ), [ "top capture" ],
  113. "implicit undefined return in handler same as explicit true return" );
  114. cleanup();
  115. start();
  116. } );
  117. } );
  118. // Dispatching to the top with no arguments.
  119. asyncTest( "Dispatching with no parameters", function() {
  120. createFixture( function( topID, middleID, bottomID, baseID, cleanup ) {
  121. vwf.dispatchEvent( topID, "test" );
  122. deepEqual( vwf.execute( baseID, "this.properties.argumentss[0]" ), [ undefined ],
  123. "no parameters, no node-parameters, phase" );
  124. cleanup();
  125. start();
  126. } );
  127. } );
  128. // Dispatching to the top with parameters.
  129. asyncTest( "Dispatching with parameters", function() {
  130. createFixture( function( topID, middleID, bottomID, baseID, cleanup ) {
  131. vwf.dispatchEvent( topID, "test", [ { parameters: true } ] );
  132. deepEqual( vwf.execute( baseID, "this.properties.argumentss[0]" ), [ { parameters: true }, undefined ],
  133. "parameters, no node-parameters, phase" );
  134. cleanup();
  135. start();
  136. } );
  137. } );
  138. // Dispatching to the top with parameters and node-parameters.
  139. asyncTest( "Dispatching with parameters and node-parameters", function() {
  140. createFixture( function( topID, middleID, bottomID, baseID, cleanup ) {
  141. vwf.dispatchEvent( topID, "test", [ { parameters: true } ], { "": [ { nodeParameters: true } ] } );
  142. deepEqual( vwf.execute( baseID, "this.properties.argumentss[0]" ), [ { parameters: true }, { nodeParameters: true }, undefined ],
  143. "parameters, node-parameters, phase" );
  144. cleanup();
  145. start();
  146. } );
  147. } );
  148. // Dispatching to the bottom with default node-parameters.
  149. asyncTest( "Default node-parameters cascade to every target", function() {
  150. createFixture( function( topID, middleID, bottomID, baseID, cleanup ) {
  151. var nodeParameters = {
  152. "": [ { nodeParameters: true, default: true } ] // default
  153. };
  154. vwf.dispatchEvent( bottomID, "test", [ { parameters: true } ], nodeParameters );
  155. equal( vwf.execute( baseID, "this.properties.argumentss.length" ), 5, "two captures, three bubbles" ); // top capture, middle capture, bottom bubble, middle bubble, top bubble
  156. deepEqual( vwf.execute( baseID, "this.properties.argumentss[0][1]" ),
  157. { nodeParameters: true, default: true }, "default node-parameters at top capture" );
  158. deepEqual( vwf.execute( baseID, "this.properties.argumentss[1][1]" ),
  159. { nodeParameters: true, default: true }, "default node-parameters at middle capture" );
  160. deepEqual( vwf.execute( baseID, "this.properties.argumentss[2][1]" ),
  161. { nodeParameters: true, default: true }, "default node-parameters at bottom bubble" );
  162. deepEqual( vwf.execute( baseID, "this.properties.argumentss[3][1]" ),
  163. { nodeParameters: true, default: true }, "default node-parameters at middle bubble" );
  164. deepEqual( vwf.execute( baseID, "this.properties.argumentss[4][1]" ),
  165. { nodeParameters: true, default: true }, "default node-parameters at top bubble" );
  166. cleanup();
  167. start();
  168. } );
  169. } );
  170. // Dispatching to the bottom with default and top node-parameters.
  171. asyncTest( "Top node-parameters replace default and cascade to targets below", function() {
  172. createFixture( function( topID, middleID, bottomID, baseID, cleanup ) {
  173. var nodeParameters = {
  174. "": [ { nodeParameters: true, default: true } ] // default
  175. };
  176. nodeParameters[topID] = [ { nodeParameters: true, top: true } ]; // for top
  177. vwf.dispatchEvent( bottomID, "test", [ { parameters: true } ], nodeParameters );
  178. equal( vwf.execute( baseID, "this.properties.argumentss.length" ), 5, "two captures, three bubbles" ); // top capture, middle capture, bottom bubble, middle bubble, top bubble
  179. deepEqual( vwf.execute( baseID, "this.properties.argumentss[0][1]" ),
  180. { nodeParameters: true, top: true }, "top node-parameters at top capture" );
  181. deepEqual( vwf.execute( baseID, "this.properties.argumentss[1][1]" ),
  182. { nodeParameters: true, top: true }, "top node-parameters at middle capture" );
  183. deepEqual( vwf.execute( baseID, "this.properties.argumentss[2][1]" ),
  184. { nodeParameters: true, top: true }, "top node-parameters at bottom bubble" );
  185. deepEqual( vwf.execute( baseID, "this.properties.argumentss[3][1]" ),
  186. { nodeParameters: true, top: true }, "top node-parameters at middle bubble" );
  187. deepEqual( vwf.execute( baseID, "this.properties.argumentss[4][1]" ),
  188. { nodeParameters: true, top: true }, "top node-parameters at top bubble" );
  189. cleanup();
  190. start();
  191. } );
  192. } );
  193. // Dispatching to the bottom with default and middle node-parameters.
  194. asyncTest( "Middle node-parameters replace default and cascade to targets below", function() {
  195. createFixture( function( topID, middleID, bottomID, baseID, cleanup ) {
  196. var nodeParameters = {
  197. "": [ { nodeParameters: true, default: true } ] // default
  198. };
  199. nodeParameters[middleID] = [ { nodeParameters: true, middle: true } ]; // for middle
  200. vwf.dispatchEvent( bottomID, "test", [ { parameters: true } ], nodeParameters );
  201. equal( vwf.execute( baseID, "this.properties.argumentss.length" ), 5, "two captures, three bubbles" ); // top capture, middle capture, bottom bubble, middle bubble, top bubble
  202. deepEqual( vwf.execute( baseID, "this.properties.argumentss[0][1]" ),
  203. { nodeParameters: true, default: true }, "default node-parameters at top capture" );
  204. deepEqual( vwf.execute( baseID, "this.properties.argumentss[1][1]" ),
  205. { nodeParameters: true, middle: true }, "middle node-parameters at middle capture" );
  206. deepEqual( vwf.execute( baseID, "this.properties.argumentss[2][1]" ),
  207. { nodeParameters: true, middle: true }, "middle node-parameters at bottom bubble" );
  208. deepEqual( vwf.execute( baseID, "this.properties.argumentss[3][1]" ),
  209. { nodeParameters: true, middle: true }, "middle node-parameters at middle bubble" );
  210. deepEqual( vwf.execute( baseID, "this.properties.argumentss[4][1]" ),
  211. { nodeParameters: true, default: true }, "default node-parameters at top bubble" );
  212. cleanup();
  213. start();
  214. } );
  215. } );
  216. // Dispatching to the bottom with default and bottom node-parameters.
  217. asyncTest( "Bottom node-parameters replace default", function() {
  218. createFixture( function( topID, middleID, bottomID, baseID, cleanup ) {
  219. var nodeParameters = {
  220. "": [ { nodeParameters: true, default: true } ] // default
  221. };
  222. nodeParameters[bottomID] = [ { nodeParameters: true, bottom: true } ]; // for bottom
  223. vwf.dispatchEvent( bottomID, "test", [ { parameters: true } ], nodeParameters );
  224. equal( vwf.execute( baseID, "this.properties.argumentss.length" ), 5, "two captures, three bubbles" ); // top capture, middle capture, bottom bubble, middle bubble, top bubble
  225. deepEqual( vwf.execute( baseID, "this.properties.argumentss[0][1]" ),
  226. { nodeParameters: true, default: true }, "default node-parameters at top capture" );
  227. deepEqual( vwf.execute( baseID, "this.properties.argumentss[1][1]" ),
  228. { nodeParameters: true, default: true }, "default node-parameters at middle capture" );
  229. deepEqual( vwf.execute( baseID, "this.properties.argumentss[2][1]" ),
  230. { nodeParameters: true, bottom: true }, "bottom node-parameters at bottom bubble" );
  231. deepEqual( vwf.execute( baseID, "this.properties.argumentss[3][1]" ),
  232. { nodeParameters: true, default: true }, "default node-parameters at middle bubble" );
  233. deepEqual( vwf.execute( baseID, "this.properties.argumentss[4][1]" ),
  234. { nodeParameters: true, default: true }, "default node-parameters at top bubble" );
  235. cleanup();
  236. start();
  237. } );
  238. } );
  239. // == Helper functions =====================================================================
  240. // Create parent, child, and grandchild nodes with default and capture- and bubble-phase
  241. // event handlers.
  242. function createFixture( /* topResult, middleResult, bottomResult, callback */ ) {
  243. var args = Array.prototype.slice.call(arguments);
  244. // Parse the arguments.
  245. var callback = args.pop(); // callback is the last argument, regardless
  246. var result = {};
  247. [ "top", "middle", "bottom" ].forEach( function( which ) {
  248. result[which] = args.shift();
  249. if ( result[which] === undefined ) {
  250. result[which] = false; // explicitly return false ("not handled") by default
  251. }
  252. if ( typeof result[which] == "boolean" ) {
  253. result[which] = { capture: result[which], bubble: result[which] };
  254. }
  255. } );
  256. // Prototype for the three nodes.
  257. vwf.createNode( {
  258. extends: "http://vwf.example.com/node.vwf",
  259. properties: {
  260. targets: [],
  261. argumentss: [],
  262. },
  263. events: {
  264. test: undefined
  265. },
  266. scripts: [
  267. "var handler = function() { " +
  268. "return function( eventData, eventNodeData, phase ) { " +
  269. "var tag = this.name.split( '-' )[0] + ' ' + ( phase || 'bubble' ); " +
  270. "var result = this.properties.result[ phase || 'bubble' ]; " +
  271. "Object.getPrototypeOf( this ).properties.targets.push( tag ); " +
  272. "Object.getPrototypeOf( this ).properties.argumentss.push( Array.prototype.slice.call( arguments ) ); " +
  273. "if ( result !== undefined ) { " +
  274. "return result; " + // do an explicit return if a value is provided
  275. "} " + // otherwise fall out with a default return value of undefined
  276. "}; " +
  277. "}; " +
  278. "this.events.test = this.events.add( handler(), 'capture', this );"
  279. ],
  280. }, function( baseID ) {
  281. // Parent node.
  282. vwf.createChild( 0, testUtility.uniqueName( "top" ), {
  283. extends: baseID,
  284. properties: { result: result.top },
  285. }, undefined, function( topID ) {
  286. // Child node.
  287. vwf.createChild( topID, testUtility.uniqueName( "middle" ), {
  288. extends: baseID,
  289. properties: { result: result.middle },
  290. }, undefined, function( middleID ) {
  291. // Grandchild node.
  292. vwf.createChild( middleID, testUtility.uniqueName( "bottom" ), {
  293. extends: baseID,
  294. properties: { result: result.bottom },
  295. }, undefined, function( bottomID ) {
  296. // Call the test's callback to let it run its assertions. Then clean up after it
  297. // finishes and calls us back.
  298. callback( topID, middleID, bottomID, baseID, function() {
  299. vwf.deleteNode( bottomID );
  300. vwf.deleteNode( middleID );
  301. vwf.deleteNode( topID );
  302. vwf.deleteNode( baseID );
  303. } );
  304. } );
  305. } );
  306. } );
  307. } );
  308. }
  309. } );
  310. } );
  311. </script>
  312. <link rel="stylesheet" type="text/css" href="qunit.css" />
  313. </head>
  314. <body>
  315. <h1 id="qunit-header">Virtual World Framework</h1>
  316. <h2 id="qunit-banner"></h2>
  317. <div id="qunit-testrunner-toolbar"></div>
  318. <h2 id="qunit-userAgent"></h2>
  319. <ol id="qunit-tests"></ol>
  320. <div id="qunit-fixture">test markup, will be hidden</div>
  321. </body>
  322. </html>