[js] Update examples & docs to not rely on btnG on the Google search page

After years of stability, the Google search page has recently changed so
that btnG is no longer visible on the page. This causes all of our
examples that interact with it to fail. Instead of trying to click the
search button, change examples to simply press RETURN after typing the
query.

Fixes #4491

Author: jleyba

javascript/node/selenium-webdriver/README.md

@@ -33,17 +33,14 @@ Automation in the Develop menu of Safari 10 before testing.
 The sample below and others are included in the `example` directory. You may
 also find the tests for selenium-webdriver informative.
 
-    var webdriver = require('selenium-webdriver'),
-        By = webdriver.By,
-        until = webdriver.until;
+    const {Builder, By, Key, until} = require('selenium-webdriver');
 
-    var driver = new webdriver.Builder()
+    let driver = new Builder()
         .forBrowser('firefox')
         .build();
 
     driver.get('http://www.google.com/ncr');
-    driver.findElement(By.name('q')).sendKeys('webdriver');
-    driver.findElement(By.name('btnG')).click();
+    driver.findElement(By.name('q')).sendKeys('webdriver', Key.RETURN);
     driver.wait(until.titleIs('webdriver - Google Search'), 1000);
     driver.quit();
 

javascript/node/selenium-webdriver/example/async_await_test.js

@@ -34,7 +34,7 @@
 'use strict';
 
 const assert = require('assert');
-const {Builder, By, promise, until} = require('..');
+const {Builder, By, Key, promise, until} = require('..');
 
 // async/await do not work well when the promise manager is enabled.
 // See https://github.com/SeleniumHQ/selenium/issues/3037
@@ -57,12 +57,13 @@ describe('Google Search', function() {
   it('example', async function() {
     await driver.get('https://www.google.com/ncr');
 
-    await driver.findElement(By.name('q')).sendKeys('webdriver');
-    await driver.findElement(By.name('btnG')).click();
+    await driver.findElement(By.name('q')).sendKeys('webdriver', Key.RETURN);
 
     await driver.wait(until.titleIs('webdriver - Google Search'), 1000);
 
     let url = await driver.getCurrentUrl();
-    assert.equal(url, 'https://www.google.com/#q=webdriver');
+    assert.ok(
+        url.startsWith('https://www.google.com/search'),
+        'unexpected url: ' + url);
   });
 });

javascript/node/selenium-webdriver/example/chrome_android.js

@@ -23,7 +23,7 @@
 
 'use strict';
 
-const {Builder, By, promise, until} = require('..');
+const {Builder, By, Key, promise, until} = require('..');
 const {Options} = require('../chrome');
 
 promise.consume(function* () {
@@ -34,8 +34,7 @@ promise.consume(function* () {
         .setChromeOptions(new Options().androidChrome())
         .build();
     yield driver.get('http://www.google.com/ncr');
-    yield driver.findElement(By.name('q')).sendKeys('webdriver');
-    yield driver.findElement(By.name('btnG')).click();
+    yield driver.findElement(By.name('q')).sendKeys('webdriver', Key.RETURN);
     yield driver.wait(until.titleIs('webdriver - Google Search'), 1000);
   } finally {
     yield driver && driver.quit();

javascript/node/selenium-webdriver/example/chrome_headless.js

@@ -27,7 +27,7 @@
  */
 
 const chrome = require('../chrome');
-const {Builder, By, until} = require('..');
+const {Builder, By, Key, until} = require('..');
 
 const width = 640;
 const height = 480;
@@ -39,8 +39,8 @@ let driver = new Builder()
     .build();
 
 driver.get('http://www.google.com/ncr')
-    .then(_ => driver.findElement(By.name('q')).sendKeys('webdriver'))
-    .then(_ => driver.findElement(By.name('btnG')).click())
+    .then(_ =>
+        driver.findElement(By.name('q')).sendKeys('webdriver', Key.RETURN))
     .then(_ => driver.wait(until.titleIs('webdriver - Google Search'), 1000))
     .then(
         _ => driver.quit(),

javascript/node/selenium-webdriver/example/chrome_mobile_emulation.js

@@ -22,7 +22,7 @@
 
 'use strict';
 
-const {Builder, By, promise, until} = require('..');
+const {Builder, By, Key, promise, until} = require('..');
 const {Options} = require('../chrome');
 
 promise.consume(function* () {
@@ -34,8 +34,7 @@ promise.consume(function* () {
             new Options().setMobileEmulation({deviceName: 'Nexus 5X'}))
         .build();
     yield driver.get('http://www.google.com/ncr');
-    yield driver.findElement(By.name('q')).sendKeys('webdriver');
-    yield driver.findElement(By.name('btnG')).click();
+    yield driver.findElement(By.name('q')).sendKeys('webdriver', Key.RETURN);
     yield driver.wait(until.titleIs('webdriver - Google Search'), 1000);
   } finally {
     yield driver && driver.quit();

javascript/node/selenium-webdriver/example/firefox_channels.js

@@ -27,7 +27,7 @@
 
 'use strict';
 
-const {Builder, By, promise, until} = require('..');
+const {Builder, By, Key, promise, until} = require('..');
 const {Channel, Options} = require('../firefox');
 
 let i = 0;
@@ -45,8 +45,8 @@ function doSearch(driver) {
     .then(_ => promise.delayed(750))
     // Now do the rest.
     .then(_ => driver.get('http://www.google.com/ncr'))
-    .then(_ => driver.findElement(By.name('q')).sendKeys('webdriver'))
-    .then(_ => driver.findElement(By.name('btnG')).click())
+    .then(_ =>
+        driver.findElement(By.name('q')).sendKeys('webdriver', Key.RETURN))
     .then(_ => driver.wait(until.titleIs('webdriver - Google Search'), 1000))
     .then(_ => driver.quit());
 }

javascript/node/selenium-webdriver/example/google_search.js

@@ -37,14 +37,14 @@
  *     node selenium-webdriver/example/google_search.js
  */
 
-const {Builder, By, until} = require('..');
+const {Builder, By, Key, until} = require('..');
 
 var driver = new Builder()
     .forBrowser('firefox')
     .build();
 
 driver.get('http://www.google.com/ncr')
-    .then(_ => driver.findElement(By.name('q')).sendKeys('webdriver'))
-    .then(_ => driver.findElement(By.name('btnG')).click())
+    .then(_ =>
+        driver.findElement(By.name('q')).sendKeys('webdriver', Key.RETURN))
     .then(_ => driver.wait(until.titleIs('webdriver - Google Search'), 1000))
     .then(_ => driver.quit());

javascript/node/selenium-webdriver/example/google_search_generator.js

@@ -28,7 +28,7 @@
 
 'use strict';
 
-const {Builder, By, promise, until} = require('..');
+const {Builder, By, Key, promise, until} = require('..');
 
 promise.consume(function* () {
   let driver;
@@ -38,10 +38,7 @@ promise.consume(function* () {
     yield driver.get('http://www.google.com/ncr');
 
     let q = yield driver.findElement(By.name('q'));
-    yield q.sendKeys('webdriver');
-
-    let btnG = yield driver.findElement(By.name('btnG'));
-    yield btnG.click();
+    yield q.sendKeys('webdriver', Key.RETURN);
 
     yield driver.wait(until.titleIs('webdriver - Google Search'), 1000);
   } finally {

javascript/node/selenium-webdriver/example/google_search_test.js

@@ -29,7 +29,7 @@
  *         mocha -t 10000 selenium-webdriver/example/google_search_test.js
  */
 
-const {Builder, By, until} = require('..');
+const {Builder, By, Key, until} = require('..');
 const test = require('../testing');
 
 test.describe('Google Search', function() {
@@ -42,8 +42,8 @@ test.describe('Google Search', function() {
   // You can write tests either using traditional promises.
   it('works with promises', function() {
     return driver.get('http://www.google.com/ncr')
-        .then(_ => driver.findElement(By.name('q')).sendKeys('webdriver'))
-        .then(_ => driver.findElement(By.name('btnG')).click())
+        .then(_ =>
+            driver.findElement(By.name('q')).sendKeys('webdriver', Key.RETURN))
         .then(_ => driver.wait(until.titleIs('webdriver - Google Search'), 1000));
   });
 
@@ -52,8 +52,7 @@ test.describe('Google Search', function() {
   // generator.
   test.it('works with generators', function*() {
     yield driver.get('http://www.google.com/ncr');
-    yield driver.findElement(By.name('q')).sendKeys('webdriver');
-    yield driver.findElement(By.name('btnG')).click();
+    yield driver.findElement(By.name('q')).sendKeys('webdriver', Key.RETURN);
     yield driver.wait(until.titleIs('webdriver - Google Search'), 1000);
   });
 

javascript/node/selenium-webdriver/example/logging.js

@@ -21,15 +21,15 @@
 
 'use strict';
 
-const {Builder, By, logging, until} = require('..');
+const {Builder, By, Key, logging, until} = require('..');
 
 logging.installConsoleHandler();
 logging.getLogger('webdriver.http').setLevel(logging.Level.ALL);
 
 var driver = new Builder().forBrowser('firefox').build();
 
 driver.get('http://www.google.com/ncr')
-    .then(_ => driver.findElement(By.name('q')).sendKeys('webdriver'))
-    .then(_ => driver.findElement(By.name('btnG')).click())
+    .then(_ =>
+        driver.findElement(By.name('q')).sendKeys('webdriver', Key.RETURN))
     .then(_ => driver.wait(until.titleIs('webdriver - Google Search'), 1000))
     .then(_ => driver.quit());