[js] For consistency across languages, deprecate isElementPresent(). Since this

has been around for several years, it won't be removed until 3.0

Author: jleyba

javascript/node/selenium-webdriver/CHANGES.md

@@ -1,3 +1,15 @@
+## v2.53.0-dev
+
+### Change Summary
+
+* For consistency with the other Selenium language bindings,
+   `WebDriver#isElementPresent()` and `WebElement#isElementPresent()` have
+   been deprecated. These methods will be removed in v3.0. Use the findElements
+   command to test for the presence of an element:
+
+      driver.findElements(By.css('.foo')).then(found => !!found.length);
+
+
 ## v2.52.0
 
 ### Notice

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

@@ -872,6 +872,11 @@ class WebDriver {
    * @param {!(by.By|Function)} locator The locator to use.
    * @return {!promise.Promise<boolean>} A promise that will resolve
    *     with whether the element is present on the page.
+   * @deprecated This method will be removed in Selenium 3.0 for consistency
+   *     with the other Selenium language bindings. This method is equivalent
+   *     to
+   *
+   *      driver.findElements(locator).then(e => !!e.length);
    */
   isElementPresent(locator) {
     return this.findElements.apply(this, arguments).then(function(result) {
@@ -1769,6 +1774,11 @@ class WebElement {
    *     searching for the element.
    * @return {!promise.Promise<boolean>} A promise that will be
    *     resolved with whether an element could be located on the page.
+   * @deprecated This method will be removed in Selenium 3.0 for consistency
+   *     with the other Selenium language bindings. This method is equivalent
+   *     to
+   *
+   *      element.findElements(locator).then(e => !!e.length);
    */
   isElementPresent(locator) {
     return this.findElements(locator).then(function(result) {

javascript/node/selenium-webdriver/package.json

@@ -1,6 +1,6 @@
 {
   "name": "selenium-webdriver",
-  "version": "2.52.0",
+  "version": "2.53.0-dev",
   "description": "The official WebDriver JavaScript bindings from the Selenium project",
   "license": "Apache-2.0",
   "keywords": [