Utilities for working with and debugging Angular.js 1.x apps (ES6)

ng-util.js

(function exposeNgUtil(target = window) {
  if (!angular) {
    console.error(`ERROR: ng-util cannot initialize because "angular" was not found!`);
    return null;
  }

  getScope = el => angular.element( (el || document.getElementsByClassName('ng-scope')[0]) )

  let ngUtils = {
    // Use Angular.js' DI system to retrieve a provider.
    // 
    // @param {String} dep  The name of the provider to retrieve
    // @returns              An Angular.js Provider (e.g. '$log' or '$http')
    inject: dep => getScope().injector().get(dep),
    
    // Get the isolate scope associated with a given element. If the caller 
    // does not provide a target element, the function will fall back to the
    // first element with 'ng-scope' on the page.
    // 
    // @param el The DOM element that you want to retireve the isolate scope of
    // @returns  The isolate scope associated for that element
    isolate: el => getScope(el).isolateScope(),
    
    // Get the scope associated with a given element. If the caller does not
    // provide a target element, the function will fall back to the first
    // element with 'ng-scope' on the page.
    // 
    // @param el The DOM element that you want to retireve the scope of
    // @returns  Anagular.js scope for the specified element.
    scope: el => getScope(el).scope(),
    
    // Retrieves a function's parameter list using Angular's internal
    // annotation utilities.
    // 
    // $$annotate exists in 1.5 -- I don't know about other versions
    args: fn => angular.injector.$$annotate(fn),  
  };
  
  if (target === window) window.ngUtils = ngUtils
  else Object.assign(target, ngUtils)
})()

// Check to make sure that everything's working
ngUtils.inject('$log').info(`ng-utils loaded!`)

references.md

Injector

• Angular docs for injector - https://docs.angularjs.org/api/auto/service/$injector
• angular.element(e).injector().get('serviceName') - http://stackoverflow.com/questions/14278355/how-to-debug-angular-services-in-browser

Annotate

• https://github.com/angular/angular.js/blob/c855c3fb9f998a13fbb9f21f6bb76a1a6c4c32e4/src/auto/injector.js#L97