feat: add angular.reloadWithDebugInfo()

petebacondarwin · vojtajina · commit 41c1b8858f02 · 2014-08-27T20:45:58.000-07:00
diff --git a/src/.jshintrc b/src/.jshintrc
@@ -88,6 +88,7 @@
     "getBlockNodes": false,
     "createMap": false,
     "VALIDITY_STATE_PROPERTY": false,
+    "reloadWithDebugInfo": false,
 
     "skipDestroyOnNextJQueryCleanData": true,
 
diff --git a/src/Angular.js b/src/Angular.js
@@ -1402,6 +1402,14 @@ function bootstrap(element, modules, config) {
     modules.unshift(['$provide', function($provide) {
       $provide.value('$rootElement', element);
     }]);
+
+    if (config.debugInfoEnabled) {
+      // Pushing so that this overrides `debugInfoEnabled` setting defined in user's `modules`.
+      modules.push(['$compileProvider', function($compileProvider) {
+        $compileProvider.debugInfoEnabled(true);
+      }]);
+    }
+
     modules.unshift('ng');
     var injector = createInjector(modules, config.strictDi);
     injector.invoke(['$rootScope', '$rootElement', '$compile', '$injector',
@@ -1415,8 +1423,14 @@ function bootstrap(element, modules, config) {
     return injector;
   };
 
+  var NG_ENABLE_DEBUG_INFO = /^NG_ENABLE_DEBUG_INFO!/;
   var NG_DEFER_BOOTSTRAP = /^NG_DEFER_BOOTSTRAP!/;
 
+  if (window && NG_ENABLE_DEBUG_INFO.test(window.name)) {
+    config.debugInfoEnabled = true;
+    window.name = window.name.replace(NG_ENABLE_DEBUG_INFO, '');
+  }
+
   if (window && !NG_DEFER_BOOTSTRAP.test(window.name)) {
     return doBootstrap();
   }
@@ -1430,6 +1444,32 @@ function bootstrap(element, modules, config) {
   };
 }
 
+/**
+ * @ngdoc function
+ * @name angular.reloadWithDebugInfo
+ * @module ng
+ * @description
+ * Use this function to reload the current application with debug information turned on.
+ *
+ * To improve performance adding various debugging information can be disabled.
+ * See {@link $compileProvider#debugInfoEnabled}.
+ *
+ * This overrides any setting of `$compileProvider.debugInfoEnabled()` that you defined in your
+ * modules. If you wish to debug an application via this information then you should open up a debug
+ * console in the browser then call this method directly in this console:
+ *
+ * ```js
+ * angular.reloadWithDebugInfo();
+ * ```
+ *
+ * The page should reload and the debug information should now be available.
+ *
+ */
+function reloadWithDebugInfo(doReload) {
+  window.name = 'NG_ENABLE_DEBUG_INFO!' + window.name;
+  if ( doReload !== false ) window.location.reload();
+}
+
 var SNAKE_CASE_REGEXP = /[A-Z]/g;
 function snake_case(name, separator) {
   separator = separator || '_';
diff --git a/src/AngularPublic.js b/src/AngularPublic.js
@@ -137,7 +137,8 @@ function publishExternalAPI(angular){
     'uppercase': uppercase,
     'callbacks': {counter: 0},
     '$$minErr': minErr,
-    '$$csp': csp
+    '$$csp': csp,
+    'reloadWithDebugInfo': reloadWithDebugInfo
   });
 
   angularModule = setupModuleLoader(window);
diff --git a/test/AngularSpec.js b/test/AngularSpec.js
@@ -1099,6 +1099,26 @@ describe('angular', function() {
   });
 
 
+  describe("reloadWithDebugInfo", function() {
+
+    it("should reload the current page with debugInfo turned on", function() {
+
+      element = jqLite('<div>{{1+2}}</div>');
+      angular.bootstrap(element);
+      expect(element.hasClass('ng-scope')).toBe(false);
+      dealoc(element);
+
+      // We pass the false to prevent the page actually reloading
+      angular.reloadWithDebugInfo(false);
+
+      element = jqLite('<div>{{1+2}}</div>');
+      angular.bootstrap(element);
+      expect(element.hasClass('ng-scope')).toBe(true);
+      dealoc(element);
+    });
+  });
+
+
   describe('startingElementHtml', function(){
     it('should show starting element tag only', function(){
       expect(startingTag('<ng-abc x="2A"><div>text</div></ng-abc>')).
