const { Builder, Browser } = require("selenium-webdriver");
你可以使用 Builder() 构造函数创建一个新的驱动实例，并链式调用 forBrowser() 方法来指定你希望使用的浏览器。build() 方法在链式调用的末尾用于实际构建驱动实例（有关这些功能的详细信息，请参阅 Builder 类参考）。
js
let driver = new Builder().forBrowser(Browser.FIREFOX).build();
请注意，你可以为要测试的浏览器设置特定的配置选项。例如，你可以在 forBrowser() 方法中设置特定的版本和操作系统：
js
let driver = new Builder().forBrowser(Browser.FIREFOX, "46", "MAC").build();
你也可以使用环境变量来设置这些选项，例如：
bash
SELENIUM_BROWSER=firefox:46:MAC
让我们创建一个新测试，以便在讨论这些代码时进行探索。在你的 Selenium 测试项目目录中，创建一个名为 quick_test.js 的新文件，并添加以下代码：
js
const { Builder, Browser } = require("selenium-webdriver");
(async function example() {
  const driver = await new Builder().forBrowser(Browser.FIREFOX).build();
})();

driver.get("http://www.google.com");
可以查看 WebDriver 类参考了解这一部分和下面提到的内容的详情。

你可以使用包含 file:// 的 URL 来指向需要测试的本地文件：
js
driver.get(
  "file:///Users/chrismills/git/learning-area/tools-testing/cross-browser-testing/accessibility/fake-div-buttons.html",
js
driver.get("http://localhost:8888/fake-div-buttons.html");
使用一个远程的服务器地址代码会更灵活——当你启用远程服务器运行测试时，如果企图使用本地路径，代码会中断。
更新 example() 函数如下：
js
const { Builder, Browser } = require("selenium-webdriver");
(async function example() {
  const driver = await new Builder().forBrowser(Browser.FIREFOX).build();
  driver.get(
    "https://mdn.github.io/learning-area/tools-testing/cross-browser-testing/accessibility/native-keyboard-accessibility.html",
})();

const element = driver.findElement(By.id("myElementId"));
通过 CSS 查找元素的最常用方法是使用 By.css() 方法，它可以通过 CSS 选择器的方式来选择元素。
现在更新 example() 函数如下：
js
const { Builder, Browser, By } = require("selenium-webdriver");
(async function example() {
  const driver = await new Builder().forBrowser(Browser.FIREFOX).build();
  driver.get(
    "https://mdn.github.io/learning-area/tools-testing/cross-browser-testing/accessibility/native-keyboard-accessibility.html",
  const button = driver.findElement(By.css("button:nth-of-type(1)"));
})();

button.getText().then((text) => {
  console.log(`按钮中的文本是 '${text}'`);
如下所示，将此添加到 example() 函数的底部：
js
const { Builder, Browser, By } = require("selenium-webdriver");
(async function example() {
  const driver = await new Builder().forBrowser(Browser.FIREFOX).build();
  driver.get(
    "https://mdn.github.io/learning-area/tools-testing/cross-browser-testing/accessibility/native-keyboard-accessibility.html",
  const button = driver.findElement(By.css("button:nth-of-type(1)"));
  button.getText().then((text) => {
    console.log(`按钮中的文本是 '${text}'`);
})();
在你的项目目录下，运行测试：
bash
node quick_test.js
你应该可以看到控制台打印出按钮的文本内容。
让我们做点更有用的事情吧。如下所示，用代码 button.click(); 替换前面的代码：
js
const { Builder, Browser, By } = require("selenium-webdriver");
(async function example() {
  const driver = await new Builder().forBrowser(Browser.FIREFOX).build();
  driver.get(
    "https://mdn.github.io/learning-area/tools-testing/cross-browser-testing/accessibility/native-keyboard-accessibility.html",
  const button = driver.findElement(By.css("button:nth-of-type(1)"));
  button.click();
})();
重新运行测试；按钮被点击，你会看到 alert() 框弹出来，这样就知道按钮是正常工作的了！
你还可以与弹出框进行交互。更新 example() 函数如下，再运行一下测试：
js
const { Builder, Browser, By, until } = require("selenium-webdriver");
(async function example() {
  const driver = await new Builder().forBrowser(Browser.FIREFOX).build();
  driver.get(
    "https://mdn.github.io/learning-area/tools-testing/cross-browser-testing/accessibility/native-keyboard-accessibility.html",
  const button = driver.findElement(By.css("button:nth-of-type(1)"));
  button.click();
  await driver.wait(until.alertIsPresent());
  const alert = driver.switchTo().alert();
  alert.getText().then((text) => {
    console.log(`提示文本是 '${text}'`);
  alert.accept();
})();
接下来，我们试一下在表单元素中输入文本。更新 example() 函数如下并运行测试：
js
const { Builder, Browser, By, until } = require("selenium-webdriver");
(async function example() {
  const driver = await new Builder().forBrowser(Browser.FIREFOX).build();
  driver.get(
    "https://mdn.github.io/learning-area/tools-testing/cross-browser-testing/accessibility/native-keyboard-accessibility.html",
  const input = driver.findElement(By.id("name"));
  input.sendKeys("填充表单");
  const button = driver.findElement(By.css("button:nth-of-type(1)"));
  button.click();
  await driver.wait(until.alertIsPresent());
  const alert = driver.switchTo().alert();
  alert.getText().then((text) => {
    console.log(`提示文本是 '${text}'`);
  alert.accept();
})();
你可以使用 Key 对象的属性提交无法用普通字符表示的按键。例如，我们在上面使用了这种代码，以便在提交表单输入之前按下 Tab 键：




    

js
driver.sleep(1000).then(() => {
  driver.findElement(By.name("q")).sendKeys(Key.TAB);

driver.sleep(2000).then(() => {
  driver.getTitle().then((title) => {
    if (title === "webdriver - Google Search") {
      console.log("Test passed");
    } else {
      console.log("Test failed");
sleep() 方法的参数指明需要等待的毫秒时间。该方法返回在时间完成时兑现的 promise，那时将调用 then() 内的代码块。在这里的示例中，我们通过 getTitle() 方法获得当前页面的标题，然后根据标题的值返回成功或失败的消息。
同样添加 sleep() 方法到我们的 quick_test.js 中，将 example() 函数更新如下：
js
const { Builder, Browser, By, until } = require("selenium-webdriver");
const driver = new Builder().forBrowser("firefox").build();
(async function example() {
  try {
    driver.get(
      "https://mdn.github.io/learning-area/tools-testing/cross-browser-testing/accessibility/native-keyboard-accessibility.html",
    driver.sleep(2000).then(() => {
      const input = driver.findElement(By.id("name"));
      input.sendKeys("填充表单");
      input.getAttribute("value").then((value) => {
        if (value !== "") {
          console.log("表单输入可编辑");
    const button = driver.findElement(By.css("button:nth-of-type(1)"));
    button.click();
    await driver.wait(until.alertIsPresent());
    const alert = driver.switchTo().alert();
    alert.getText().then((text) => {
      console.log(`提示文本是 '${text}'`);
    alert.accept();
  } finally {
    await driver.sleep(4000); // 延迟足够长的时间以看到搜索页面！
    driver.quit();
})();
WebDriver 会等待 2 秒然后填充表单的文本框。接下来我们使用 getAttribute() 获取它的 value 属性值，并对它进行测试（如是否为空），最后将测试结果打印出来。
还有一个方法叫 wait()，它是在一定的时间内对某个条件进行反复测试，然后再继续执行代码，它也使用了 util 库，其中定义了使用 wait() 的常见条件。

driver.quit();
运行该程序时，你应该会看到测试正在执行，并且在测试完成后，浏览器实例会自动关闭。这有助于防止计算机因过多的浏览器实例而变得杂乱无章，特别是在浏览器实例过多导致计算机速度减慢的情况下。

const { Builder, By, Key } = require("selenium-webdriver");
const request = require("request");
// 输入能力
const capabilities = {
  "bstack:options": {
    os: "OS X",
    osVersion: "Sonoma",
    browserVersion: "17.0",
    local: "false",
    seleniumVersion: "3.14.0",
    userName: "YOUR-USER-NAME",
    accessKey: "YOUR-ACCESS-KEY",
  browserName: "Safari",
const driver = new Builder()
  .usingServer("http://hub-cloud.browserstack.com/wd/hub")
  .withCapabilities(capabilities)
  .build();
(async function bStackGoogleTest() {
  try {
    await driver.get("https://www.google.com/");
    await driver.findElement(By.name("q")).sendKeys("webdriver", Key.RETURN);
    await driver.sleep(2000);
    const title = await driver.getTitle();
    if (title === "webdriver - Google Search") {
      console.log("测试通过");
    } else {
      console.log("测试失败");
  } finally {
    await driver.sleep(4000); // 延迟足够长的时间以看到搜索页面！
    await driver.quit();
})();
从 BrowserStack Account - Summary 获取用户名和访问密钥（请参阅用户名和访问密钥）。用实际用户名和访问密钥值替换代码中的 YOUR-USER-NAME 和 YOUR-ACCESS-KEY 占位符（并确保它们不泄露）。
执行下面命令：
bash
node bstack_google_test
测试被发送给 BrowserStack，测试结果会返回到你的控制台。这体现了包含报告机制的重要性！
现在回到 BrowserStack 自动化仪表板页面，你会看到测试列出来的结果：
如果你点击了测试链接，就会进入一个新的屏幕，在那里可以看到测试的视频记录，以及与测试相关的多个详细信息记录。
Browserstack 自动化仪表盘的 Resources 菜单选项上提供了许多运行自动化测试的有用信息。查看使用 Node JS 编写自动化测试的文档获取相关信息，研究一下使用 BrowserStack 可以帮你做到哪些事情。

如果你不想手写 capability 对象，可以使用文档中嵌入的生成器，参见运行你的首个测试）。

编程填充 BrowserStack 的测试详情
使用 BrowserStack REST API 和其他功能可以给测试添加更多详情，如测试是否通过，为什么通过，测试属于工程的哪个部分等，BrowserStack 默认并没有这些细节！
让我们来更新一下 bstack_google_test.js 示例，看看它们是怎样运作的：
在项目目录下运行以下命令，安装请求模块：
js
npm install request
之后，导入 node 需要的模块，用来给 REST API 发送请求。在代码的顶端添加如下语句：
js
const request = require("request");
现在更新一下 capabilities 对象，添加工程名——在右大括号前添加下面代码，记得要在上一行末增加一个逗号（在 BrowserStack 自动化仪表盘上，你可以修改 build 和 project 名称来组织不同窗口下的测试）：
js
'project' : 'Google test 2'
接下来获取当前会话的 sessionId，从而知道往哪儿发送请求（后面你会看到，ID 包含在请求的 URL 中）。将下面代码添加到创建 driver 对象（let driver …）的代码块下面：
js
let sessionId;
driver.session_.then((sessionData) => {
  sessionId = sessionData.id_;
最后，修改下面 driver.sleep(2000) 的代码，添加 REST API 调用（同样，使用你的真实用户名和访问密钥替换 YOUR-USER-NAME 和 YOUR-ACCESS-KEY 的值）：
js
driver.sleep(2000).then(() => {
  driver.getTitle().then((title) => {
    if (title === "webdriver - Google Search") {
      console.log("测试通过");
      request({
        uri: `https://YOUR-USER-NAME:YOUR-ACCESS-KEY@www.browserstack.com/automate/sessions/${sessionId}.json`,
        method: "PUT",
        form: {
          status: "passed",
          reason: "Google results showed correct title",
    } else {
      console.log("测试失败");
      request({
        uri: `https://YOUR-USER-NAME:YOUR-ACCESS-KEY@www.browserstack.com/automate/sessions/${sessionId}.json`,
        method: "PUT",
        form: {
          status: "failed",
          reason: "Google results showed wrong title",
代码很直观——测试一完成，就会发送一个 API 调用到 BrowserStack 来更新测试状态是通过还是完成，并且给出相关的原因。
现在回到 BrowserStack 自动化仪表盘页面，你会看到测试会话如之前一样正常运行，并且增加了更新的数据：

java -jar selenium-server-standalone-3.0.0.jar
修改 .jar 文件名为你获取的文件名称。
服务会运行在 http://localhost:4444/wd/hub，你可以去试试看是什么效果。
现在服务器运行起来了，让我们在 selenium 服务器上来创建一个示例测试。
复制 google_test.js 文件，改名为 google_test_remote.js，放到项目目录下。
将第二段代码（以 let driver = … 开头的代码段）修改如下：
js
let driver = new webdriver.Builder()
  .forBrowser("firefox")
  .usingServer("http://localhost:4444/wd/hub")
  .build();
运行测试，你会看到它如期执行，只不过这次是在独立服务器端：
bash
node google_test_remote.js
是不是很酷？我们是在本地测试的，但你可以任何一台服务器上使用相关的浏览器驱动进行测试，使用相应的 URL 将你的脚本和服务器连接起来就可以了。