Browser-Script

Die in der Tabelle aufgeführten vordefinierten globalen Variablen beschleunigen die Scriptentwicklung.

Die Verwendung und Deklaration der vordefinierten globalen Variablen lauten wie folgt:

Browsertests unterstützen Selenium-basierte APIs und mehr als 30 weitere erweiterte Browsertest-APIs. Weitere Informationen finden Sie unter „ API -Referenz “.

Die folgenden Beispielcodes zeigen, wie ein Browser-Script-Test zum Implementieren der folgenden Basisaktionen geschrieben wird:

• Header vorbereiten: Verwenden Sie den folgenden Befehl, um Anforderungsheader anzupassen, bevor Sie auf Websites zugreifen:

  await $browser.addHeader("test", "test");
  await $browser.addHeaders({ "test1": "test1", "test2": "test2" });
  await $browser.deleteHeaders(["test1", "test2"]);
  $browser.getHeaders().forEach((value, key) => console.log(">>>>>>>>>>>>>>>>>>>", "User customized headers: ", key + "=" + value));
   

• Zugriff steuern: Verwenden Sie die folgenden Befehle, um den Zugriff mit der Liste "Verweigern" und "Zulassen" zu steuern:

  await $browser.addHostnamesToDenylist(["*google*", "*timeanddate*"]);
  await $browser.deleteHostnameFromDenylist("*timeanddate*");
  await $browser.get("https://www.google.com");
   

  Wenn Sie nach Ausführung dieser Befehle eine Google-Suche durchführen, wird die Meldung angezeigt wwww.google.com is blocked.

• URL öffnen: Um URL im Browser zu öffnen und auf die Website zuzugreifen, verwenden Sie den folgenden Befehl:

  await $browser.get("http://www.bing.com");
   

• Ruhezeit festlegen: Verwenden Sie den folgenden Befehl, um die Ruhezeit im Browser festzulegen. Der Parameter gibt die Inaktivitätszeit in Millisekunden an. Im folgenden Beispiel wird der Browser für 2 Sekunden inaktiviert.

  await $browser.sleep(2000);
   

• Zusicherung mit Seitentitel verwenden: Die Zusicherung ist in Ihren Tests kritisch, um die Testergebnisse festzulegen Verwenden Sie den folgenden Code, um die Zusicherung mit Seitentitel oder Seitenquelle zu verwenden: Sie können die Bibliothek const assert = require("assert").strict; oder die Chai-Zusicherungsbibliothek const { assert } = require("chai");verwenden. Verwenden Sie console.log , um die Konsolenausgabe und die Konsolenprotokolldatei zu protokollieren.

  const { assert } = require("chai");
  
  await $browser.get("http://www.timeanddate.com");
  let page = await $browser.getPageSource();
  assert.isTrue(page.includes("<title>timeanddate.com</title>"));
  console.log(">>>>>>>>>>>>>>>>>>>", "Page title: ", await $browser.getTitle());
   

• Sitzung abrufen: Verwenden Sie den folgenden Befehl, um Informationen zu einer Sitzung abzurufen:

  let session = await $browser.getSession();
  console.log(">>>>>>>>>>>>>>>>>>>", "Session id: ", session.getId());
   

• Fenstergröße maximieren: Verwenden Sie den folgenden Befehl, um die Größe des Browserfensters zu maximieren:

  $browser.manage().window().maximize();
   

• Screenshot erstellen: Verwenden Sie den folgenden Befehl, um den Screenshot des Browsers zu erstellen:

  await $browser.takeScreenshot();
   

• Warten Sie und suchen Sie ein Element auf der Seite: Sie können die Befehle in der folgenden Tabelle für bestimmte Suchen verwenden:

  Name	verwenden
  $browser.waitForAndFindElement($driver.By.id("boxyear"), 1000)	Element nach ID suchen, bis das Element sichtbar ist oder der Zeitlimitwert erreicht ist
  $browser.findElements($driver.By.css('select'))	Mit dem CSS-Selektor nach mehreren Elementen auf der Seite suchen
  $browser.findElement($driver.By.linkText("About"))	Element nach linkTextsuchen.
  $browser.findElement($driver.By.xpath('//input[@value='f']'))	Element anhand von XPath suchen
  $browser.$('#boxyear')	Element nach ID suchen.
  $browser.$$(".rd-box")	Elemente nach Klasse suchen.
  elem.$('h2').$('a').getText()	Element nach Elementname suchen.

  Der folgende Beispielcode zeigt, wie Sie warten und ein Element auf der Seite suchen:

  // Find element by XPath and wait for the element until specified timeout value reached
  await $browser.waitForAndFindElement($driver.By.xpath(`//textarea[@inputmode='search']`), 10000);
  
  // Find element by id
  let elem = await $browser.waitForAndFindElement($driver.By.id("boxyear"), 1000);
  assert.equal("2022", await elem.getAttribute("value"));
  assert.equal("2022", await $browser.$('#boxyear').getAttribute("value"));
  
  // Find elements by CSS selector
  let selects = await $browser.findElements($driver.By.css('select'));
  assert.equal(2, selects.length);
  
  // Find elements by class
  let elems = await $browser.$$(".rd-box");
  console.log(await elems[0].$('h2').$('a').getText());
   

• Elemente suchen und Aktionen ausführen: Das folgende Beispiel zeigt, wie man ein Element anhand eines CSS-Selektors findet und Tastenbefehle mit ActionSequence sendet:

  <input id="sb_form_q" name="q" type="search">
   

  let textarea = await $browser.waitForAndFindElement($driver.By.css('#sb_form_q'), 10000);
  // Actions to send keys
  await $browser
    .actions()
    .move({ origin: textarea })
    .sendKeys("synthetic")
    .pause(5000)
    .sendKeys($driver.Key.ENTER)
    .perform();
   

• Warten, bis -Titel kommt Bedingung: Verwenden Sie den folgenden Befehl, um zu warten, bis der Titel kommt Bedingung:

  await $browser.wait($driver.until.titleContains('Year 2022 Calendar'), 10000);
   

• Bedingung 'Wait and poll until timeout': Verwenden Sie die folgenden Befehle, um die Bedingung 'wait and poll until timeout' anzuwenden:

  Hinweis: Das folgende Beispiel zeigt einen Aufruf einer Promise-Kette, der mit einer früheren Version kompatibel ist. Verwenden Sie den Code nicht in der aktuellen Version von „ JavaScript “. Verwenden Sie stattdessen modernen asynchronen JavaScript Code mit Async und Await.

  $browser.get("https://www.google.com");
  $browser.wait(function () {
    return $browser.getTitle().then(function (title) {return title.includes("Google");});
  }, 10000).then(function () {
    return $browser.findElement($driver.By.linkText("About")).click();
  }).then(function () {
    return $browser.navigate().back();
  });
   

• Zurück navigieren: Verwenden Sie den folgenden Befehl, um zur zuvor aufgerufenen Seite im Browser zurückzukehren:

  await $browser.navigate().back();
   

• Zu neuen Registerkarten wechseln: Um die aktuelle Fensterkennung abzurufen und zu einem neuen Fenster zu wechseln, um eine neue Seite in einer neuen Registerkarte zu öffnen und zum ursprünglichen Fenster zurückzukehren, verwenden Sie den folgenden Code:

  console.log("Windows handle: ", await $browser.getWindowHandle(), "Current url: ", await $browser.getCurrentUrl());
  let originalWindow = await $browser.getWindowHandle();
  await $browser.switchTo().newWindow();
  await $browser.get("http://www.timeanddate.com");
  await $browser.switchTo().window(originalWindow);
  await $browser.takeScreenshot();
   

• Mausklick: Verwenden Sie den folgenden Befehl, um die Maus zu bewegen:

  const element = await $browser.waitForAndFindElement(by, timeout);
  const out = $browser.actions().move({origin: element}).press().release().perform();
   

• Maus bewegen: Verwenden Sie den folgenden Befehl, um die Maus über ein Browserelement zu bewegen:

  const element = await $browser.waitForAndFindElement(by, timeout);
  const out = $browser.actions().move({origin: element, duration: 2000}).perform();
   

• Tasten senden: Verwenden Sie den folgenden Befehl, um Tasten zu senden:

  await $browser.actions().sendKeys("synthetic").perform();
   

Für den Zugriff auf DOM-Spiegelelemente können Sie die Funktion getShadowRoot() verwenden. Die neue Methode wird für das Diagramm 'Synthetic PoP Helm ' 1.1.1 oder höher unterstützt. Sie müssen ein Upgrade für Ihren synthetischen PoP -Version auf 1.1.1 oder höher durchführen, um die Unterstützung für die Schatten-DOM-Interaktion zu aktivieren.

let shadowHost = await $browser.waitForAndFindElement(shadowHostSelector, timeout);
let shadowRoot = await shadowHost.getShadowRoot();
let element = await shadowRoot.findElement(elementSelector);
console.log("element text is:", await element.getText(), ", id is:", await element.getId());
 

• Um einen Proxy für Anfragen an HTTP und HTTPS mithilfe der Variablen $network$browser oder einzurichten, verwenden Sie den folgenden Befehl. Sie können den Proxy mit string oder url.URLdefinieren.

  await $network.clearProxy();
  await $network.setProxyForHttp(proxyServer);
  website = await accessWebSite();
  checkHostname("www.google.com.hk", website)
  
  await $network.clearProxy();
  let testURL = new URL("http://" + sslProxyServer);
  await $network.setProxyForHttps(testURL);
  website = await accessWebSite();
  checkHostname("www.google.com", website);
   

• Verwenden Sie den folgenden Befehl, um den Proxy für alle Anforderungen mit der Umgehungsliste zum Filtern festzulegen. Nach der Ausführung dieses Befehls im folgenden Beispiel ist kein Proxy für www.google.comverfügbar.

  await $network.clearProxy();
  await $network.setProxy(proxyServer, "www.google.com");
  console.log(">>>>>>>>>>>>>>>>>>>", "Bypass list: ", $network.getProxy().rules.bypassList);
  website = await accessWebSite();
  checkHostname("www.google.com.hk", website);
   

Um sensible Daten in „ URL “ zu schwärzen, verwenden Sie den folgenden Befehl. Im folgenden Beispiel wird die „ URL “ als "url": "https://www.bing.com/?mkt=zh-CN&toHttps=1&redig=*"„.“ unkenntlich gemacht.

$util.secrets.setURLSecretsRegExps([/redig/i]);
console.log(">>>>>>>>>>>>>>>>>>>", "Access bing");
await $browser.get("http://cn.bing.com");
await $browser.wait($driver.until.titleContains('Bing'), 10000);
 

Das folgende Beispiel zeigt den Befehl zum Import des Zusicherungsmoduls chai:

var assert = require('chai').assert;
 

Instana Die Browser-Tests unterstützen die Kernmodule von Node.js in Node.js v18 oder höher.

[SyntheticPoP] [ERROR] process.exit is not allowed. This API is blocked by playback engine.
 

Instana Die synthetische Überwachung unterstützt die folgenden Module von Drittanbietern:

• @aws-sdk/client-s3 3.626.0
• atob 2.1.2
• Authentifikator 1.1.5
• basic-ftp 4.6.6
• btoa 1.2.1
• Chai 4.3.10
• Farben 1.4.0
• consoleplusplus 1.4.4
• crypto-js 4.2.0
• Faker 5.5.3
• 11.8.6
• joi 17.7.1
• js-yaml 4.1.0
• ldapauth-fork 5.0.2
• lodash 4.17.21
• Moment 2.29.4
• net-snmp 3.6.3
• Protokollpuffer 4.2.0
• q 1.5.1
• re2 1.18.3
• ssh2-sftp-client 7.2.3
• ssl-checker 2.0.7
• textcodierung 0.7.0
• Thrift 0.14.2
• totp-generator 0.0.14
• tough-Cookie 4.1.3
• Unterstreichungszeichen 1.13.3
• url-parse 1.5.10
• urllib 2.41.0
• UUID 3.4.0
• Validator 13.7.0
• ws 7.5.10
• xml2js 0.5.0

let click = async (message, by, timeout = 60000) => {
  console.log(`Click on ${message} >> ${by} << `);
  try {
    const element = await $browser.waitForAndFindElement(by, timeout);
    return $browser.actions().move({ origin: element }).click().perform();
  } catch (err) {
    console.error(`\ncatch(click): ${err.message}`);
    throw err;
  }
};

let hover = async (message, by, timeout = 60000) => {
  console.log(`Hover on ${message} >> ${by} << `);
  try {
    const element = await $browser.waitForAndFindElement(by, timeout);
    return $browser.actions().move({ origin: element, duration: 3000 }).perform();
  } catch (err) {
    console.error(`\ncatch(hover): ${err.message}`);
    throw err;
  }
};

(async function () {
  console.log(">>>>>>>>>>>>>>>>>>>", "Access bing page");
  await $browser.get("http://www.bing.com");
  console.log(">>>>>>>>>>>>>>>>>>>", "Actions of search");
  await hover("search button", $driver.By.xpath("//label[@id='search_icon']"), 10000);
  await $browser.takeScreenshot();
  await $browser.actions().sendKeys("synthetic").perform();
  await click("search button", $driver.By.xpath("//label[@id='search_icon']"), 10000);
})();
 

const { assert } = require("chai");

(async function () {
  /**
   * manipulate headers and retrieve all the customized headers
   */
  await $browser.addHeader("test", "test");
  await $browser.addHeaders({ "test1": "test1", "test2": "test2" });
  await $browser.deleteHeaders(["test1", "test2"]);
  $browser.getHeaders().forEach((value, key) => console.log(">>>>>>>>>>>>>>>>>>>", "User customized headers: ", key + "=" + value));

  /**
   * manipulate deny and allow list
   */
  await $browser.addHostnamesToDenylist(["*google*", "*timeanddate*"]);
  await $browser.deleteHostnameFromDenylist("*timeanddate*");

  /**
   * open url www.bing.com
   * find element by class selector
   * send keys to search Synthetic in the page
   */
  console.log(">>>>>>>>>>>>>>>>>>>", "Access bing page");
  await $browser.get("http://www.bing.com");
  console.log(">>>>>>>>>>>>>>>>>>>", "Actions of search");
  // Find element by XPath and wait for the element until specified timeout value reached
  await $browser.waitForAndFindElement($driver.By.xpath(`//textarea[@inputmode='search']`), 10000);
  // Sleep or pause to wait for specified milliseconds
  await $browser.sleep(5000);
  // Take a screenshot
  await $browser.takeScreenshot();
  // Actions to send keys
  await $browser.actions().sendKeys("synthetic").sendKeys($driver.Key.ENTER).perform();

  /* Find element by CSS selector and perform actions
  let textarea = await $browser.waitForAndFindElement($driver.By.css('#sb_form_q'), 10000);
  // Actions to send keys
  await $browser
    .actions()
    .move({ origin: textarea })
    .sendKeys("synthetic")
    .pause(5000)
    .sendKeys($driver.Key.ENTER)
    .perform();
  */

  /**
   * samples of promise chain invocation, which is not recommended but backwards compatible
   * samples of waiting and polling function with timeout value
   */
  await $browser.deleteHostnameFromDenylist("*google*");
  await $browser.get("https://www.google.com");
  // Call the wait function.
  await $browser.wait(function () {
    return $browser.getTitle().then(function (title) {
      return title.includes("Google");
    });
    //If the condition isn't satisfied within 10000 milliseconds (10 seconds), proceed anyway.
  }, 10000).then(function () {
    return $browser.findElement($driver.By.linkText("About")).click();
  }).then(function () {
    return $browser.navigate().back();
  });

})();
 

const url = require("url");
const URL = url.URL;
const { assert } = require("chai");

let website;
let proxyServer = "proxyHost:proxyPort";
let sslProxyServer = "username:password@proxyHost:proxyPort";

async function accessWebSite(url) {
  console.log(">>>>>>>>>>>>>>>>>>>", "Proxy configuration is: ", JSON.stringify($network.getProxy()));
  console.log(">>>>>>>>>>>>>>>>>>>", `Access website ${url}`);
  await $browser.get(url);
  await $browser.findElement($driver.By.name('q')).click();
  await $browser.actions().sendKeys('synthetic').sendKeys($driver.Key.ENTER).perform();
  await $browser.takeScreenshot();
  return $browser.getCurrentUrl();
}

function checkHostname(hostname, website) {
  let actualURL = new URL(website);
  console.log(">>>>>>>>>>>>>>>>>>>", "Hostname is: ", actualURL.hostname);
  assert.equal(actualURL.hostname, hostname);
}

(async function () {
  /**
   * samples of proxy configuration settings with await asynchronous
   * using $network tools
   */
  console.log(">>>>>>>>>>>>>>>>>>>", "Clear proxy configuration");
  await $network.clearProxy();
  console.log(">>>>>>>>>>>>>>>>>>>", "Set proxy configuration for HTTPS request with string");
  await $network.setProxyForHttps(proxyServer);
  website = await accessWebSite("https://www.bing.com");
  checkHostname("www.bing.com", website)

  console.log(">>>>>>>>>>>>>>>>>>>", "Clear proxy configuration");
  await $network.clearProxy();
  console.log(">>>>>>>>>>>>>>>>>>>", "Set proxy configuration for HTTPS request with URL object");
  let testURL = new URL("http://" + sslProxyServer);
  await $network.setProxyForHttps(testURL);
  website = await accessWebSite("https://www.google.com");
  checkHostname("www.google.com", website);


  /**
   * samples of proxy configuration settings with bypass list
   */
  await $network.clearProxy();
  await $network.setProxy(proxyServer, "www.google.com");
  console.log(">>>>>>>>>>>>>>>>>>>", "Proxy config: ", $network.getProxy());
  website = await accessWebSite("https://www.bing.com");
  checkHostname("www.bing.com", website);
})();