ember-source 4.8.0-alpha.5 → 4.8.0-beta.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (244) hide show
  1. package/CHANGELOG.md +11 -2
  2. package/blueprints/helper/files/__root__/{__collection__ → helpers}/__name__.ts +0 -0
  3. package/blueprints/helper/index.js +0 -15
  4. package/blueprints/helper-test/index.js +0 -3
  5. package/blueprints/helper-test/mocha-0.12-files/__root__/__testType__/{__collection__ → helpers}/__name__-test.js +0 -0
  6. package/blueprints/helper-test/mocha-files/__root__/__testType__/{__collection__ → helpers}/__name__-test.js +0 -0
  7. package/blueprints/helper-test/mocha-rfc-232-files/__root__/__testType__/{__collection__ → helpers}/__name__-test.ts +0 -0
  8. package/blueprints/helper-test/qunit-files/__root__/__testType__/{__collection__ → helpers}/__name__-test.js +0 -0
  9. package/blueprints/helper-test/qunit-rfc-232-files/__root__/__testType__/{__collection__ → helpers}/__name__-test.ts +0 -0
  10. package/blueprints-js/helper/files/__root__/{__collection__ → helpers}/__name__.js +0 -0
  11. package/blueprints-js/helper-test/mocha-0.12-files/__root__/__testType__/{__collection__ → helpers}/__name__-test.js +0 -0
  12. package/blueprints-js/helper-test/mocha-files/__root__/__testType__/{__collection__ → helpers}/__name__-test.js +0 -0
  13. package/blueprints-js/helper-test/mocha-rfc-232-files/__root__/__testType__/{__collection__ → helpers}/__name__-test.js +0 -0
  14. package/blueprints-js/helper-test/qunit-files/__root__/__testType__/{__collection__ → helpers}/__name__-test.js +0 -0
  15. package/blueprints-js/helper-test/qunit-rfc-232-files/__root__/__testType__/{__collection__ → helpers}/__name__-test.js +0 -0
  16. package/build-metadata.json +3 -3
  17. package/dist/dependencies/router_js.js +1 -1
  18. package/dist/ember-template-compiler.js +675 -18
  19. package/dist/ember-template-compiler.map +1 -1
  20. package/dist/ember-testing.js +11 -11
  21. package/dist/ember-testing.map +1 -1
  22. package/dist/ember.debug.js +19576 -20510
  23. package/dist/ember.debug.map +1 -1
  24. package/dist/header/license.js +1 -1
  25. package/dist/packages/@ember/-internals/glimmer/index.js +4 -2
  26. package/dist/packages/@ember/-internals/metal/index.js +214 -1094
  27. package/dist/packages/@ember/-internals/routing/index.js +1 -17
  28. package/dist/packages/@ember/-internals/runtime/index.js +3 -16
  29. package/dist/packages/@ember/-internals/runtime/lib/mixins/-proxy.js +2 -1
  30. package/dist/packages/@ember/-internals/runtime/lib/mixins/action_handler.js +4 -3
  31. package/dist/packages/@ember/-internals/runtime/lib/mixins/comparable.js +1 -1
  32. package/dist/packages/@ember/-internals/runtime/lib/mixins/container_proxy.js +1 -1
  33. package/dist/packages/@ember/-internals/runtime/lib/mixins/registry_proxy.js +1 -8
  34. package/dist/packages/@ember/-internals/runtime/lib/mixins/target_action_support.js +2 -1
  35. package/dist/packages/@ember/-internals/utils/index.js +3 -3
  36. package/dist/packages/@ember/-internals/views/lib/component_lookup.js +1 -1
  37. package/dist/packages/@ember/-internals/views/lib/mixins/action_support.js +2 -1
  38. package/dist/packages/@ember/-internals/views/lib/mixins/child_views_support.js +2 -1
  39. package/dist/packages/@ember/-internals/views/lib/mixins/class_names_support.js +2 -1
  40. package/dist/packages/@ember/-internals/views/lib/mixins/view_state_support.js +1 -1
  41. package/dist/packages/@ember/-internals/views/lib/mixins/view_support.js +2 -1
  42. package/dist/packages/@ember/-internals/views/lib/system/event_dispatcher.js +1 -1
  43. package/dist/packages/@ember/-internals/views/lib/views/core_view.js +3 -1
  44. package/dist/packages/@ember/application/index.js +876 -2
  45. package/dist/packages/@ember/application/instance.js +2 -2
  46. package/dist/packages/@ember/application/namespace.js +70 -1
  47. package/dist/packages/@ember/array/index.js +1503 -2
  48. package/dist/packages/@ember/array/mutable.js +1 -1
  49. package/dist/packages/@ember/array/proxy.js +307 -1
  50. package/dist/packages/@ember/canary-features/index.js +2 -2
  51. package/dist/packages/@ember/controller/index.js +260 -3
  52. package/dist/packages/@ember/debug/container-debug-adapter.js +99 -1
  53. package/dist/packages/@ember/debug/data-adapter.js +574 -1
  54. package/dist/packages/@ember/engine/index.js +5 -5
  55. package/dist/packages/@ember/engine/instance.js +4 -4
  56. package/dist/packages/@ember/enumerable/index.js +3 -1
  57. package/dist/packages/@ember/enumerable/mutable.js +4 -0
  58. package/dist/packages/@ember/{-internals/runtime/lib/system/object.js → object/-internals.js} +4 -17
  59. package/dist/packages/@ember/object/core.js +731 -1
  60. package/dist/packages/@ember/object/evented.js +93 -2
  61. package/dist/packages/@ember/object/index.js +76 -4
  62. package/dist/packages/@ember/object/internals.js +3 -2
  63. package/dist/packages/@ember/object/lib/computed/computed_macros.js +3 -1
  64. package/dist/packages/@ember/object/lib/computed/reduce_computed_macros.js +4 -3
  65. package/dist/packages/@ember/object/mixin.js +659 -1
  66. package/dist/packages/@ember/object/observable.js +341 -1
  67. package/dist/packages/@ember/object/promise-proxy-mixin.js +150 -1
  68. package/dist/packages/@ember/object/proxy.js +10 -1
  69. package/dist/packages/@ember/routing/-internals.js +7 -0
  70. package/dist/packages/@ember/routing/auto-location.js +249 -1
  71. package/dist/packages/@ember/routing/hash-location.js +169 -1
  72. package/dist/packages/@ember/routing/history-location.js +289 -1
  73. package/dist/packages/@ember/{-internals/routing/lib/system → routing/lib}/cache.js +0 -0
  74. package/dist/packages/@ember/{-internals/routing/lib/system → routing/lib}/controller_for.js +0 -0
  75. package/dist/packages/@ember/{-internals/routing/lib/system → routing/lib}/dsl.js +0 -0
  76. package/dist/packages/@ember/{-internals/routing/lib/system → routing/lib}/engines.js +0 -0
  77. package/dist/packages/@ember/{-internals/routing/lib/system → routing/lib}/generate_controller.js +0 -0
  78. package/dist/packages/@ember/{-internals/routing/lib/location/util.js → routing/lib/location-utils.js} +0 -0
  79. package/dist/packages/@ember/{-internals/routing/lib/system → routing/lib}/query_params.js +0 -0
  80. package/dist/packages/@ember/{-internals/routing/lib/system → routing/lib}/route-info.js +0 -0
  81. package/dist/packages/@ember/{-internals/routing/lib/system → routing/lib}/router_state.js +1 -1
  82. package/dist/packages/@ember/{-internals/routing/lib/services/routing.js → routing/lib/routing-service.js} +2 -2
  83. package/dist/packages/@ember/{-internals/routing/lib/system → routing/lib}/transition.js +0 -0
  84. package/dist/packages/@ember/{-internals/routing → routing}/lib/utils.js +0 -0
  85. package/dist/packages/@ember/routing/location.js +104 -1
  86. package/dist/packages/@ember/routing/none-location.js +123 -1
  87. package/dist/packages/@ember/routing/route.js +1700 -1
  88. package/dist/packages/@ember/routing/router-service.js +510 -1
  89. package/dist/packages/@ember/routing/router.js +1666 -1
  90. package/dist/packages/@ember/service/index.js +1 -1
  91. package/dist/packages/@ember/utils/index.js +7 -2
  92. package/dist/packages/@ember/{-internals/runtime → utils}/lib/compare.js +2 -2
  93. package/dist/packages/@ember/{-internals/runtime → utils}/lib/is-equal.js +0 -0
  94. package/dist/packages/@ember/utils/lib/is_blank.js +35 -0
  95. package/dist/packages/@ember/utils/lib/is_empty.js +68 -0
  96. package/dist/packages/@ember/utils/lib/is_none.js +27 -0
  97. package/dist/packages/@ember/utils/lib/is_present.js +38 -0
  98. package/dist/packages/@ember/{-internals/runtime → utils}/lib/type-of.js +2 -2
  99. package/dist/packages/ember/index.js +47 -28
  100. package/dist/packages/ember/version.js +1 -1
  101. package/dist/packages/ember-testing/lib/adapters/adapter.js +1 -1
  102. package/dist/packages/ember-testing/lib/helpers/current_path.js +2 -2
  103. package/dist/packages/ember-testing/lib/helpers/current_route_name.js +2 -2
  104. package/dist/packages/ember-testing/lib/helpers/current_url.js +1 -1
  105. package/docs/data.json +9428 -9189
  106. package/package.json +23 -8
  107. package/types/preview/@ember/-internals/resolver.d.ts +35 -0
  108. package/types/preview/@ember/application/-private/event-dispatcher.d.ts +18 -0
  109. package/types/preview/@ember/application/-private/registry.d.ts +15 -0
  110. package/types/preview/@ember/application/deprecations.d.ts +24 -0
  111. package/types/preview/@ember/application/index.d.ts +153 -0
  112. package/types/preview/@ember/application/instance.d.ts +9 -0
  113. package/types/preview/@ember/application/tsconfig.json +3 -0
  114. package/types/preview/@ember/application/types.d.ts +29 -0
  115. package/types/preview/@ember/array/-private/enumerable.d.ts +13 -0
  116. package/types/preview/@ember/array/-private/mutable-enumerable.d.ts +13 -0
  117. package/types/preview/@ember/array/-private/native-array.d.ts +23 -0
  118. package/types/preview/@ember/array/index.d.ts +243 -0
  119. package/types/preview/@ember/array/mutable.d.ts +94 -0
  120. package/types/preview/@ember/array/proxy.d.ts +29 -0
  121. package/types/preview/@ember/array/tsconfig.json +3 -0
  122. package/types/preview/@ember/component/-private/class-names-support.d.ts +27 -0
  123. package/types/preview/@ember/component/-private/core-view.d.ts +14 -0
  124. package/types/preview/@ember/component/-private/glimmer-interfaces.d.ts +45 -0
  125. package/types/preview/@ember/component/-private/signature-utils.d.ts +107 -0
  126. package/types/preview/@ember/component/-private/view-mixin.d.ts +59 -0
  127. package/types/preview/@ember/component/helper.d.ts +122 -0
  128. package/types/preview/@ember/component/index.d.ts +132 -0
  129. package/types/preview/@ember/component/template-only.d.ts +47 -0
  130. package/types/preview/@ember/component/tsconfig.json +3 -0
  131. package/types/preview/@ember/controller/index.d.ts +48 -0
  132. package/types/preview/@ember/controller/tsconfig.json +3 -0
  133. package/types/preview/@ember/debug/container-debug-adapter.d.ts +13 -0
  134. package/types/preview/@ember/debug/data-adapter.d.ts +64 -0
  135. package/types/preview/@ember/debug/index.d.ts +98 -0
  136. package/types/preview/@ember/debug/tsconfig.json +3 -0
  137. package/types/preview/@ember/destroyable/index.d.ts +23 -0
  138. package/types/preview/@ember/destroyable/tsconfig.json +3 -0
  139. package/types/preview/@ember/engine/-private/container-proxy-mixin.d.ts +17 -0
  140. package/types/preview/@ember/engine/-private/registry-proxy-mixin.d.ts +54 -0
  141. package/types/preview/@ember/engine/-private/types/initializer.d.ts +8 -0
  142. package/types/preview/@ember/engine/index.d.ts +45 -0
  143. package/types/preview/@ember/engine/instance.d.ts +24 -0
  144. package/types/preview/@ember/engine/tsconfig.json +3 -0
  145. package/types/preview/@ember/error/index.d.ts +6 -0
  146. package/types/preview/@ember/error/tsconfig.json +3 -0
  147. package/types/preview/@ember/helper/index.d.ts +49 -0
  148. package/types/preview/@ember/helper/tsconfig.json +3 -0
  149. package/types/preview/@ember/modifier/index.d.ts +33 -0
  150. package/types/preview/@ember/modifier/tsconfig.json +3 -0
  151. package/types/preview/@ember/object/-private/action-handler.d.ts +31 -0
  152. package/types/preview/@ember/object/-private/types.d.ts +63 -0
  153. package/types/preview/@ember/object/compat.d.ts +9 -0
  154. package/types/preview/@ember/object/computed.d.ts +263 -0
  155. package/types/preview/@ember/object/core.d.ts +89 -0
  156. package/types/preview/@ember/object/evented.d.ts +45 -0
  157. package/types/preview/@ember/object/events.d.ts +47 -0
  158. package/types/preview/@ember/object/index.d.ts +126 -0
  159. package/types/preview/@ember/object/internals.d.ts +17 -0
  160. package/types/preview/@ember/object/mixin.d.ts +19 -0
  161. package/types/preview/@ember/object/observable.d.ts +89 -0
  162. package/types/preview/@ember/object/observers.d.ts +34 -0
  163. package/types/preview/@ember/object/promise-proxy-mixin.d.ts +37 -0
  164. package/types/preview/@ember/object/proxy.d.ts +27 -0
  165. package/types/preview/@ember/object/tsconfig.json +3 -0
  166. package/types/preview/@ember/owner/index.d.ts +102 -0
  167. package/types/preview/@ember/owner/tsconfig.json +3 -0
  168. package/types/preview/@ember/polyfills/index.d.ts +23 -0
  169. package/types/preview/@ember/polyfills/tsconfig.json +3 -0
  170. package/types/preview/@ember/polyfills/types.d.ts +6 -0
  171. package/types/preview/@ember/routing/-private/router-dsl.d.ts +20 -0
  172. package/types/preview/@ember/routing/auto-location.d.ts +8 -0
  173. package/types/preview/@ember/routing/hash-location.d.ts +10 -0
  174. package/types/preview/@ember/routing/history-location.d.ts +9 -0
  175. package/types/preview/@ember/routing/index.d.ts +20 -0
  176. package/types/preview/@ember/routing/none-location.d.ts +11 -0
  177. package/types/preview/@ember/routing/route-info.d.ts +74 -0
  178. package/types/preview/@ember/routing/route.d.ts +533 -0
  179. package/types/preview/@ember/routing/router-service.d.ts +351 -0
  180. package/types/preview/@ember/routing/router.d.ts +49 -0
  181. package/types/preview/@ember/routing/transition.d.ts +126 -0
  182. package/types/preview/@ember/routing/tsconfig.json +3 -0
  183. package/types/preview/@ember/routing/types.d.ts +15 -0
  184. package/types/preview/@ember/runloop/-private/backburner.d.ts +43 -0
  185. package/types/preview/@ember/runloop/-private/types.d.ts +9 -0
  186. package/types/preview/@ember/runloop/index.d.ts +175 -0
  187. package/types/preview/@ember/runloop/tsconfig.json +3 -0
  188. package/types/preview/@ember/runloop/types.d.ts +5 -0
  189. package/types/preview/@ember/service/index.d.ts +25 -0
  190. package/types/preview/@ember/service/tsconfig.json +3 -0
  191. package/types/preview/@ember/string/index.d.ts +9 -0
  192. package/types/preview/@ember/string/tsconfig.json +3 -0
  193. package/types/preview/@ember/template/-private/handlebars.d.ts +7 -0
  194. package/types/preview/@ember/template/index.d.ts +5 -0
  195. package/types/preview/@ember/template/tsconfig.json +3 -0
  196. package/types/preview/@ember/test/adapter.d.ts +22 -0
  197. package/types/preview/@ember/test/index.d.ts +49 -0
  198. package/types/preview/@ember/test/tsconfig.json +3 -0
  199. package/types/preview/@ember/utils/-private/types.d.ts +39 -0
  200. package/types/preview/@ember/utils/index.d.ts +42 -0
  201. package/types/preview/@ember/utils/tsconfig.json +3 -0
  202. package/types/preview/ember/-private/type-utils.d.ts +54 -0
  203. package/types/preview/ember/index.d.ts +381 -0
  204. package/types/preview/ember/tsconfig.json +3 -0
  205. package/types/preview/index.d.ts +120 -0
  206. package/types/preview/tsconfig.json +6 -0
  207. package/blueprints/helper/mu-files/__root__/__collection__/__name__.js +0 -7
  208. package/blueprints-js/helper/mu-files/__root__/__collection__/__name__.js +0 -7
  209. package/dist/packages/@ember/-internals/extension-support/index.js +0 -2
  210. package/dist/packages/@ember/-internals/extension-support/lib/container_debug_adapter.js +0 -96
  211. package/dist/packages/@ember/-internals/extension-support/lib/data_adapter.js +0 -576
  212. package/dist/packages/@ember/-internals/routing/lib/ext/controller.js +0 -224
  213. package/dist/packages/@ember/-internals/routing/lib/location/api.js +0 -104
  214. package/dist/packages/@ember/-internals/routing/lib/location/auto_location.js +0 -250
  215. package/dist/packages/@ember/-internals/routing/lib/location/hash_location.js +0 -170
  216. package/dist/packages/@ember/-internals/routing/lib/location/history_location.js +0 -290
  217. package/dist/packages/@ember/-internals/routing/lib/location/none_location.js +0 -124
  218. package/dist/packages/@ember/-internals/routing/lib/services/router.js +0 -506
  219. package/dist/packages/@ember/-internals/routing/lib/system/route.js +0 -1696
  220. package/dist/packages/@ember/-internals/routing/lib/system/router.js +0 -1662
  221. package/dist/packages/@ember/-internals/runtime/lib/mixins/array.js +0 -1501
  222. package/dist/packages/@ember/-internals/runtime/lib/mixins/enumerable.js +0 -3
  223. package/dist/packages/@ember/-internals/runtime/lib/mixins/evented.js +0 -91
  224. package/dist/packages/@ember/-internals/runtime/lib/mixins/mutable_enumerable.js +0 -4
  225. package/dist/packages/@ember/-internals/runtime/lib/mixins/observable.js +0 -339
  226. package/dist/packages/@ember/-internals/runtime/lib/mixins/promise_proxy.js +0 -149
  227. package/dist/packages/@ember/-internals/runtime/lib/system/array_proxy.js +0 -305
  228. package/dist/packages/@ember/-internals/runtime/lib/system/core_object.js +0 -730
  229. package/dist/packages/@ember/-internals/runtime/lib/system/namespace.js +0 -69
  230. package/dist/packages/@ember/-internals/runtime/lib/system/object_proxy.js +0 -7
  231. package/dist/packages/@ember/application/lib/application.js +0 -870
  232. package/dist/packages/@ember/controller/lib/controller_mixin.js +0 -42
  233. package/dist/packages/@ember/runloop/type-tests.ts/begin-end.test.js +0 -5
  234. package/dist/packages/@ember/runloop/type-tests.ts/bind.test.js +0 -59
  235. package/dist/packages/@ember/runloop/type-tests.ts/cancel.test.js +0 -5
  236. package/dist/packages/@ember/runloop/type-tests.ts/debounce.test.js +0 -77
  237. package/dist/packages/@ember/runloop/type-tests.ts/join.test.js +0 -38
  238. package/dist/packages/@ember/runloop/type-tests.ts/later.test.js +0 -38
  239. package/dist/packages/@ember/runloop/type-tests.ts/next.test.js +0 -38
  240. package/dist/packages/@ember/runloop/type-tests.ts/once.test.js +0 -38
  241. package/dist/packages/@ember/runloop/type-tests.ts/run.test.js +0 -38
  242. package/dist/packages/@ember/runloop/type-tests.ts/schedule-once.test.js +0 -39
  243. package/dist/packages/@ember/runloop/type-tests.ts/schedule.test.js +0 -39
  244. package/dist/packages/@ember/runloop/type-tests.ts/throttle.test.js +0 -77
@@ -1,1662 +0,0 @@
1
- import { privatize as P } from '@ember/-internals/container';
2
- import { computed, get, set } from '@ember/-internals/metal';
3
- import { getOwner } from '@ember/-internals/owner';
4
- import { BucketCache } from '@ember/-internals/routing';
5
- import { A as emberA, Evented, Object as EmberObject, typeOf } from '@ember/-internals/runtime';
6
- import { assert, deprecate, info } from '@ember/debug';
7
- import EmberError from '@ember/error';
8
- import { cancel, once, run, scheduleOnce } from '@ember/runloop';
9
- import { DEBUG } from '@glimmer/env';
10
- import EmberLocation from '../location/api';
11
- import { calculateCacheKey, extractRouteArgs, getActiveTargetName, resemblesURL } from '../utils';
12
- import DSL from './dsl';
13
- import { defaultSerialize, getFullQueryParams, hasDefaultSerialize, ROUTE_CONNECTIONS } from './route';
14
- import RouterState from './router_state';
15
- import Router, { logAbort, STATE_SYMBOL } from 'router_js';
16
- import EngineInstance from '@ember/engine/instance';
17
-
18
- function defaultDidTransition(infos) {
19
- updatePaths(this);
20
-
21
- this._cancelSlowTransitionTimer();
22
-
23
- this.notifyPropertyChange('url');
24
- this.set('currentState', this.targetState);
25
-
26
- if (DEBUG) {
27
- // @ts-expect-error namespace isn't public
28
- if (this.namespace.LOG_TRANSITIONS) {
29
- // eslint-disable-next-line no-console
30
- console.log(`Transitioned into '${EmberRouter._routePath(infos)}'`);
31
- }
32
- }
33
- }
34
-
35
- function defaultWillTransition(oldInfos, newInfos) {
36
- if (DEBUG) {
37
- // @ts-expect-error namespace isn't public
38
- if (this.namespace.LOG_TRANSITIONS) {
39
- // eslint-disable-next-line no-console
40
- console.log(`Preparing to transition from '${EmberRouter._routePath(oldInfos)}' to '${EmberRouter._routePath(newInfos)}'`);
41
- }
42
- }
43
- }
44
-
45
- let freezeRouteInfo;
46
-
47
- if (DEBUG) {
48
- freezeRouteInfo = transition => {
49
- if (transition.from !== null && !Object.isFrozen(transition.from)) {
50
- Object.freeze(transition.from);
51
- }
52
-
53
- if (transition.to !== null && !Object.isFrozen(transition.to)) {
54
- Object.freeze(transition.to);
55
- }
56
- };
57
- }
58
-
59
- function K() {
60
- return this;
61
- }
62
-
63
- const {
64
- slice
65
- } = Array.prototype;
66
- /**
67
- The `EmberRouter` class manages the application state and URLs. Refer to
68
- the [routing guide](https://guides.emberjs.com/release/routing/) for documentation.
69
-
70
- @class EmberRouter
71
- @extends EmberObject
72
- @uses Evented
73
- @public
74
- */
75
-
76
- class EmberRouter extends EmberObject.extend(Evented) {
77
- // Note that owner is actually required in this scenario, but since it is strictly
78
- // optional in other contexts trying to make it required here confuses TS.
79
- constructor(owner) {
80
- super(owner);
81
- this._didSetupRouter = false;
82
- this._initialTransitionStarted = false;
83
- this.currentURL = null;
84
- this.currentRouteName = null;
85
- this.currentPath = null;
86
- this.currentRoute = null;
87
- this._qpCache = Object.create(null); // Set of QueryParam['urlKey']
88
-
89
- this._qpUpdates = new Set();
90
- this._queuedQPChanges = {};
91
- this._toplevelView = null;
92
- this._handledErrors = new Set();
93
- this._engineInstances = Object.create(null);
94
- this._engineInfoByRoute = Object.create(null);
95
- this._slowTransitionTimer = null;
96
- this.currentState = null;
97
- this.targetState = null;
98
- assert('BUG: Missing owner', owner);
99
-
100
- this._resetQueuedQueryParameterChanges();
101
-
102
- this.namespace = owner.lookup('application:main');
103
- let bucketCache = owner.lookup(P`-bucket-cache:main`);
104
- assert('BUG: BucketCache should always be present', bucketCache instanceof BucketCache);
105
- this._bucketCache = bucketCache;
106
- let routerService = owner.lookup('service:router');
107
- assert('BUG: RouterService should always be present', routerService !== undefined);
108
- this._routerService = routerService;
109
- }
110
- /**
111
- The `Router.map` function allows you to define mappings from URLs to routes
112
- in your application. These mappings are defined within the
113
- supplied callback function using `this.route`.
114
- The first parameter is the name of the route which is used by default as the
115
- path name as well.
116
- The second parameter is the optional options hash. Available options are:
117
- * `path`: allows you to provide your own path as well as mark dynamic
118
- segments.
119
- * `resetNamespace`: false by default; when nesting routes, ember will
120
- combine the route names to form the fully-qualified route name, which is
121
- used with `{{link-to}}` or manually transitioning to routes. Setting
122
- `resetNamespace: true` will cause the route not to inherit from its
123
- parent route's names. This is handy for preventing extremely long route names.
124
- Keep in mind that the actual URL path behavior is still retained.
125
- The third parameter is a function, which can be used to nest routes.
126
- Nested routes, by default, will have the parent route tree's route name and
127
- path prepended to it's own.
128
- ```app/router.js
129
- Router.map(function(){
130
- this.route('post', { path: '/post/:post_id' }, function() {
131
- this.route('edit');
132
- this.route('comments', { resetNamespace: true }, function() {
133
- this.route('new');
134
- });
135
- });
136
- });
137
- ```
138
- @method map
139
- @param callback
140
- @public
141
- */
142
-
143
-
144
- static map(callback) {
145
- if (!this.dslCallbacks) {
146
- this.dslCallbacks = []; // FIXME: Can we remove this?
147
-
148
- this.reopenClass({
149
- dslCallbacks: this.dslCallbacks
150
- });
151
- }
152
-
153
- this.dslCallbacks.push(callback);
154
- return this;
155
- }
156
-
157
- static _routePath(routeInfos) {
158
- let path = []; // We have to handle coalescing resource names that
159
- // are prefixed with their parent's names, e.g.
160
- // ['foo', 'foo.bar.baz'] => 'foo.bar.baz', not 'foo.foo.bar.baz'
161
-
162
- function intersectionMatches(a1, a2) {
163
- for (let i = 0; i < a1.length; ++i) {
164
- if (a1[i] !== a2[i]) {
165
- return false;
166
- }
167
- }
168
-
169
- return true;
170
- }
171
-
172
- let name, nameParts, oldNameParts;
173
-
174
- for (let i = 1; i < routeInfos.length; i++) {
175
- let routeInfo = routeInfos[i];
176
- assert('has routeInfo', routeInfo);
177
- name = routeInfo.name;
178
- nameParts = name.split('.');
179
- oldNameParts = slice.call(path);
180
-
181
- while (oldNameParts.length) {
182
- if (intersectionMatches(oldNameParts, nameParts)) {
183
- break;
184
- }
185
-
186
- oldNameParts.shift();
187
- }
188
-
189
- path.push(...nameParts.slice(oldNameParts.length));
190
- }
191
-
192
- return path.join('.');
193
- }
194
-
195
- _initRouterJs() {
196
- let location = get(this, 'location');
197
- let router = this;
198
- const owner = getOwner(this);
199
- assert('Router is unexpectedly missing an owner', owner);
200
- let seen = Object.create(null);
201
-
202
- class PrivateRouter extends Router {
203
- getRoute(name) {
204
- let routeName = name;
205
- let routeOwner = owner;
206
- let engineInfo = router._engineInfoByRoute[routeName];
207
-
208
- if (engineInfo) {
209
- let engineInstance = router._getEngineInstance(engineInfo);
210
-
211
- routeOwner = engineInstance;
212
- routeName = engineInfo.localFullName;
213
- }
214
-
215
- let fullRouteName = `route:${routeName}`;
216
- assert('Route is unexpectedly missing an owner', routeOwner);
217
- let route = routeOwner.lookup(fullRouteName);
218
-
219
- if (seen[name]) {
220
- assert('seen routes should exist', route);
221
- return route;
222
- }
223
-
224
- seen[name] = true;
225
-
226
- if (!route) {
227
- // SAFETY: this is configured in `commonSetupRegistry` in the
228
- // `@ember/application/lib` package.
229
- let DefaultRoute = routeOwner.factoryFor('route:basic').class;
230
- routeOwner.register(fullRouteName, DefaultRoute.extend());
231
- route = routeOwner.lookup(fullRouteName);
232
-
233
- if (DEBUG) {
234
- if (router.namespace.LOG_ACTIVE_GENERATION) {
235
- info(`generated -> ${fullRouteName}`, {
236
- fullName: fullRouteName
237
- });
238
- }
239
- }
240
- }
241
-
242
- route._setRouteName(routeName);
243
-
244
- if (engineInfo && !hasDefaultSerialize(route)) {
245
- throw new Error('Defining a custom serialize method on an Engine route is not supported.');
246
- }
247
-
248
- return route;
249
- }
250
-
251
- getSerializer(name) {
252
- let engineInfo = router._engineInfoByRoute[name]; // If this is not an Engine route, we fall back to the handler for serialization
253
-
254
- if (!engineInfo) {
255
- return;
256
- }
257
-
258
- return engineInfo.serializeMethod || defaultSerialize;
259
- }
260
-
261
- updateURL(path) {
262
- once(() => {
263
- location.setURL(path);
264
- set(router, 'currentURL', path);
265
- });
266
- } // TODO: merge into routeDidChange
267
-
268
-
269
- didTransition(infos) {
270
- assert('You attempted to override the "didTransition" method which has been deprecated. Please inject the router service and listen to the "routeDidChange" event.', router.didTransition === defaultDidTransition);
271
- router.didTransition(infos);
272
- } // TODO: merge into routeWillChange
273
-
274
-
275
- willTransition(oldInfos, newInfos) {
276
- assert('You attempted to override the "willTransition" method which has been deprecated. Please inject the router service and listen to the "routeWillChange" event.', router.willTransition === defaultWillTransition);
277
- router.willTransition(oldInfos, newInfos);
278
- }
279
-
280
- triggerEvent(routeInfos, ignoreFailure, name, args) {
281
- return triggerEvent.bind(router)(routeInfos, ignoreFailure, name, args);
282
- }
283
-
284
- routeWillChange(transition) {
285
- router.trigger('routeWillChange', transition);
286
-
287
- if (DEBUG) {
288
- freezeRouteInfo(transition);
289
- }
290
-
291
- router._routerService.trigger('routeWillChange', transition); // in case of intermediate transition we update the current route
292
- // to make router.currentRoute.name consistent with router.currentRouteName
293
- // see https://github.com/emberjs/ember.js/issues/19449
294
-
295
-
296
- if (transition.isIntermediate) {
297
- router.set('currentRoute', transition.to);
298
- }
299
- }
300
-
301
- routeDidChange(transition) {
302
- router.set('currentRoute', transition.to);
303
- once(() => {
304
- router.trigger('routeDidChange', transition);
305
-
306
- if (DEBUG) {
307
- freezeRouteInfo(transition);
308
- }
309
-
310
- router._routerService.trigger('routeDidChange', transition);
311
- });
312
- }
313
-
314
- transitionDidError(error, transition) {
315
- if (error.wasAborted || transition.isAborted) {
316
- // If the error was a transition erorr or the transition aborted
317
- // log the abort.
318
- return logAbort(transition);
319
- } else {
320
- // Otherwise trigger the "error" event to attempt an intermediate
321
- // transition into an error substate
322
- transition.trigger(false, 'error', error.error, transition, error.route);
323
-
324
- if (router._isErrorHandled(error.error)) {
325
- // If we handled the error with a substate just roll the state back on
326
- // the transition and send the "routeDidChange" event for landing on
327
- // the error substate and return the error.
328
- transition.rollback();
329
- this.routeDidChange(transition);
330
- return error.error;
331
- } else {
332
- // If it was not handled, abort the transition completely and return
333
- // the error.
334
- transition.abort();
335
- return error.error;
336
- }
337
- }
338
- }
339
-
340
- replaceURL(url) {
341
- if (location.replaceURL) {
342
- let doReplaceURL = () => {
343
- location.replaceURL(url);
344
- set(router, 'currentURL', url);
345
- };
346
-
347
- once(doReplaceURL);
348
- } else {
349
- this.updateURL(url);
350
- }
351
- }
352
-
353
- }
354
-
355
- let routerMicrolib = this._routerMicrolib = new PrivateRouter();
356
- let dslCallbacks = this.constructor.dslCallbacks || [K];
357
-
358
- let dsl = this._buildDSL();
359
-
360
- dsl.route('application', {
361
- path: '/',
362
- resetNamespace: true,
363
- overrideNameAssertion: true
364
- }, function () {
365
- for (let i = 0; i < dslCallbacks.length; i++) {
366
- dslCallbacks[i].call(this);
367
- }
368
- });
369
-
370
- if (DEBUG) {
371
- if (this.namespace.LOG_TRANSITIONS_INTERNAL) {
372
- routerMicrolib.log = console.log.bind(console); // eslint-disable-line no-console
373
- }
374
- }
375
-
376
- routerMicrolib.map(dsl.generate());
377
- }
378
-
379
- _buildDSL() {
380
- let enableLoadingSubstates = this._hasModuleBasedResolver();
381
-
382
- let router = this;
383
- const owner = getOwner(this);
384
- assert('Router is unexpectedly missing an owner', owner);
385
- let options = {
386
- enableLoadingSubstates,
387
-
388
- resolveRouteMap(name) {
389
- return owner.factoryFor(`route-map:${name}`);
390
- },
391
-
392
- addRouteForEngine(name, engineInfo) {
393
- if (!router._engineInfoByRoute[name]) {
394
- router._engineInfoByRoute[name] = engineInfo;
395
- }
396
- }
397
-
398
- };
399
- return new DSL(null, options);
400
- }
401
- /*
402
- Resets all pending query parameter changes.
403
- Called after transitioning to a new route
404
- based on query parameter changes.
405
- */
406
-
407
-
408
- _resetQueuedQueryParameterChanges() {
409
- this._queuedQPChanges = {};
410
- }
411
-
412
- _hasModuleBasedResolver() {
413
- let owner = getOwner(this);
414
- assert('Router is unexpectedly missing an owner', owner);
415
- let resolver = get(owner, 'application.__registry__.resolver.moduleBasedResolver');
416
- return Boolean(resolver);
417
- }
418
- /**
419
- Initializes the current router instance and sets up the change handling
420
- event listeners used by the instances `location` implementation.
421
- A property named `initialURL` will be used to determine the initial URL.
422
- If no value is found `/` will be used.
423
- @method startRouting
424
- @private
425
- */
426
-
427
-
428
- startRouting() {
429
- if (this.setupRouter()) {
430
- let initialURL = get(this, 'initialURL');
431
-
432
- if (initialURL === undefined) {
433
- initialURL = get(this, 'location').getURL();
434
- }
435
-
436
- let initialTransition = this.handleURL(initialURL);
437
-
438
- if (initialTransition && initialTransition.error) {
439
- throw initialTransition.error;
440
- }
441
- }
442
- }
443
-
444
- setupRouter() {
445
- if (this._didSetupRouter) {
446
- return false;
447
- }
448
-
449
- this._didSetupRouter = true;
450
-
451
- this._setupLocation();
452
-
453
- let location = get(this, 'location'); // Allow the Location class to cancel the router setup while it refreshes
454
- // the page
455
-
456
- if (get(location, 'cancelRouterSetup')) {
457
- return false;
458
- }
459
-
460
- this._initRouterJs();
461
-
462
- location.onUpdateURL(url => {
463
- this.handleURL(url);
464
- });
465
- return true;
466
- }
467
-
468
- _setOutlets() {
469
- // This is triggered async during Route#willDestroy.
470
- // If the router is also being destroyed we do not want to
471
- // to create another this._toplevelView (and leak the renderer)
472
- if (this.isDestroying || this.isDestroyed) {
473
- return;
474
- }
475
-
476
- let routeInfos = this._routerMicrolib.currentRouteInfos;
477
-
478
- if (!routeInfos) {
479
- return;
480
- }
481
-
482
- let defaultParentState;
483
- let liveRoutes = null;
484
-
485
- for (let routeInfo of routeInfos) {
486
- let route = routeInfo.route;
487
- let connections = ROUTE_CONNECTIONS.get(route);
488
- let ownState;
489
-
490
- if (connections.length === 0) {
491
- ownState = representEmptyRoute(liveRoutes, defaultParentState, route);
492
- } else {
493
- for (let j = 0; j < connections.length; j++) {
494
- let appended = appendLiveRoute(liveRoutes, defaultParentState, connections[j]);
495
- liveRoutes = appended.liveRoutes;
496
- let {
497
- name,
498
- outlet
499
- } = appended.ownState.render;
500
-
501
- if (name === route.routeName || outlet === 'main') {
502
- ownState = appended.ownState;
503
- }
504
- }
505
- }
506
-
507
- defaultParentState = ownState;
508
- } // when a transitionTo happens after the validation phase
509
- // during the initial transition _setOutlets is called
510
- // when no routes are active. However, it will get called
511
- // again with the correct values during the next turn of
512
- // the runloop
513
-
514
-
515
- if (!liveRoutes) {
516
- return;
517
- }
518
-
519
- if (!this._toplevelView) {
520
- let owner = getOwner(this);
521
- assert('Router is unexpectedly missing an owner', owner);
522
- let OutletView = owner.factoryFor('view:-outlet');
523
- let application = owner.lookup('application:main');
524
- let environment = owner.lookup('-environment:main');
525
- let template = owner.lookup('template:-outlet');
526
- this._toplevelView = OutletView.create({
527
- environment,
528
- template,
529
- application
530
- });
531
-
532
- this._toplevelView.setOutletState(liveRoutes);
533
-
534
- let instance = owner.lookup('-application-instance:main');
535
-
536
- if (instance) {
537
- instance.didCreateRootView(this._toplevelView);
538
- }
539
- } else {
540
- this._toplevelView.setOutletState(liveRoutes);
541
- }
542
- }
543
-
544
- handleURL(url) {
545
- // Until we have an ember-idiomatic way of accessing #hashes, we need to
546
- // remove it because router.js doesn't know how to handle it.
547
- let _url = url.split(/#(.+)?/)[0];
548
- return this._doURLTransition('handleURL', _url);
549
- }
550
-
551
- _doURLTransition(routerJsMethod, url) {
552
- this._initialTransitionStarted = true;
553
-
554
- let transition = this._routerMicrolib[routerJsMethod](url || '/');
555
-
556
- didBeginTransition(transition, this);
557
- return transition;
558
- }
559
- /**
560
- Transition the application into another route. The route may
561
- be either a single route or route path:
562
- @method transitionTo
563
- @param {String} [name] the name of the route or a URL
564
- @param {...Object} models the model(s) or identifier(s) to be used while
565
- transitioning to the route.
566
- @param {Object} [options] optional hash with a queryParams property
567
- containing a mapping of query parameters
568
- @return {Transition} the transition object associated with this
569
- attempted transition
570
- @public
571
- */
572
-
573
-
574
- transitionTo(...args) {
575
- if (resemblesURL(args[0])) {
576
- assert(`A transition was attempted from '${this.currentRouteName}' to '${args[0]}' but the application instance has already been destroyed.`, !this.isDestroying && !this.isDestroyed);
577
- return this._doURLTransition('transitionTo', args[0]);
578
- }
579
-
580
- let {
581
- routeName,
582
- models,
583
- queryParams
584
- } = extractRouteArgs(args);
585
- assert(`A transition was attempted from '${this.currentRouteName}' to '${routeName}' but the application instance has already been destroyed.`, !this.isDestroying && !this.isDestroyed);
586
- return this._doTransition(routeName, models, queryParams);
587
- }
588
-
589
- intermediateTransitionTo(name, ...args) {
590
- this._routerMicrolib.intermediateTransitionTo(name, ...args);
591
-
592
- updatePaths(this);
593
-
594
- if (DEBUG) {
595
- let infos = this._routerMicrolib.currentRouteInfos;
596
-
597
- if (this.namespace.LOG_TRANSITIONS) {
598
- assert('expected infos to be set', infos); // eslint-disable-next-line no-console
599
-
600
- console.log(`Intermediate-transitioned into '${EmberRouter._routePath(infos)}'`);
601
- }
602
- }
603
- }
604
- /**
605
- Similar to `transitionTo`, but instead of adding the destination to the browser's URL history,
606
- it replaces the entry for the current route.
607
- When the user clicks the "back" button in the browser, there will be fewer steps.
608
- This is most commonly used to manage redirects in a way that does not cause confusing additions
609
- to the user's browsing history.
610
- @method replaceWith
611
- @param {String} [name] the name of the route or a URL
612
- @param {...Object} models the model(s) or identifier(s) to be used while
613
- transitioning to the route.
614
- @param {Object} [options] optional hash with a queryParams property
615
- containing a mapping of query parameters
616
- @return {Transition} the transition object associated with this
617
- attempted transition
618
- @public
619
- */
620
-
621
-
622
- replaceWith(...args) {
623
- return this.transitionTo(...args).method('replace');
624
- }
625
-
626
- generate(name, ...args) {
627
- let url = this._routerMicrolib.generate(name, ...args);
628
-
629
- assert('expected non-string location', typeof this.location !== 'string');
630
- return this.location.formatURL(url);
631
- }
632
- /**
633
- Determines if the supplied route is currently active.
634
- @method isActive
635
- @param routeName
636
- @return {Boolean}
637
- @private
638
- */
639
-
640
-
641
- isActive(routeName) {
642
- return this._routerMicrolib.isActive(routeName);
643
- }
644
- /**
645
- An alternative form of `isActive` that doesn't require
646
- manual concatenation of the arguments into a single
647
- array.
648
- @method isActiveIntent
649
- @param routeName
650
- @param models
651
- @param queryParams
652
- @return {Boolean}
653
- @private
654
- @since 1.7.0
655
- */
656
-
657
-
658
- isActiveIntent(routeName, models, queryParams) {
659
- return this.currentState.isActiveIntent(routeName, models, queryParams);
660
- }
661
-
662
- send(name, ...args) {
663
- /*name, context*/
664
- this._routerMicrolib.trigger(name, ...args);
665
- }
666
- /**
667
- Does this router instance have the given route.
668
- @method hasRoute
669
- @return {Boolean}
670
- @private
671
- */
672
-
673
-
674
- hasRoute(route) {
675
- return this._routerMicrolib.hasRoute(route);
676
- }
677
- /**
678
- Resets the state of the router by clearing the current route
679
- handlers and deactivating them.
680
- @private
681
- @method reset
682
- */
683
-
684
-
685
- reset() {
686
- this._didSetupRouter = false;
687
- this._initialTransitionStarted = false;
688
-
689
- if (this._routerMicrolib) {
690
- this._routerMicrolib.reset();
691
- }
692
- }
693
-
694
- willDestroy() {
695
- if (this._toplevelView) {
696
- this._toplevelView.destroy();
697
-
698
- this._toplevelView = null;
699
- }
700
-
701
- super.willDestroy();
702
- this.reset();
703
- let instances = this._engineInstances;
704
-
705
- for (let name in instances) {
706
- let instanceMap = instances[name];
707
- assert('has instanceMap', instanceMap);
708
-
709
- for (let id in instanceMap) {
710
- let instance = instanceMap[id];
711
- assert('has instance', instance);
712
- run(instance, 'destroy');
713
- }
714
- }
715
- }
716
- /*
717
- Called when an active route's query parameter has changed.
718
- These changes are batched into a runloop run and trigger
719
- a single transition.
720
- */
721
-
722
-
723
- _activeQPChanged(queryParameterName, newValue) {
724
- this._queuedQPChanges[queryParameterName] = newValue;
725
- once(this, this._fireQueryParamTransition);
726
- } // The queryParameterName is QueryParam['urlKey']
727
-
728
-
729
- _updatingQPChanged(queryParameterName) {
730
- this._qpUpdates.add(queryParameterName);
731
- }
732
- /*
733
- Triggers a transition to a route based on query parameter changes.
734
- This is called once per runloop, to batch changes.
735
- e.g.
736
- if these methods are called in succession:
737
- this._activeQPChanged('foo', '10');
738
- // results in _queuedQPChanges = { foo: '10' }
739
- this._activeQPChanged('bar', false);
740
- // results in _queuedQPChanges = { foo: '10', bar: false }
741
- _queuedQPChanges will represent both of these changes
742
- and the transition using `transitionTo` will be triggered
743
- once.
744
- */
745
-
746
-
747
- _fireQueryParamTransition() {
748
- this.transitionTo({
749
- queryParams: this._queuedQPChanges
750
- });
751
-
752
- this._resetQueuedQueryParameterChanges();
753
- }
754
-
755
- _setupLocation() {
756
- let location = this.location;
757
- let rootURL = this.rootURL;
758
- let owner = getOwner(this);
759
- assert('Router is unexpectedly missing an owner', owner);
760
-
761
- if ('string' === typeof location) {
762
- let resolvedLocation = owner.lookup(`location:${location}`);
763
-
764
- if (location === 'auto') {
765
- deprecate("Router location 'auto' is deprecated. Most users will want to set `locationType` to 'history' in config/environment.js for no change in behavior. See deprecation docs for details.", false, {
766
- id: 'deprecate-auto-location',
767
- until: '5.0.0',
768
- url: 'https://emberjs.com/deprecations/v4.x#toc_deprecate-auto-location',
769
- for: 'ember-source',
770
- since: {
771
- available: '4.1.0',
772
- enabled: '4.1.0'
773
- }
774
- });
775
- }
776
-
777
- if (resolvedLocation !== undefined) {
778
- location = set(this, 'location', resolvedLocation);
779
- } else {
780
- // Allow for deprecated registration of custom location API's
781
- let options = {
782
- implementation: location
783
- };
784
- location = set(this, 'location', EmberLocation.create(options));
785
- }
786
- }
787
-
788
- if (location !== null && typeof location === 'object') {
789
- if (rootURL) {
790
- set(location, 'rootURL', rootURL);
791
- } // Allow the location to do any feature detection, such as AutoLocation
792
- // detecting history support. This gives it a chance to set its
793
- // `cancelRouterSetup` property which aborts routing.
794
-
795
-
796
- if (typeof location.detect === 'function') {
797
- if (this.location !== 'auto') {
798
- deprecate('The `detect` method on the Location object is deprecated. If you need detection you can run your detection code in app.js, before setting the location type.', false, {
799
- id: 'deprecate-auto-location',
800
- until: '5.0.0',
801
- url: 'https://emberjs.com/deprecations/v4.x#toc_deprecate-auto-location',
802
- for: 'ember-source',
803
- since: {
804
- available: '4.1.0',
805
- enabled: '4.1.0'
806
- }
807
- });
808
- }
809
-
810
- location.detect();
811
- } // ensure that initState is called AFTER the rootURL is set on
812
- // the location instance
813
-
814
-
815
- if (typeof location.initState === 'function') {
816
- location.initState();
817
- }
818
- }
819
- }
820
- /**
821
- Serializes the given query params according to their QP meta information.
822
- @private
823
- @method _serializeQueryParams
824
- @param {Arrray<RouteInfo>} routeInfos
825
- @param {Object} queryParams
826
- @return {Void}
827
- */
828
-
829
-
830
- _serializeQueryParams(routeInfos, queryParams) {
831
- forEachQueryParam(this, routeInfos, queryParams, (key, value, qp) => {
832
- if (qp) {
833
- delete queryParams[key];
834
- queryParams[qp.urlKey] = qp.route.serializeQueryParam(value, qp.urlKey, qp.type);
835
- } else if (value === undefined) {
836
- return; // We don't serialize undefined values
837
- } else {
838
- queryParams[key] = this._serializeQueryParam(value, typeOf(value));
839
- }
840
- });
841
- }
842
- /**
843
- Serializes the value of a query parameter based on a type
844
- @private
845
- @method _serializeQueryParam
846
- @param {Object} value
847
- @param {String} type
848
- */
849
-
850
-
851
- _serializeQueryParam(value, type) {
852
- if (value === null || value === undefined) {
853
- return value;
854
- } else if (type === 'array') {
855
- return JSON.stringify(value);
856
- }
857
-
858
- return `${value}`;
859
- }
860
- /**
861
- Deserializes the given query params according to their QP meta information.
862
- @private
863
- @method _deserializeQueryParams
864
- @param {Array<RouteInfo>} routeInfos
865
- @param {Object} queryParams
866
- @return {Void}
867
- */
868
-
869
-
870
- _deserializeQueryParams(routeInfos, queryParams) {
871
- forEachQueryParam(this, routeInfos, queryParams, (key, value, qp) => {
872
- // If we don't have QP meta info for a given key, then we do nothing
873
- // because all values will be treated as strings
874
- if (qp) {
875
- delete queryParams[key];
876
- queryParams[qp.prop] = qp.route.deserializeQueryParam(value, qp.urlKey, qp.type);
877
- }
878
- });
879
- }
880
- /**
881
- Deserializes the value of a query parameter based on a default type
882
- @private
883
- @method _deserializeQueryParam
884
- @param {Object} value
885
- @param {String} defaultType
886
- */
887
-
888
-
889
- _deserializeQueryParam(value, defaultType) {
890
- if (value === null || value === undefined) {
891
- return value;
892
- } else if (defaultType === 'boolean') {
893
- return value === 'true';
894
- } else if (defaultType === 'number') {
895
- return Number(value).valueOf();
896
- } else if (defaultType === 'array') {
897
- return emberA(JSON.parse(value));
898
- }
899
-
900
- return value;
901
- }
902
- /**
903
- Removes (prunes) any query params with default values from the given QP
904
- object. Default values are determined from the QP meta information per key.
905
- @private
906
- @method _pruneDefaultQueryParamValues
907
- @param {Array<RouteInfo>} routeInfos
908
- @param {Object} queryParams
909
- @return {Void}
910
- */
911
-
912
-
913
- _pruneDefaultQueryParamValues(routeInfos, queryParams) {
914
- let qps = this._queryParamsFor(routeInfos);
915
-
916
- for (let key in queryParams) {
917
- let qp = qps.map[key];
918
-
919
- if (qp && qp.serializedDefaultValue === queryParams[key]) {
920
- delete queryParams[key];
921
- }
922
- }
923
- }
924
-
925
- _doTransition(_targetRouteName, models, _queryParams, _fromRouterService) {
926
- let targetRouteName = _targetRouteName || getActiveTargetName(this._routerMicrolib);
927
-
928
- assert(`The route ${targetRouteName} was not found`, Boolean(targetRouteName) && this._routerMicrolib.hasRoute(targetRouteName));
929
- this._initialTransitionStarted = true;
930
- let queryParams = {};
931
-
932
- this._processActiveTransitionQueryParams(targetRouteName, models, queryParams, _queryParams);
933
-
934
- Object.assign(queryParams, _queryParams);
935
-
936
- this._prepareQueryParams(targetRouteName, models, queryParams, Boolean(_fromRouterService));
937
-
938
- let transition = this._routerMicrolib.transitionTo(targetRouteName, ...models, {
939
- queryParams
940
- });
941
-
942
- didBeginTransition(transition, this);
943
- return transition;
944
- }
945
-
946
- _processActiveTransitionQueryParams(targetRouteName, models, queryParams, _queryParams) {
947
- // merge in any queryParams from the active transition which could include
948
- // queryParams from the url on initial load.
949
- if (!this._routerMicrolib.activeTransition) {
950
- return;
951
- }
952
-
953
- let unchangedQPs = {};
954
- let qpUpdates = this._qpUpdates;
955
- let params = getFullQueryParams(this, this._routerMicrolib.activeTransition[STATE_SYMBOL]);
956
-
957
- for (let key in params) {
958
- if (!qpUpdates.has(key)) {
959
- unchangedQPs[key] = params[key];
960
- }
961
- } // We need to fully scope queryParams so that we can create one object
962
- // that represents both passed-in queryParams and ones that aren't changed
963
- // from the active transition.
964
-
965
-
966
- this._fullyScopeQueryParams(targetRouteName, models, _queryParams);
967
-
968
- this._fullyScopeQueryParams(targetRouteName, models, unchangedQPs);
969
-
970
- Object.assign(queryParams, unchangedQPs);
971
- }
972
- /**
973
- Prepares the query params for a URL or Transition. Restores any undefined QP
974
- keys/values, serializes all values, and then prunes any default values.
975
- @private
976
- @method _prepareQueryParams
977
- @param {String} targetRouteName
978
- @param {Array<Object>} models
979
- @param {Object} queryParams
980
- @param {boolean} keepDefaultQueryParamValues
981
- @return {Void}
982
- */
983
-
984
-
985
- _prepareQueryParams(targetRouteName, models, queryParams, _fromRouterService) {
986
- let state = calculatePostTransitionState(this, targetRouteName, models);
987
-
988
- this._hydrateUnsuppliedQueryParams(state, queryParams, Boolean(_fromRouterService));
989
-
990
- this._serializeQueryParams(state.routeInfos, queryParams);
991
-
992
- if (!_fromRouterService) {
993
- this._pruneDefaultQueryParamValues(state.routeInfos, queryParams);
994
- }
995
- }
996
- /**
997
- Returns the meta information for the query params of a given route. This
998
- will be overridden to allow support for lazy routes.
999
- @private
1000
- @method _getQPMeta
1001
- @param {RouteInfo} routeInfo
1002
- @return {Object}
1003
- */
1004
-
1005
-
1006
- _getQPMeta(routeInfo) {
1007
- let route = routeInfo.route;
1008
- return route && get(route, '_qp');
1009
- }
1010
- /**
1011
- Returns a merged query params meta object for a given set of routeInfos.
1012
- Useful for knowing what query params are available for a given route hierarchy.
1013
- @private
1014
- @method _queryParamsFor
1015
- @param {Array<RouteInfo>} routeInfos
1016
- @return {Object}
1017
- */
1018
-
1019
-
1020
- _queryParamsFor(routeInfos) {
1021
- let routeInfoLength = routeInfos.length;
1022
- let leafRouteName = routeInfos[routeInfoLength - 1].name;
1023
- let cached = this._qpCache[leafRouteName];
1024
-
1025
- if (cached !== undefined) {
1026
- return cached;
1027
- }
1028
-
1029
- let shouldCache = true;
1030
- let map = {};
1031
- let qps = [];
1032
- let qpsByUrlKey = DEBUG ? {} : null;
1033
- let qpMeta;
1034
- let urlKey;
1035
- let qpOther;
1036
-
1037
- for (let routeInfo of routeInfos) {
1038
- qpMeta = this._getQPMeta(routeInfo);
1039
-
1040
- if (!qpMeta) {
1041
- shouldCache = false;
1042
- continue;
1043
- } // Loop over each QP to make sure we don't have any collisions by urlKey
1044
-
1045
-
1046
- for (let qp of qpMeta.qps) {
1047
- if (DEBUG) {
1048
- urlKey = qp.urlKey;
1049
- qpOther = qpsByUrlKey[urlKey];
1050
-
1051
- if (qpOther && qpOther.controllerName !== qp.controllerName) {
1052
- assert(`You're not allowed to have more than one controller property map to the same query param key, but both \`${qpOther.scopedPropertyName}\` and \`${qp.scopedPropertyName}\` map to \`${urlKey}\`. You can fix this by mapping one of the controller properties to a different query param key via the \`as\` config option, e.g. \`${qpOther.prop}: { as: 'other-${qpOther.prop}' }\``, false);
1053
- }
1054
-
1055
- qpsByUrlKey[urlKey] = qp;
1056
- }
1057
-
1058
- qps.push(qp);
1059
- }
1060
-
1061
- Object.assign(map, qpMeta.map);
1062
- }
1063
-
1064
- let finalQPMeta = {
1065
- qps,
1066
- map
1067
- };
1068
-
1069
- if (shouldCache) {
1070
- this._qpCache[leafRouteName] = finalQPMeta;
1071
- }
1072
-
1073
- return finalQPMeta;
1074
- }
1075
- /**
1076
- Maps all query param keys to their fully scoped property name of the form
1077
- `controllerName:propName`.
1078
- @private
1079
- @method _fullyScopeQueryParams
1080
- @param {String} leafRouteName
1081
- @param {Array<Object>} contexts
1082
- @param {Object} queryParams
1083
- @return {Void}
1084
- */
1085
-
1086
-
1087
- _fullyScopeQueryParams(leafRouteName, contexts, queryParams) {
1088
- let state = calculatePostTransitionState(this, leafRouteName, contexts);
1089
- let routeInfos = state.routeInfos;
1090
- let qpMeta;
1091
-
1092
- for (let routeInfo of routeInfos) {
1093
- qpMeta = this._getQPMeta(routeInfo);
1094
-
1095
- if (!qpMeta) {
1096
- continue;
1097
- }
1098
-
1099
- for (let qp of qpMeta.qps) {
1100
- let presentProp = qp.prop in queryParams && qp.prop || qp.scopedPropertyName in queryParams && qp.scopedPropertyName || qp.urlKey in queryParams && qp.urlKey;
1101
-
1102
- if (presentProp) {
1103
- if (presentProp !== qp.scopedPropertyName) {
1104
- queryParams[qp.scopedPropertyName] = queryParams[presentProp];
1105
- delete queryParams[presentProp];
1106
- }
1107
- }
1108
- }
1109
- }
1110
- }
1111
- /**
1112
- Hydrates (adds/restores) any query params that have pre-existing values into
1113
- the given queryParams hash. This is what allows query params to be "sticky"
1114
- and restore their last known values for their scope.
1115
- @private
1116
- @method _hydrateUnsuppliedQueryParams
1117
- @param {TransitionState} state
1118
- @param {Object} queryParams
1119
- @return {Void}
1120
- */
1121
-
1122
-
1123
- _hydrateUnsuppliedQueryParams(state, queryParams, _fromRouterService) {
1124
- let routeInfos = state.routeInfos;
1125
- let appCache = this._bucketCache;
1126
- let qpMeta;
1127
- let qp;
1128
- let presentProp;
1129
-
1130
- for (let routeInfo of routeInfos) {
1131
- qpMeta = this._getQPMeta(routeInfo);
1132
-
1133
- if (!qpMeta) {
1134
- continue;
1135
- } // Needs to stay for index loop to avoid throwIfClosureRequired
1136
-
1137
-
1138
- for (let j = 0, qpLen = qpMeta.qps.length; j < qpLen; ++j) {
1139
- qp = qpMeta.qps[j];
1140
- assert('expected qp', qp);
1141
- presentProp = qp.prop in queryParams && qp.prop || qp.scopedPropertyName in queryParams && qp.scopedPropertyName || qp.urlKey in queryParams && qp.urlKey;
1142
- assert(`You passed the \`${presentProp}\` query parameter during a transition into ${qp.route.routeName}, please update to ${qp.urlKey}`, function () {
1143
- if (qp.urlKey === presentProp || qp.scopedPropertyName === presentProp) {
1144
- return true;
1145
- }
1146
-
1147
- if (_fromRouterService && presentProp !== false && qp.urlKey !== qp.prop) {
1148
- // assumptions (mainly from current transitionTo_test):
1149
- // - this is only supposed to be run when there is an alias to a query param and the alias is used to set the param
1150
- // - when there is no alias: qp.urlKey == qp.prop
1151
- return false;
1152
- }
1153
-
1154
- return true;
1155
- }());
1156
-
1157
- if (presentProp) {
1158
- if (presentProp !== qp.scopedPropertyName) {
1159
- queryParams[qp.scopedPropertyName] = queryParams[presentProp];
1160
- delete queryParams[presentProp];
1161
- }
1162
- } else {
1163
- let cacheKey = calculateCacheKey(qp.route.fullRouteName, qp.parts, state.params);
1164
- assert('ROUTER BUG: expected appCache to be defined. This is an internal bug, please open an issue on Github if you see this message!', appCache);
1165
- queryParams[qp.scopedPropertyName] = appCache.lookup(cacheKey, qp.prop, qp.defaultValue);
1166
- }
1167
- }
1168
- }
1169
- }
1170
-
1171
- _scheduleLoadingEvent(transition, originRoute) {
1172
- this._cancelSlowTransitionTimer();
1173
-
1174
- this._slowTransitionTimer = scheduleOnce('routerTransitions', this, this._handleSlowTransition, transition, originRoute);
1175
- }
1176
-
1177
- _handleSlowTransition(transition, originRoute) {
1178
- if (!this._routerMicrolib.activeTransition) {
1179
- // Don't fire an event if we've since moved on from
1180
- // the transition that put us in a loading state.
1181
- return;
1182
- }
1183
-
1184
- let targetState = new RouterState(this, this._routerMicrolib, this._routerMicrolib.activeTransition[STATE_SYMBOL]);
1185
- this.set('targetState', targetState);
1186
- transition.trigger(true, 'loading', transition, originRoute);
1187
- }
1188
-
1189
- _cancelSlowTransitionTimer() {
1190
- if (this._slowTransitionTimer) {
1191
- cancel(this._slowTransitionTimer);
1192
- }
1193
-
1194
- this._slowTransitionTimer = null;
1195
- } // These three helper functions are used to ensure errors aren't
1196
- // re-raised if they're handled in a route's error action.
1197
-
1198
-
1199
- _markErrorAsHandled(error) {
1200
- this._handledErrors.add(error);
1201
- }
1202
-
1203
- _isErrorHandled(error) {
1204
- return this._handledErrors.has(error);
1205
- }
1206
-
1207
- _clearHandledError(error) {
1208
- this._handledErrors.delete(error);
1209
- }
1210
-
1211
- _getEngineInstance({
1212
- name,
1213
- instanceId,
1214
- mountPoint
1215
- }) {
1216
- let engineInstances = this._engineInstances;
1217
- let namedInstances = engineInstances[name];
1218
-
1219
- if (!namedInstances) {
1220
- namedInstances = Object.create(null);
1221
- engineInstances[name] = namedInstances;
1222
- } // We just set these!
1223
-
1224
-
1225
- assert('has namedInstances', namedInstances);
1226
- let engineInstance = namedInstances[instanceId];
1227
-
1228
- if (!engineInstance) {
1229
- let owner = getOwner(this);
1230
- assert('Expected router to have EngineInstance as owner', owner instanceof EngineInstance);
1231
- assert(`You attempted to mount the engine '${name}' in your router map, but the engine can not be found.`, owner.hasRegistration(`engine:${name}`));
1232
- engineInstance = owner.buildChildEngineInstance(name, {
1233
- routable: true,
1234
- mountPoint
1235
- });
1236
- engineInstance.boot();
1237
- namedInstances[instanceId] = engineInstance;
1238
- }
1239
-
1240
- return engineInstance;
1241
- }
1242
-
1243
- }
1244
- /*
1245
- Helper function for iterating over routes in a set of routeInfos that are
1246
- at or above the given origin route. Example: if `originRoute` === 'foo.bar'
1247
- and the routeInfos given were for 'foo.bar.baz', then the given callback
1248
- will be invoked with the routes for 'foo.bar', 'foo', and 'application'
1249
- individually.
1250
-
1251
- If the callback returns anything other than `true`, then iteration will stop.
1252
-
1253
- @private
1254
- @param {Route} originRoute
1255
- @param {Array<RouteInfo>} routeInfos
1256
- @param {Function} callback
1257
- @return {Void}
1258
- */
1259
-
1260
-
1261
- function forEachRouteAbove(routeInfos, callback) {
1262
- for (let i = routeInfos.length - 1; i >= 0; --i) {
1263
- let routeInfo = routeInfos[i];
1264
- assert('has routeInfo', routeInfo);
1265
- let route = routeInfo.route; // routeInfo.handler being `undefined` generally means either:
1266
- //
1267
- // 1. an error occurred during creation of the route in question
1268
- // 2. the route is across an async boundary (e.g. within an engine)
1269
- //
1270
- // In both of these cases, we cannot invoke the callback on that specific
1271
- // route, because it just doesn't exist...
1272
-
1273
- if (route === undefined) {
1274
- continue;
1275
- }
1276
-
1277
- if (callback(route, routeInfo) !== true) {
1278
- return;
1279
- }
1280
- }
1281
- } // These get invoked when an action bubbles above ApplicationRoute
1282
- // and are not meant to be overridable.
1283
-
1284
-
1285
- let defaultActionHandlers = {
1286
- willResolveModel(_routeInfos, transition, originRoute) {
1287
- this._scheduleLoadingEvent(transition, originRoute);
1288
- },
1289
-
1290
- // Attempt to find an appropriate error route or substate to enter.
1291
- error(routeInfos, error, transition) {
1292
- let router = this;
1293
- let routeInfoWithError = routeInfos[routeInfos.length - 1];
1294
- forEachRouteAbove(routeInfos, (route, routeInfo) => {
1295
- // We don't check the leaf most routeInfo since that would
1296
- // technically be below where we're at in the route hierarchy.
1297
- if (routeInfo !== routeInfoWithError) {
1298
- // Check for the existence of an 'error' route.
1299
- let errorRouteName = findRouteStateName(route, 'error');
1300
-
1301
- if (errorRouteName) {
1302
- router._markErrorAsHandled(error);
1303
-
1304
- router.intermediateTransitionTo(errorRouteName, error);
1305
- return false;
1306
- }
1307
- } // Check for an 'error' substate route
1308
-
1309
-
1310
- let errorSubstateName = findRouteSubstateName(route, 'error');
1311
-
1312
- if (errorSubstateName) {
1313
- router._markErrorAsHandled(error);
1314
-
1315
- router.intermediateTransitionTo(errorSubstateName, error);
1316
- return false;
1317
- }
1318
-
1319
- return true;
1320
- });
1321
- logError(error, `Error while processing route: ${transition.targetName}`);
1322
- },
1323
-
1324
- // Attempt to find an appropriate loading route or substate to enter.
1325
- loading(routeInfos, transition) {
1326
- let router = this;
1327
- let routeInfoWithSlowLoading = routeInfos[routeInfos.length - 1];
1328
- forEachRouteAbove(routeInfos, (route, routeInfo) => {
1329
- // We don't check the leaf most routeInfos since that would
1330
- // technically be below where we're at in the route hierarchy.
1331
- if (routeInfo !== routeInfoWithSlowLoading) {
1332
- // Check for the existence of a 'loading' route.
1333
- let loadingRouteName = findRouteStateName(route, 'loading');
1334
-
1335
- if (loadingRouteName) {
1336
- router.intermediateTransitionTo(loadingRouteName);
1337
- return false;
1338
- }
1339
- } // Check for loading substate
1340
-
1341
-
1342
- let loadingSubstateName = findRouteSubstateName(route, 'loading');
1343
-
1344
- if (loadingSubstateName) {
1345
- router.intermediateTransitionTo(loadingSubstateName);
1346
- return false;
1347
- } // Don't bubble above pivot route.
1348
-
1349
-
1350
- return transition.pivotHandler !== route;
1351
- });
1352
- }
1353
-
1354
- };
1355
-
1356
- function logError(_error, initialMessage) {
1357
- let errorArgs = [];
1358
- let error;
1359
-
1360
- if (_error && typeof _error === 'object' && typeof _error.errorThrown === 'object') {
1361
- error = _error.errorThrown;
1362
- } else {
1363
- error = _error;
1364
- }
1365
-
1366
- if (initialMessage) {
1367
- errorArgs.push(initialMessage);
1368
- }
1369
-
1370
- if (error) {
1371
- if (error.message) {
1372
- errorArgs.push(error.message);
1373
- }
1374
-
1375
- if (error.stack) {
1376
- errorArgs.push(error.stack);
1377
- }
1378
-
1379
- if (typeof error === 'string') {
1380
- errorArgs.push(error);
1381
- }
1382
- }
1383
-
1384
- console.error(...errorArgs); //eslint-disable-line no-console
1385
- }
1386
- /**
1387
- Finds the name of the substate route if it exists for the given route. A
1388
- substate route is of the form `route_state`, such as `foo_loading`.
1389
-
1390
- @private
1391
- @param {Route} route
1392
- @param {String} state
1393
- @return {String}
1394
- */
1395
-
1396
-
1397
- function findRouteSubstateName(route, state) {
1398
- let owner = getOwner(route);
1399
- assert('Route is unexpectedly missing an owner', owner);
1400
- let {
1401
- routeName,
1402
- fullRouteName,
1403
- _router: router
1404
- } = route;
1405
- let substateName = `${routeName}_${state}`;
1406
- let substateNameFull = `${fullRouteName}_${state}`;
1407
- return routeHasBeenDefined(owner, router, substateName, substateNameFull) ? substateNameFull : '';
1408
- }
1409
- /**
1410
- Finds the name of the state route if it exists for the given route. A state
1411
- route is of the form `route.state`, such as `foo.loading`. Properly Handles
1412
- `application` named routes.
1413
-
1414
- @private
1415
- @param {Route} route
1416
- @param {String} state
1417
- @return {String}
1418
- */
1419
-
1420
-
1421
- function findRouteStateName(route, state) {
1422
- let owner = getOwner(route);
1423
- assert('Route is unexpectedly missing an owner', owner);
1424
- let {
1425
- routeName,
1426
- fullRouteName,
1427
- _router: router
1428
- } = route;
1429
- let stateName = routeName === 'application' ? state : `${routeName}.${state}`;
1430
- let stateNameFull = fullRouteName === 'application' ? state : `${fullRouteName}.${state}`;
1431
- return routeHasBeenDefined(owner, router, stateName, stateNameFull) ? stateNameFull : '';
1432
- }
1433
- /**
1434
- Determines whether or not a route has been defined by checking that the route
1435
- is in the Router's map and the owner has a registration for that route.
1436
-
1437
- @private
1438
- @param {Owner} owner
1439
- @param {Router} router
1440
- @param {String} localName
1441
- @param {String} fullName
1442
- @return {Boolean}
1443
- */
1444
-
1445
-
1446
- function routeHasBeenDefined(owner, router, localName, fullName) {
1447
- let routerHasRoute = router.hasRoute(fullName);
1448
- let ownerHasRoute = owner.hasRegistration(`template:${localName}`) || owner.hasRegistration(`route:${localName}`);
1449
- return routerHasRoute && ownerHasRoute;
1450
- }
1451
-
1452
- export function triggerEvent(routeInfos, ignoreFailure, name, args) {
1453
- if (!routeInfos) {
1454
- if (ignoreFailure) {
1455
- return;
1456
- } // TODO: update?
1457
-
1458
-
1459
- throw new EmberError(`Can't trigger action '${name}' because your app hasn't finished transitioning into its first route. To trigger an action on destination routes during a transition, you can call \`.send()\` on the \`Transition\` object passed to the \`model/beforeModel/afterModel\` hooks.`);
1460
- }
1461
-
1462
- let eventWasHandled = false;
1463
- let routeInfo, handler, actionHandler;
1464
-
1465
- for (let i = routeInfos.length - 1; i >= 0; i--) {
1466
- routeInfo = routeInfos[i];
1467
- assert('[BUG] Missing routeInfo', routeInfo);
1468
- handler = routeInfo.route;
1469
- actionHandler = handler && handler.actions && handler.actions[name];
1470
-
1471
- if (actionHandler) {
1472
- if (actionHandler.apply(handler, args) === true) {
1473
- eventWasHandled = true;
1474
- } else {
1475
- // Should only hit here if a non-bubbling error action is triggered on a route.
1476
- if (name === 'error') {
1477
- assert('[BUG] Missing handler', handler);
1478
-
1479
- handler._router._markErrorAsHandled(args[0]);
1480
- }
1481
-
1482
- return;
1483
- }
1484
- }
1485
- }
1486
-
1487
- let defaultHandler = defaultActionHandlers[name];
1488
-
1489
- if (defaultHandler) {
1490
- defaultHandler.call(this, routeInfos, ...args);
1491
- return;
1492
- }
1493
-
1494
- if (!eventWasHandled && !ignoreFailure) {
1495
- throw new EmberError(`Nothing handled the action '${name}'. If you did handle the action, this error can be caused by returning true from an action handler in a controller, causing the action to bubble.`);
1496
- }
1497
- }
1498
-
1499
- function calculatePostTransitionState(emberRouter, leafRouteName, contexts) {
1500
- let state = emberRouter._routerMicrolib.applyIntent(leafRouteName, contexts);
1501
-
1502
- let {
1503
- routeInfos,
1504
- params
1505
- } = state;
1506
-
1507
- for (let routeInfo of routeInfos) {
1508
- // If the routeInfo is not resolved, we serialize the context into params
1509
- if (!routeInfo.isResolved) {
1510
- params[routeInfo.name] = routeInfo.serialize(routeInfo.context);
1511
- } else {
1512
- params[routeInfo.name] = routeInfo.params;
1513
- }
1514
- }
1515
-
1516
- return state;
1517
- }
1518
-
1519
- function updatePaths(router) {
1520
- let infos = router._routerMicrolib.currentRouteInfos;
1521
-
1522
- if (infos.length === 0) {
1523
- return;
1524
- }
1525
-
1526
- let path = EmberRouter._routePath(infos);
1527
-
1528
- let info = infos[infos.length - 1];
1529
- assert('expected info', info);
1530
- let currentRouteName = info.name;
1531
- let location = router.location;
1532
- assert('expected location to not be a string', typeof location !== 'string');
1533
- let currentURL = location.getURL();
1534
- set(router, 'currentPath', path);
1535
- set(router, 'currentRouteName', currentRouteName);
1536
- set(router, 'currentURL', currentURL);
1537
- }
1538
-
1539
- function didBeginTransition(transition, router) {
1540
- let routerState = new RouterState(router, router._routerMicrolib, transition[STATE_SYMBOL]);
1541
-
1542
- if (!router.currentState) {
1543
- router.set('currentState', routerState);
1544
- }
1545
-
1546
- router.set('targetState', routerState);
1547
- transition.promise = transition.catch(error => {
1548
- if (router._isErrorHandled(error)) {
1549
- router._clearHandledError(error);
1550
- } else {
1551
- throw error;
1552
- }
1553
- }, 'Transition Error');
1554
- }
1555
-
1556
- function forEachQueryParam(router, routeInfos, queryParams, callback) {
1557
- let qpCache = router._queryParamsFor(routeInfos);
1558
-
1559
- for (let key in queryParams) {
1560
- if (!Object.prototype.hasOwnProperty.call(queryParams, key)) {
1561
- continue;
1562
- }
1563
-
1564
- let value = queryParams[key];
1565
- let qp = qpCache.map[key];
1566
- callback(key, value, qp);
1567
- }
1568
- }
1569
-
1570
- function findLiveRoute(liveRoutes, name) {
1571
- if (!liveRoutes) {
1572
- return;
1573
- }
1574
-
1575
- let stack = [liveRoutes];
1576
-
1577
- while (stack.length > 0) {
1578
- let test = stack.shift();
1579
-
1580
- if (test.render.name === name) {
1581
- return test;
1582
- }
1583
-
1584
- let outlets = test.outlets;
1585
-
1586
- for (let outletName in outlets) {
1587
- stack.push(outlets[outletName]);
1588
- }
1589
- }
1590
-
1591
- return;
1592
- }
1593
-
1594
- function appendLiveRoute(liveRoutes, defaultParentState, renderOptions) {
1595
- let ownState = {
1596
- render: renderOptions,
1597
- outlets: Object.create(null),
1598
- wasUsed: false
1599
- };
1600
- let target;
1601
-
1602
- if (renderOptions.into) {
1603
- target = findLiveRoute(liveRoutes, renderOptions.into);
1604
- } else {
1605
- target = defaultParentState;
1606
- }
1607
-
1608
- if (target) {
1609
- set(target.outlets, renderOptions.outlet, ownState);
1610
- } else {
1611
- liveRoutes = ownState;
1612
- }
1613
-
1614
- return {
1615
- liveRoutes,
1616
- ownState
1617
- };
1618
- }
1619
-
1620
- function representEmptyRoute(liveRoutes, defaultParentState, {
1621
- routeName
1622
- }) {
1623
- // the route didn't render anything
1624
- let alreadyAppended = findLiveRoute(liveRoutes, routeName);
1625
-
1626
- if (alreadyAppended) {
1627
- // But some other route has already rendered our default
1628
- // template, so that becomes the default target for any
1629
- // children we may have.
1630
- return alreadyAppended;
1631
- } else {
1632
- // Create an entry to represent our default template name,
1633
- // just so other routes can target it and inherit its place
1634
- // in the outlet hierarchy.
1635
- defaultParentState.outlets['main'] = {
1636
- render: {
1637
- name: routeName,
1638
- outlet: 'main'
1639
- },
1640
- outlets: {}
1641
- };
1642
- return defaultParentState;
1643
- }
1644
- }
1645
-
1646
- EmberRouter.reopen({
1647
- didTransition: defaultDidTransition,
1648
- willTransition: defaultWillTransition,
1649
- rootURL: '/',
1650
- location: 'hash',
1651
- // FIXME: Does this need to be overrideable via extend?
1652
- url: computed(function () {
1653
- let location = get(this, 'location');
1654
-
1655
- if (typeof location === 'string') {
1656
- return undefined;
1657
- }
1658
-
1659
- return location.getURL();
1660
- })
1661
- });
1662
- export default EmberRouter;