Skorowidz funkcji API produktu

Wykorzystanie

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

Parametry

Przykłady

Przykład 1: Aby kliknąć ten kod, należy użyć następującego kodu:

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

Przykład 2: Aby umieścić kursor myszy nad elementem przeglądarki, należy użyć następującego kodu:

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

Aby być kompatybilnym ze starą funkcją mouseMove , należy użyć następującej komendy:

$browser.actions().mouseMove(element).perform();

Uwaga: Interfejsy API do testowania przeglądarki obsługują metodę $browser.actions().mouseMove() w celu zapewnienia zgodności z wcześniejszą wersją i zaimplementować metodę z produktem $browser.actions().move() , ponieważ metoda została usunięta przez produkt Selenium w 2021 w tym zapotrzebowaniu.

Przykład 3: Aby wysłać klucze, należy uruchomić następujący kod:

await $browser.get("http://www.bing.com");
await $browser.actions().sendKeys("synthetic").perform();

Wykorzystanie

$browser.addHeader(key: string, val: string): Promise<void>;

Parametry

Przykłady

await $browser.addHeader(
  "User-Agent",
  "Mozilla/5.0 (iPhone; CPU OS 10_15_5 (Ergänzendes Update) like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/12.1.1 Mobile/14E304 Safari/605.1.15"
);

await $browser.get("https://www.yahoo.com/");
await $browser.takeScreenshot();

await $browser.addHeader(
  "User-Agent",
  "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.16; rv:86.0) Gecko/20100101 Firefox/86.0"
);

await $browser.get("https://www.yahoo.com/");
await $browser.takeScreenshot();

Wykorzystanie

$browser.addHeaders(headers: { [key: string]: string }): Promise<void>;

Parametry

Przykłady

await $browser.addHeaders({
  key1: "val1",
  key2: "val2",
});

Wykorzystanie

$browser.addHostnamesToDenylist(hostnameArr: string[]): Promise<void>

Uwaga: Instana udostępnia funkcję addHostnamesToDenylist do filtrowania adresów URL, ale nie usuwa funkcji addHostnamesToBlacklist , aby upewnić się, że kod jest kompatybilny z wcześniejszymi wersjami.

$browser.addHostnamesToBlacklist(hostnameArr: string[]): Promise<void>

Parametry

Przykłady

await $browser.addHostnamesToDenylist(["*.css", "*.png"]);
await $browser.addHostnamesToAllowlist(["*"]);

Wykorzystanie

$browser.addHostnamesToAllowlist(hostnameArr: string[]): Promise<void>

Uwaga: Instana udostępnia funkcję addHostnamesToAllowlist do filtrowania adresów URL, ale nie usuwa funkcji addHostnamesToWhitelist , aby zapewnić, że kod jest kompatybilny z wcześniejszymi wersjami.

$browser.addHostnamesToWhitelist(hostnameArr: string[]): Promise<void>

Parametry

Przykłady

await $browser.addHostnamesToDenylist(["*.css", "*.png"]);
await $browser.addHostnamesToAllowlist(["*"]);

Wykorzystanie

$browser.addHostnameToDenylist(hostname: string): Promise<void>

Uwaga: Instana udostępnia funkcję addHostnameToDenylist do filtrowania adresów URL, ale nie usuwa funkcji addHostnameToBlacklist , aby zapewnić, że kod jest kompatybilny z wcześniejszymi wersjami.

$browser.addHostnameToBlacklist(hostname: string): Promise<void>

Parametry

Przykłady

await $browser.addHostnameToDenylist(`*.css`);
await $browser.addHostnameToAllowlist(`*`);

Wykorzystanie

$browser.addHostnameToAllowlist(hostname: string): Promise<void>

Uwaga: Instana udostępnia funkcję addHostnameToAllowlist do filtrowania adresów URL, ale nie usuwa funkcji addHostnameToWhitelist , aby upewnić się, że kod jest kompatybilny z wcześniejszymi wersjami.

$browser.addHostnameToWhitelist(hostname: string): Promise<void>

Parametry

Przykłady

await $browser.addHostnameToDenylist(`*.css`);
await $browser.addHostnameToAllowlist(`*`);

Wykorzystanie

$browser.clearProxy(): Promise<void>;

Wykorzystanie

$browser.deleteHeader(key: string): Promise<void>;

Parametry

Przykłady

await $browser.addHeader('header1-xxx', 'abcd');
await $browser.addHeaders({
    key1: 'val1',
    key2: 'val2',
});
await $browser.deleteHeaders(['key1']);

await $browser.get(`http://localhost:${devport}/header-test`);
let userHeaders: Map<string, any>  = $browser.getHeaders();
console.log("User customized headers: ", [...userHeaders]);
expect(userHeaders.size).toEqual(2);

Wykorzystanie

$browser.deleteHeaders: (header: string[]) => Promise<void>;

Parametry

Przykłady

await $browser.addHeader('header1-xxx', 'abcd');
await $browser.addHeaders({
    key1: 'val1',
    key2: 'val2',
});
await $browser.deleteHeaders(['key1']);

await $browser.get(`http://localhost:${devport}/header-test`);
let userHeaders: Map<string, any>  = $browser.getHeaders();
console.log("User customized headers: ", [...userHeaders]);
expect(userHeaders.size).toEqual(2);

Wykorzystanie

$browser.deleteHostnameFromDenylist(hostname: string): Promise<void>;

Uwaga: Instana udostępnia funkcję deleteHostnameFromDenylist do filtrowania adresów URL, ale nie usuwa funkcji deleteHostnameFromBlacklist , aby zapewnić, że kod jest kompatybilny z wcześniejszymi wersjami.

$browser.deleteHostnameFromBlacklist(hostname: string): Promise<void>;

Parametry

Wykorzystanie

$browser.deleteHostnameFromAllowlist(hostname: string): Promise<void>;

Uwaga: Kod dodaje funkcję deleteHostnameFromAllowlist do interfejsu API, ale nie usuwa funkcji deleteHostnameFromWhitelist , aby zapewnić, że kod jest kompatybilny z wcześniejszymi wersjami.

$browser.deleteHostnameFromWhitelist(hostname: string): Promise<void>;

Parametry

Wykorzystanie

$browser.deleteHostnamesFromDenylist(hostnameArr: string[]): Promise<void>

Uwaga: Instana udostępnia funkcję deleteHostnamesFromDenylist do filtrowania adresów URL, ale nie usuwa funkcji deleteHostnamesFromBlacklist , aby zapewnić, że kod jest kompatybilny z wcześniejszymi wersjami.

$browser.deleteHostnamesFromBlacklist(hostnameArr: string[]): Promise<void>

Parametry

Wykorzystanie

$browser.deleteHostnamesFromAllowlist(hostnameArr: string[]): Promise<void>

Uwaga: Instana udostępnia funkcję deleteHostnamesFromAllowlist do filtrowania adresów URL, ale nie usuwa funkcji deleteHostnamesFromWhitelist , aby zapewnić, że kod jest kompatybilny z wcześniejszymi wersjami.

$browser.deleteHostnamesFromWhitelist(hostnameArr: string[]): Promise<void>

Parametry

Wykorzystanie

$browser.$$(selector);

Parametry

Przykłady

Plik index.html jest następujący:

<ul id="menu">
  <li><a href="/">Home</a></li>
  <li><a href="/">Developer Guide</a></li>
  <li><a href="/">API</a></li>
  <li><a href="/">Contribute</a></li>
</ul>

Użyj opcji $$ , aby znaleźć elementy w następujący sposób:

test("should get text a menu link", async () => {
  const menu = (await $browser.$$("#menu"))[0];
  const li = await menu.$$("li");

  console.log(await li[2].$("a").getText()); // outputs: "API"
});

test("should get text a menu link - JS Function", async () => {
  const text = (
    await $browser.$$(function () {
      // Arrow function is not allowed here.
      return document.querySelectorAll("#menu"); // Element[]
    })
  )[0];

  const li3Text = await (await text.$$("li"))[2].$("a").getText();
  console.log(li3Text); // outputs: "API"
});

Wykorzystanie

$browser.$(selector): WebElementPromise;

Parametry

Przykłady

Plik index.html jest następujący:

<ul id="menu">
  <li><a href="/">Home</a></li>
  <li><a href="/">Developer Guide</a></li>
  <li><a href="/">API</a></li>
  <li><a href="/">Contribute</a></li>
</ul>

Użyj $, aby znaleźć element w następujący sposób:

test("should get text a menu link", async () => {
  const text = await $browser.$("#menu").$$("li");
  console.log(await text[2].$("a").getText()); // outputs: "API"
});

test("should get text a menu link - JS Function", async () => {
  const text = await $browser.$(function () {
      // Arrow function is not allowed here.
      return document.querySelector("#menu"); // Element
    }).$$("li");

  console.log(text.$$("li")[2].$("a").getText()); // outputs: "API"
});

Wykorzystanie

$browser.execute(command) => Promise<T>

Promise<T> to obietnica, która zostanie rozstrzygnięta przy użyciu wyniku komendy.

Parametry

Wykorzystanie

$browser.executeAsyncScript<T>(script: string|Function, ...var_args: any[]): Promise<T>;

Parametry

Przykłady

Przykład 1: Aby wykonać sen zsynchronizowany z aktualnie wybranym oknem, należy użyć komend w sposób przedstawiony w poniższym przykładzie:

const start = new Date().getTime();
$browser.executeAsyncScript(
    "window.setTimeout(arguments[arguments.length - 1], 500);"
  ).then(function () {
    console.log("Elapsed time: " + (new Date().getTime() - start) + " ms");
  });

Przykład 2: Aby zsynchronizować test z aplikacją Ajax, należy użyć komend w sposób przedstawiony w poniższym przykładzie:

const button = $browser.$("#compose-button");
button.click();
$browser.executeAsyncScript(
  "var callback = arguments[arguments.length - 1];" +
    "mailClient.getComposeWindowWidget().onload(callback);"
);
$browser.switchTo().frame("composeWidget");
$browser.$("#to").sendKeys("dog@example.com");

Przykład 3: Aby wykonać wstrzyknięcie XMLHttpRequest i poczekać na wynik, należy użyć następujących komend. W tym przykładzie skrypt wstrzykiwania jest określony z literałem funkcji. Jeśli używany jest ten format, funkcja jest przekształcana w łańcuch do wstrzykiwań. W związku z tym funkcja nie może odwoływać się do żadnych symboli, które nie są zdefiniowane w zasięgu testowanej strony.

$browser.executeAsyncScript(function () {
    var callback = arguments[arguments.length - 1];
    var xhr = new XMLHttpRequest();
    xhr.open("GET", "/resource/data.json", true);
    xhr.onreadystatechange = function () {
      if (xhr.readyState == 4) {
        callback(xhr.responseText);
      }
    };
    xhr.send("");
  }).then(function (str) {
    console.log(JSON.parse(str)["food"]);
  });

Wykorzystanie

$browser.executeScript<T>(script: string|Function, ...var_args: any[]): Promise<T>;

Parametry

Wykorzystanie

$browser.findElement(locator: Locator): WebElementPromise;

Parametry

Przykłady

Tej funkcji nie można używać do sprawdzenia, czy dany element jest obecny na stronie. Zamiast tego należy użyć elementu findElements:

$browser.findElements($driver.By.id("foo"))
  .then((found) => console.log("Element found? %s", !!found.length));

Kryteria wyszukiwania dla elementu można zdefiniować za pomocą jednej z fabryk w przestrzeni nazw webdriver.By lub jako krótki obiekt webdriver.By.Hash . Na przykład następujące dwa instrukcje są równoważne:

var e1 = $browser.findElement($driver.By.id("foo"));
var e2 = $browser.findElement({ id: "foo" });

Można również udostępnić niestandardową funkcję wskaźnika, która pobiera jako dane wejściowe tę instancję i zwraca element WebElementlub obietnicę, która zostanie rozstrzygnięta przy użyciu elementu WebElement. Jeśli zwrócona obietnica zostanie rozstrzygana przy użyciu tablicy WebElements, element WebDriver korzysta z pierwszego elementu. Na przykład, aby znaleźć pierwszy widoczny odsyłacz na stronie, można użyć następujących komend:

var link = $browser.findElement(firstVisibleLink);

function firstVisibleLink(driver) {
  var links = driver.findElements(By.tagName("a"));
  return promise.filter(links, function (link) {
    return link.isDisplayed();
  });
}

Wykorzystanie

$browser.findElements(locator: Locator): Promise<WebElement[]>;

Parametry

Wykorzystanie

$browser.get(url: string): Promise<void>;

Parametry

Wykorzystanie

$browser.getAllWindowHandles(): Promise<string[]>;

Parametry

Wykorzystanie

$browser.getCapabilities(): Promise<Capabilities>;

Parametry

Wykorzystanie

$browser.getCurrentUrl(): Promise<string>;

Parametry

Wykorzystanie

$browser.getHeaders(): Map<string, any>;

Parametry

Przykłady

await $browser.addHeader('header1-xxx', 'abcd');
await $browser.addHeaders({
    key1: 'val1',
    key2: 'val2',
});
await $browser.deleteHeaders(['key1']);

await $browser.get(`http://localhost:${devport}/header-test`);
let userHeaders: Map<string, any>  = $browser.getHeaders();
console.log("User customized headers: ", [...userHeaders]);
expect(userHeaders.size).toEqual(2);

Wykorzystanie

$browser.getPageSource(): Promise<string>;

Parametry

Wykorzystanie

$browser.getProxy(): FFProxyConfig | CProxyConfig;

Ten interfejs API może być również wywoływany za pośrednictwem obiektu $network :

$network.getProxy(): FFProxyConfig | CProxyConfig;

Parametry

Konfiguracja serwera proxy

/** 
 * Firefox extension - An object encapsulating a complete proxy configuration
 * https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/proxy/settings
 */
export interface FFProxyConfig {
  proxyType?: FFProxyType,
  http?: string;
  ssl?: string,
  ftp?: string;
  autoConfigUrl?: string,
  autoLogin?: boolean,
  httpProxyAll?: boolean,
  passthrough?: string,
  proxyDNS?: boolean,
  socks?: string,
  socksVersion?: number,
}

/** 
 * Chrome extension - An object encapsulating a complete proxy configuration
 * https://developer.chrome.com/docs/extensions/reference/proxy/#type-ProxyConfig
 */
export interface CProxyConfig {
  mode: CProxyType,
  rules?: {
    bypassList?: string[],
    fallbackProxy?: ProxyServer,
    proxyForFtp?: ProxyServer,
    proxyForHttp?: ProxyServer,
    proxyForHttps?: ProxyServer,
    singleProxy?: ProxyServer,
  },
  pacScript?: {
    data?: string,
    mandatory?: boolean,
    url?: string,
  },
};

Wykorzystanie

$browser.getSession(): Promise<Session>;

Parametry

Wykorzystanie

$browser.getTitle(): Promise<string>;

Parametry

Wykorzystanie

$browser.getWindowHandle(): Promise<string>;

Parametry

Wykorzystanie

$browser.manage(): Options;

Parametry

Opcje

Opcje udostępniają metody zarządzania stanem przeglądarki i sterownika.

IWebDriverCookie

ITimeouts

Okno

export interface ILocation {
  x: number;
  y: number;
}

export interface ISize {
  width: number;
  height: number;
}

export interface IRectangle {
  x: number;
  y: number;
  width: number;
  height: number;
}

Interfejs do zarządzania bieżącym oknem.

Przykłady

let tm = await $browser.manage().getTimeouts();
console.log('current timeout', tm.implicit, tm.pageLoad, tm.script);

await $browser.manage().timeouts().pageLoadTimeout(119);
tm = await $browser.manage().getTimeouts();
expect(tm.pageLoad).toBe(119);
console.log('current timeout', tm.implicit, tm.pageLoad, tm.script);

await $browser.manage().timeouts().pageLoadTimeout(89);
tm = await $browser.manage().getTimeouts();
expect(tm.pageLoad).toBe(89);
console.log('current timeout', tm.implicit, tm.pageLoad, tm.script);

Wykorzystanie

$browser.navigate(): Navigation;

Parametry

Nawigacja

Interfejs nawigacyjny do przechowania w przód i w tył w historii przeglądarki.

Wykorzystanie

$browser.setAuthentication(authName: string, authPass: string): Promise<void>;

Parametry

Przykłady

await $browser.setAuthentication(basicauthuser, password);
await $browser.get(`http://${httpserver}/basic/page1.html`)
.then(() => $browser.takeScreenshot());

Wykorzystanie

$browser.setProxy(proxyURL: string | URL, noProxy?: string): Promise<void>;

Ten interfejs API może być również wywoływany za pośrednictwem obiektu $network .

$network.setProxy(proxyURL: string | URL, noProxy?: string): Promise<void>

Parametry

Wykorzystanie

$browser.setProxyAdvanced(proxyConfig: CProxyConfig | FFProxyConfig, authName?: string, authPass?: string): Promise<void>;

Ten interfejs API może być również wywoływany za pośrednictwem obiektu $network .

$network.setProxyAdvanced(proxyConfig: CProxyConfig | FFProxyConfig, authName?: string, authPass?: string): Promise<void>;

Parametry

Przykłady

async function testProxyAdvanced() {
  await $browser.clearProxy();
  var ffconfig = {
    proxyType: "manual",
    //proxyType: "autoConfig",
    http: proxy_4,
    ssl: proxy_4,
    ftp: proxy_4,
    autoConfigUrl: pacfile,
    passthrough: noproxy,
    autoLogin: true,
  }

  var pxyserver = {
    host: httpserver,
    port: 8088,
    scheme: "http",
  }

  var cconfig = {
    mode: "fixed_servers",
    rules: {
      bypassList: noproxy.split(','),
      fallbackProxy: {
        host: "my-proxy-server.us.ibm.com",
        port: 8080,
      },
      proxyForFtp: pxyserver,
      proxyForHttp: pxyserver,
      proxyForHttps: pxyserver, 
    },
    pacScript: {
      url: pacfile,
    },
  }

  var bname = null;
  await $browser.getCapabilities().then(cap=> {
    bname = cap.getBrowserName();
   });

  var config = (bname == 'chrome') ? cconfig : ffconfig;

  await $browser.setProxyAdvanced(config, proxyuser, password);
  await $browser.get(`http://${httpserver}/demo/page2.html`)
    .then(() => $browser.takeScreenshot());
}

Wykorzystanie

$browser.setProxyAuthentication(authName: string, authPass: string): Promise<void>;

Parametry

Przykłady

async function testProxyAuthentication() {
  await $browser.clearProxy();
  await $browser.setProxy(proxy_3, noproxy);
  await $browser.setProxyAuthentication(proxyuser, password); 
  await $browser.get(`http://${httpserver}/demo/page2.html`)
    .then(() => $browser.takeScreenshot());
}

Wykorzystanie

$browser.setProxyForHttp(proxyURL: string | URL, noProxy?: string): Promise<void>

Ten interfejs API może być również wywoływany za pośrednictwem obiektu $network .

$network.setProxyForHttp(proxyURL: string | URL, noProxy?: string): Promise<void>

Parametry

Przykłady

let website;
let proxyServer = "proxyHost:proxyPort";

console.log(">>>>>>>>>>>>>>>>>>>", "Clear proxy configuration");
await $network.clearProxy();
console.log(">>>>>>>>>>>>>>>>>>>", "Set proxy configuration for HTTP request");
await $network.setProxyForHttp(proxyServer);
website = await accessWebSite();
checkHostname("www.google.com.hk", website)

Wykorzystanie

$browser.setProxyForHttps(proxyURL: string | URL, noProxy?: string): Promise<void>;

Ten interfejs API może być również wywoływany za pośrednictwem obiektu $network .

$network.setProxyForHttps(proxyURL: string | URL, noProxy?: string): Promise<void>;

Parametry

Przykłady

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

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

Wykorzystanie

$browser.setProxyPAC(pacScriptURL: string, noProxy?: string, authMap?: Map<string, any>): Promise<void>;

Parametry

Przykłady

const httpserver = '<DemoServerIP>';
const noproxy = "localhost,google.com,192.168.1.0/24";
const pacfile = `http://${httpserver}/pacfile`;
const authmap = new Map([
  [ httpserver, {username: "proxyuser", password: "passw0rd"} ],
  [ "httpserver2", {username: "user1", password: "passw0rd"} ],
])

async function testProxyPAC() {
  await $browser.clearProxy();
  await $browser.setProxyPAC(pacfile, noproxy, authmap);
  await $browser
    .get(`http://${httpserver}/demo/page2.html`)
    .then(() => $browser.takeScreenshot());
}

Wykorzystanie

$browser.sleep(ms: number): Promise<void>;

Parametry

Przykłady

await $browser.get("https://www.yahoo.com/");
await $browser.sleep(3 * 1000);
await $browser.takeScreenshot();

Wykorzystanie

$browser.switchTo(): TargetLocator;

Parametry

TargetLocator

Interfejs przeznaczony do zmiany ostrości sterownika na inną ramkę lub okno.

Metody instancji

Przykłady

/**
 * samples of getting current window handle
 * switch to a new window
 * open new page in new tab
 */
console.log("Windows handle: ", await $browser.getWindowHandle(), "Current url: ", await $browser.getCurrentUrl());
console.log("switch to calendar tab");
let originalWindow = await $browser.getWindowHandle();
await $browser.switchTo().newWindow();

/**
 * navigate to www.timeanddate.com
 * assert page title by getTitle() api
 * assert page title by getPageSource() api
 */
console.log("Access time and date page");
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());

/**
 * switch back to original window
 * take screenshot
 */
await $browser.switchTo().window(originalWindow);
await $browser.takeScreenshot();

Wykorzystanie

$browser.takeScreenshot(): Promise<string>;

Parametry

Wykorzystanie

$browser.wait(
    condition: WebElementCondition,
    opt_timeout?: number,
    opt_message?: string): WebElementPromise;

Parametry

Przykłady

Przykład 1: Aby czekać do 10 sekund na obecność elementu na stronie, należy użyć komend, jak pokazano w poniższym przykładzie:

async function example() {
  let button = await $browser.wait(
    $driver.until.elementLocated($driver.By.id("foo")),
    10000
  );
  await button.click();
}

Przykład 2: Aby czekać na element i kliknąć, należy użyć komend w sposób przedstawiony w poniższym przykładzie:

await $browser.wait(until.elementLocated(by), timeout);
const element = await $browser.findElement(by, timeout);
await $browser.wait(until.elementIsVisible(element), timeout, `${by} not visible`);
await $browser.wait(until.elementIsEnabled(element), timeout, `${by} not enabled`);
await element.click();

Wykorzystanie

$browser.waitForAndFindElement(locator: Locator, timeout?: number) : WebElementPromise;

Funkcja jest podobna w następujący sposób:

const element = await $browser.wait(until.elementLocated(locator), timeout);
await $browser.wait(until.elementIsVisible(element), timeout);
return await $browser.findElement(locator);

Parametry

Przykłady

$browser.waitForAndFindElement($driver.By.id("username"), 10000);

Wykorzystanie

$browser.waitForPendingRequests(timeout?: number): Promise<void>;

Funkcja jest podobna do

let script = "return document.readyState === 'complete'";
await $browser.wait(() => {
    return $browser.executeScript(script);
}, timeout);

Parametry