[js] deprecate some methods in advance of 3.0

Author: jleyba

javascript/node/selenium-webdriver/CHANGES.md

@@ -23,6 +23,7 @@
    module to break a circular dependency.
 * Added support for setting the username and password in basic auth pop-up
    dialogs (currently IE only).
+* Deprecated `WebElement#getInnerHtml()` and `WebEleemnt#getOuterHtml()`
 * FIXED: `io.findInPath()` will no longer match against directories that have
    the same basename as the target file.
 * FIXED: `phantomjs.Driver` now takes a third argument that defines the path to

javascript/node/selenium-webdriver/lib/webdriver.js

@@ -2135,6 +2135,7 @@ class WebElement {
    * Schedules a command to retrieve the outer HTML of this element.
    * @return {!promise.Promise<string>} A promise that will be
    *     resolved with the element's outer HTML.
+   * @deprecated Use {@link WebDriver#executeScript()}
    */
   getOuterHtml() {
     return this.driver_.executeScript(function() {
@@ -2153,6 +2154,7 @@ class WebElement {
    * Schedules a command to retrieve the inner HTML of this element.
    * @return {!promise.Promise<string>} A promise that will be
    *     resolved with the element's inner HTML.
+   * @deprecated Use {@link WebDriver#executeScript()}
    */
   getInnerHtml() {
     return this.driver_.executeScript('return arguments[0].innerHTML', this);