chore(browser): deprecate browser.getLocationAbsUrl().

Closes #3185

Author: sjelin

lib/browser.ts

@@ -928,8 +928,13 @@ export class ProtractorBrowser extends AbstractExtendedWebDriver {
   }
 
   /**
-   * Returns the current absolute url from AngularJS.
+   * Deprecated, use `browser.getCurrentUrl()` instead.
    *
+   * Dispite its name, this function will generally return `$location.url()`, though in some
+   * cases it will return `$location.absUrl()` instead.  This function is only here for legacy
+   * users, and will probably be removed in Protractor 6.0.
+   *
+   * @deprecated Please use `browser.getCurrentUrl()` 
    * @example
    * browser.get('http://angular.github.io/protractor/#/api');
    * expect(browser.getLocationAbsUrl())
@@ -938,6 +943,9 @@ export class ProtractorBrowser extends AbstractExtendedWebDriver {
    * AngularJS.
    */
   getLocationAbsUrl(): wdpromise.Promise<any> {
+    logger.warn(
+        'You are using `browser.getLocationAbsUrl()`, with is deprecated, inaccurately named, ' +
+        'inconsistent, and needlessly queries angular.js.  Please use `browser.getCurrentUrl`.');
     this.waitForAngular();
     return this.executeScriptWithDescription(
         clientSideScripts.getLocationAbsUrl, 'Protractor.getLocationAbsUrl()', this.rootEl);