API リファレンス

使用法

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

パラメーター

例

例 1: クリックするには、以下のコードを使用します。

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

例 2: ブラウザー・エレメントの上にマウスを移動するには、以下のコードを使用します。

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

旧 mouseMove 機能と互換性を持たせるには、以下のコマンドを使用します。

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

ブラウザー・テスト API は、以前のバージョンとの互換性のために $browser.actions().mouseMove() メソッドをサポートし、 $browser.actions().move() を使用してこのメソッドを実装します。これは、この PRでこのメソッドが 2021 年に Selenium によって削除されたためです。

例 3: 鍵を送信するには、以下のコードを実行します。

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

使用法

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

パラメーター

例

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();

使用法

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

パラメーター

例

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

使用法

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

Instanaは URL フィルタリングのために addHostnamesToDenylist 関数を提供していますが、以前のバージョンとのコードの互換性を確保するために addHostnamesToBlacklist 関数を削除していません。

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

パラメーター

例

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

使用法

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

Instanaは URL フィルタリングのために addHostnamesToAllowlist 関数を提供していますが、以前のバージョンとのコードの互換性を確保するために addHostnamesToWhitelist 関数を削除していません。

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

パラメーター

例

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

使用法

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

Instanaは URL フィルタリングのために addHostnameToDenylist 関数を提供していますが、以前のバージョンとのコードの互換性を確保するために addHostnameToBlacklist 関数を削除していません。

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

パラメーター

例

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

使用法

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

Instanaは URL フィルタリングのために addHostnameToAllowlist 関数を提供していますが、以前のバージョンとのコードの互換性を確保するために addHostnameToWhitelist 関数を削除していません。

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

パラメーター

例

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

使用法

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

使用法

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

パラメーター

例

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);

使用法

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

パラメーター

例

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);

使用法

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

Instanaは URL フィルタリングのために deleteHostnameFromDenylist 関数を提供していますが、以前のバージョンとのコードの互換性を確保するために deleteHostnameFromBlacklist 関数を削除していません。

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

パラメーター

使用法

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

このコードは deleteHostnameFromAllowlist 関数を API に追加しますが、コードが以前のバージョンと互換性を持つようにするために deleteHostnameFromWhitelist 関数を削除することはありません。

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

パラメーター

使用法

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

Instanaは URL フィルタリングのために deleteHostnamesFromDenylist 関数を提供していますが、以前のバージョンとのコードの互換性を確保するために deleteHostnamesFromBlacklist 関数を削除していません。

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

パラメーター

使用法

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

Instanaは URL フィルタリングのために deleteHostnamesFromAllowlist 関数を提供していますが、以前のバージョンとのコードの互換性を確保するために deleteHostnamesFromWhitelist 関数を削除していません。

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

パラメーター

使用法

$browser.$$(selector);

パラメーター

例

index.html ファイルは以下のとおりです。

<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>

$$ を使用して、以下のようにエレメントを検索します。

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"
});

使用法

$browser.$(selector): WebElementPromise;

パラメーター

例

index.html ファイルは以下のとおりです。

<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>

次のように $を使用してエレメントを検索します。

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"
});

使用法

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

Promise<T> は、コマンド結果で解決される promise です。

パラメーター

使用法

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

パラメーター

例

例 1: 現在選択されているウィンドウと同期化されたスリープを実行するには、以下の例に示すようにコマンドを使用します。

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");
  });

例 2: テストを Ajax アプリケーションと同期するには、以下の例に示すようにコマンドを使用します。

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");

例 3: XMLHttpRequest を注入して結果を待機するには、以下のコマンドを使用します。 この例では、注入スクリプトは関数リテラルで指定されています。 このフォーマットを使用すると、関数は注入のためにストリングに変換されます。 そのため、この関数は、テスト対象ページのスコープで定義されていないシンボルを参照してはなりません。

$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"]);
  });

使用法

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

パラメーター

使用法

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

パラメーター

例

この機能を使用して、ページ上にエレメントが存在するかどうかをテストしてはなりません。 代わりに、findElementsを使う必要がある：

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

エレメントの検索基準を定義するには、 webdriver.By 名前空間内のいずれかのファクトリーを使用するか、短時間の webdriver.By.Hash オブジェクトとして使用します。 例えば、以下の 2 つのステートメントは同等です。

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

この関数はこのインスタンスを入力とし、WebElement、またはWebElement で解決されるプロミスを返します。 返されたプロミスが'WebElements,'WebDriver'の配列で解決される場合、最初の要素を使用する。 例えば、ページ上の最初の可視リンクを検索するには、以下のコマンドを使用できます。

var link = $browser.findElement(firstVisibleLink);

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

使用法

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

パラメーター

使用法

$browser.generateTOTPToken(key: string, options?: TOTPOptions): string;

パラメーター

例

例 1: TOTP トークンを生成し、ブラウザー・スクリプト・テストで 2 要素認証を使用してログインするには、以下のようにします。

await $browser.waitForAndFindElement($driver.By.id("password"), 15000);

let totp_token = $browser.generateTOTPToken($secure.totpKey);

await $browser.findElement($driver.By.id("password")).then((element) => {
  return element.clear().then(() => {
    return element.sendKeys(totp_token);
  });
});

例 2: Selenium SIDE スクリプト・テストで TOTP トークンを生成するには、以下のようにします。

{
  "id": "ec51296b-4d16-4167-ac83-ba87f89cc0c7",
  "comment": "Generate a TOTP token from a TOTP key",
  "command": "executeScript",
  "target": "return $browser.generateTOTPToken($secure.totpKey);",
  "targets": [],
  "value": "totpToken"
}

使用法

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

パラメーター

使用法

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

パラメーター

使用法

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

パラメーター

使用法

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

パラメーター

使用法

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

パラメーター

例

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);

使用法

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

パラメーター

使用法

$browser.getProxy(): FFProxyConfig | CProxyConfig;

この API は、 $network オブジェクトを介して呼び出すこともできます。

$network.getProxy(): FFProxyConfig | CProxyConfig;

パラメーター

プロキシー構成

/**
 * 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,
  },
};

使用法

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

パラメーター

使用法

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

パラメーター

使用法

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

パラメーター

使用法

$browser.manage(): Options;

パラメーター

オプション

これらのオプションは、ブラウザーおよびドライバーの状態を管理するためのメソッドを提供します。

IWebDriverCookie

ITタイムアウト

ウィンドウ

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;
}

現行ウィンドウを管理するためのインターフェース。

例

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);

使用法

$browser.navigate(): Navigation;

パラメーター

ナビゲーション

ブラウザー履歴で前後に移動するためのナビゲーション・インターフェース。

使用法

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

パラメーター

例

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

使用法

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

この API は、 $network オブジェクトを介して呼び出すこともできます。

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

パラメーター

使用法

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

この API は、 $network オブジェクトを介して呼び出すこともできます。

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

パラメーター

例

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());
}

使用法

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

パラメーター

例

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());
}

使用法

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

この API は、 $network オブジェクトを介して呼び出すこともできます。

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

パラメーター

例

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)

使用法

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

この API は、 $network オブジェクトを介して呼び出すこともできます。

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

パラメーター

例

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);

使用法

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

パラメーター

例

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());
}

使用法

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

パラメーター

例

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

使用法

$browser.switchTo(): TargetLocator;

パラメーター

TargetLocator

ドライバーのフォーカスを別のフレームまたはウィンドウに変更するためのインターフェース。

インスタンス・メソッド

例

/**
 * 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();

使用法

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

パラメーター

使用法

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

パラメーター

例

例 1: エレメントがページに表示されるのを最大 10 秒待機するには、以下の例に示すようにコマンドを使用します。

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

例 2: エレメントを待機してクリックするには、以下の例に示すようにコマンドを使用します。

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();

使用法

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

この関数は以下のようになります。

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

パラメーター

例

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

使用法

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

この関数は、以下のようになります。

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

パラメーター