メインコンテンツにスキップ

WebDriver Bidi プロトコル

これらのプロトコルコマンドは、現在の最新のWebDriver Bidi仕様に基づいて生成されています。テストでプロトコルを有効にするには、capabilities に webSocketUrl: true を設定していることを確認してください。

注意して使用してください！

ブラウザサポートは保証されておらず、インターフェースは将来変更される可能性があります。この標準は現在開発中であり、ブラウザベンダーは各自のタイムラインに基づいてこれらの機能を追加します。

最終更新: Sat Apr 26 2025 17:10:07 GMT-0700 (Pacific Daylight Time)

send​

WebDriver Bidiを介してソケットコマンドを送信

WebDriver Bidiプロトコルコマンド。詳細は公式プロトコルドキュメントで確認できます。

使用法​
browser.send(params)
パラメータ​
名前型詳細
paramsCommandDataソケットペイロード
戻り値​
  • <Object> CommandResponse: WebDriver Bidiレスポンス

sendAsync​

WebDriver Bidiを介して非同期ソケットコマンドを送信

WebDriver Bidiプロトコルコマンド。詳細は公式プロトコルドキュメントで確認できます。

使用法​
browser.sendAsync(params)
パラメータ​
名前型詳細
paramsCommandDataソケットペイロード
戻り値​
  • <Number> id: WebDriver Bidiリクエストのid

sessionStatus​

パラメータを使用してコマンドメソッド "session.status" を送信するWebDriver Bidiコマンド。

WebDriver Bidiプロトコルコマンド。詳細は公式プロトコルドキュメントで確認できます。

使用法​
browser.sessionStatus(params)
パラメータ​
名前型詳細
paramsremote.EmptyParams
{}
戻り値​
  • <Object> local.SessionStatusResult: 以下のインターフェースを持つコマンド戻り値: 
    {
      ready: boolean;
      message: string;
    }

sessionNew​

パラメータを使用してコマンドメソッド "session.new" を送信するWebDriver Bidiコマンド。

WebDriver Bidiプロトコルコマンド。詳細は公式プロトコルドキュメントで確認できます。

使用法​
browser.sessionNew(params)
パラメータ​
名前型詳細
paramsremote.SessionNewParameters
{
  capabilities: SessionCapabilitiesRequest;
}
戻り値​
  • <Object> local.SessionNewResult: 以下のインターフェースを持つコマンド戻り値: 
    {
      sessionId: string;
      capabilities: {
        acceptInsecureCerts: boolean;
        browserName: string;
        browserVersion: string;
        platformName: string;
        setWindowRect: boolean;
        userAgent: string;
        proxy?: SessionProxyConfiguration;
        webSocketUrl?: string;
      };
    }

sessionEnd​

パラメータを使用してコマンドメソッド "session.end" を送信するWebDriver Bidiコマンド。

WebDriver Bidiプロトコルコマンド。詳細は公式プロトコルドキュメントで確認できます。

使用法​
browser.sessionEnd(params)
パラメータ​
名前型詳細
paramsremote.EmptyParams
{}

sessionSubscribe​

パラメータを使用してコマンドメソッド "session.subscribe" を送信するWebDriver Bidiコマンド。

WebDriver Bidiプロトコルコマンド。詳細は公式プロトコルドキュメントで確認できます。

使用法​
browser.sessionSubscribe(params)
パラメータ​
名前型詳細
paramsremote.SessionSubscriptionRequest
{
  events: string[];
  contexts?: BrowsingContextBrowsingContext[];
}

sessionUnsubscribe​

パラメータを使用してコマンドメソッド "session.unsubscribe" を送信するWebDriver Bidiコマンド。

WebDriver Bidiプロトコルコマンド。詳細は公式プロトコルドキュメントで確認できます。

使用法​
browser.sessionUnsubscribe(params)
パラメータ​
名前型詳細
paramsremote.SessionSubscriptionRequest
{
  events: string[];
  contexts?: BrowsingContextBrowsingContext[];
}

browserClose​

パラメータを使用してコマンドメソッド "browser.close" を送信するWebDriver Bidiコマンド。

WebDriver Bidiプロトコルコマンド。詳細は公式プロトコルドキュメントで確認できます。

使用法​
browser.browserClose(params)
パラメータ​
名前型詳細
paramsremote.EmptyParams
{}

browserCreateUserContext​

パラメータを使用してコマンドメソッド "browser.createUserContext" を送信するWebDriver Bidiコマンド。

WebDriver Bidiプロトコルコマンド。詳細は公式プロトコルドキュメントで確認できます。

使用法​
browser.browserCreateUserContext(params)
パラメータ​
名前型詳細
paramsremote.EmptyParams
{}
戻り値​
  • <Object> local.BrowserCreateUserContextResult: 以下のインターフェースを持つコマンド戻り値: 
    ;

browserGetUserContexts​

パラメータを使用してコマンドメソッド "browser.getUserContexts" を送信するWebDriver Bidiコマンド。

WebDriver Bidiプロトコルコマンド。詳細は公式プロトコルドキュメントで確認できます。

使用法​
browser.browserGetUserContexts(params)
パラメータ​
名前型詳細
paramsremote.EmptyParams
{}
戻り値​
  • <Object> local.BrowserGetUserContextsResult: 以下のインターフェースを持つコマンド戻り値: 
    {
      userContexts: BrowserUserContextInfo[];
    }

browserRemoveUserContext​

パラメータを使用してコマンドメソッド "browser.removeUserContext" を送信するWebDriver Bidiコマンド。

WebDriver Bidiプロトコルコマンド。詳細は公式プロトコルドキュメントで確認できます。

使用法​
browser.browserRemoveUserContext(params)
パラメータ​
名前型詳細
paramsremote.BrowserRemoveUserContextParameters
{
  userContext: BrowserUserContext;
}

browsingContextActivate​

パラメータを使用してコマンドメソッド "browsingContext.activate" を送信するWebDriver Bidiコマンド。

WebDriver Bidiプロトコルコマンド。詳細は公式プロトコルドキュメントで確認できます。

使用法​
browser.browsingContextActivate(params)
パラメータ​
名前型詳細
paramsremote.BrowsingContextActivateParameters
{
  context: BrowsingContextBrowsingContext;
}

browsingContextCaptureScreenshot​

パラメータを使用してコマンドメソッド "browsingContext.captureScreenshot" を送信するWebDriver Bidiコマンド。

WebDriver Bidiプロトコルコマンド。詳細は公式プロトコルドキュメントで確認できます。

使用法​
browser.browsingContextCaptureScreenshot(params)
パラメータ​
名前型詳細
paramsremote.BrowsingContextCaptureScreenshotParameters
{
  context: BrowsingContextBrowsingContext;
  /**
   * @default 'viewport'
   */
  origin?: "viewport" | "document";
  format?: BrowsingContextImageFormat;
  clip?: BrowsingContextClipRectangle;
}
戻り値​
  • <Object> local.BrowsingContextCaptureScreenshotResult: 以下のインターフェースを持つコマンド戻り値: 
    {
      data: string;
    }

browsingContextClose​

パラメータを使用してコマンドメソッド "browsingContext.close" を送信するWebDriver Bidiコマンド。

WebDriver Bidiプロトコルコマンド。詳細は公式プロトコルドキュメントで確認できます。

使用法​
browser.browsingContextClose(params)
パラメータ​
名前型詳細
paramsremote.BrowsingContextCloseParameters
{
  context: BrowsingContextBrowsingContext;
  promptUnload?: boolean;
}

browsingContextCreate​

パラメータを使用してコマンドメソッド "browsingContext.create" を送信するWebDriver Bidiコマンド。

WebDriver Bidiプロトコルコマンド。詳細は公式プロトコルドキュメントで確認できます。

使用法​
browser.browsingContextCreate(params)
パラメータ​
名前型詳細
paramsremote.BrowsingContextCreateParameters
{
  type: BrowsingContextCreateType;
  referenceContext?: BrowsingContextBrowsingContext;
  background?: boolean;
  userContext?: BrowserUserContext;
}
戻り値​
  • <Object> local.BrowsingContextCreateResult: 以下のインターフェースを持つコマンド戻り値: 
    {
      context: BrowsingContextBrowsingContext;
    }

browsingContextGetTree​

パラメータを使用してコマンドメソッド "browsingContext.getTree" を送信するWebDriver Bidiコマンド。

WebDriver Bidiプロトコルコマンド。詳細は公式プロトコルドキュメントで確認できます。

使用法​
browser.browsingContextGetTree(params)
パラメータ​
名前型詳細
paramsremote.BrowsingContextGetTreeParameters
{
  maxDepth?: JsUint;
  root?: BrowsingContextBrowsingContext;
}
戻り値​
  • <Object> local.BrowsingContextGetTreeResult: 以下のインターフェースを持つコマンド戻り値: 
    {
      contexts: BrowsingContextInfoList;
    }

browsingContextHandleUserPrompt​

パラメータを使用してコマンドメソッド "browsingContext.handleUserPrompt" を送信するWebDriver Bidiコマンド。

WebDriver Bidiプロトコルコマンド。詳細は公式プロトコルドキュメントで確認できます。

使用法​
browser.browsingContextHandleUserPrompt(params)
パラメータ​
名前型詳細
paramsremote.BrowsingContextHandleUserPromptParameters
{
  context: BrowsingContextBrowsingContext;
  accept?: boolean;
  userText?: string;
}

browsingContextLocateNodes​

パラメータを使用してコマンドメソッド "browsingContext.locateNodes" を送信するWebDriver Bidiコマンド。

WebDriver Bidiプロトコルコマンド。詳細は公式プロトコルドキュメントで確認できます。

使用法​
browser.browsingContextLocateNodes(params)
パラメータ​
名前型詳細
paramsremote.BrowsingContextLocateNodesParameters
{
  context: BrowsingContextBrowsingContext;
  locator: BrowsingContextLocator;
  maxNodeCount?: JsUint;
  serializationOptions?: ScriptSerializationOptions;
  startNodes?: ScriptSharedReference[];
}
戻り値​
  • <Object> local.BrowsingContextLocateNodesResult: 以下のインターフェースを持つコマンド戻り値: 
    {
      nodes: ScriptNodeRemoteValue[];
    }

browsingContextNavigate​

パラメータを使用してコマンドメソッド "browsingContext.navigate" を送信するWebDriver Bidiコマンド。

WebDriver Bidiプロトコルコマンド。詳細は公式プロトコルドキュメントで確認できます。

使用法​
browser.browsingContextNavigate(params)
パラメータ​
名前型詳細
paramsremote.BrowsingContextNavigateParameters
{
  context: BrowsingContextBrowsingContext;
  url: string;
  wait?: BrowsingContextReadinessState;
}
戻り値​
  • <Object> local.BrowsingContextNavigateResult: 以下のインターフェースを持つコマンド戻り値: 
    {
      navigation: BrowsingContextNavigation | null;
      url: string;
    }

browsingContextPrint​

パラメータを使用してコマンドメソッド "browsingContext.print" を送信するWebDriver Bidiコマンド。

WebDriver Bidiプロトコルコマンド。詳細は公式プロトコルドキュメントで確認できます。

使用法​
browser.browsingContextPrint(params)
パラメータ​
名前型詳細
paramsremote.BrowsingContextPrintParameters
{
  context: BrowsingContextBrowsingContext;
  background?: boolean;
  margin?: BrowsingContextPrintMarginParameters;
  /**
   * @default 'portrait'
   */
  orientation?: "portrait" | "landscape";
  page?: BrowsingContextPrintPageParameters;
  pageRanges?: (JsUint | string)[];
  /**
   * @default 1
   */
  scale?: number;
  /**
   * @default true
   */
  shrinkToFit?: boolean;
}
戻り値​
  • <Object> local.BrowsingContextPrintResult: 以下のインターフェースを持つコマンド戻り値: 
    {
      data: string;
    }

browsingContextReload​

パラメータを使用してコマンドメソッド "browsingContext.reload" を送信するWebDriver Bidiコマンド。

WebDriver Bidiプロトコルコマンド。詳細は公式プロトコルドキュメントで確認できます。

使用法​
browser.browsingContextReload(params)
パラメータ​
名前型詳細
paramsremote.BrowsingContextReloadParameters
{
  context: BrowsingContextBrowsingContext;
  ignoreCache?: boolean;
  wait?: BrowsingContextReadinessState;
}

browsingContextSetViewport​

パラメータを使用してコマンドメソッド "browsingContext.setViewport" を送信するWebDriver Bidiコマンド。

WebDriver Bidiプロトコルコマンド。詳細は公式プロトコルドキュメントで確認できます。

使用法​
browser.browsingContextSetViewport(params)
パラメータ​
名前型詳細
paramsremote.BrowsingContextSetViewportParameters
{
  context: BrowsingContextBrowsingContext;
  viewport?: BrowsingContextViewport | null;
  devicePixelRatio?: number | null;
}

browsingContextTraverseHistory​

パラメータを使用してコマンドメソッド "browsingContext.traverseHistory" を送信するWebDriver Bidiコマンド。

WebDriver Bidiプロトコルコマンド。詳細は公式プロトコルドキュメントで確認できます。

使用法​
browser.browsingContextTraverseHistory(params)
パラメータ​
名前型詳細
paramsremote.BrowsingContextTraverseHistoryParameters
{
  context: BrowsingContextBrowsingContext;
  delta: JsInt;
}

networkAddIntercept​

パラメータを使用してコマンドメソッド "network.addIntercept" を送信するWebDriver Bidiコマンド。

WebDriver Bidiプロトコルコマンド。詳細は公式プロトコルドキュメントで確認できます。

使用法​
browser.networkAddIntercept(params)
パラメータ​
名前型詳細
paramsremote.NetworkAddInterceptParameters
{
  phases: NetworkInterceptPhase[];
  contexts?: BrowsingContextBrowsingContext[];
  urlPatterns?: NetworkUrlPattern[];
}
戻り値​
  • <Object> local.NetworkAddInterceptResult: 以下のインターフェースを持つコマンド戻り値: 
    {
      intercept: NetworkIntercept;
    }

networkContinueRequest​

パラメータを使用してコマンドメソッド "network.continueRequest" を送信するWebDriver Bidiコマンド。

WebDriver Bidiプロトコルコマンド。詳細は公式プロトコルドキュメントで確認できます。

使用法​
browser.networkContinueRequest(params)
パラメータ​
名前型詳細
paramsremote.NetworkContinueRequestParameters
{
  request: NetworkRequest;
  body?: NetworkBytesValue;
  cookies?: NetworkCookieHeader[];
  headers?: NetworkHeader[];
  method?: string;
  url?: string;
}

networkContinueResponse​

パラメータを使用してコマンドメソッド "network.continueResponse" を送信するWebDriver Bidiコマンド。

WebDriver Bidiプロトコルコマンド。詳細は公式プロトコルドキュメントで確認できます。

使用法​
browser.networkContinueResponse(params)
パラメータ​
名前型詳細
paramsremote.NetworkContinueResponseParameters
{
  request: NetworkRequest;
  cookies?: NetworkSetCookieHeader[];
  credentials?: NetworkAuthCredentials;
  headers?: NetworkHeader[];
  reasonPhrase?: string;
  statusCode?: JsUint;
}

networkContinueWithAuth​

パラメータを使用してコマンドメソッド "network.continueWithAuth" を送信するWebDriver Bidiコマンド。

WebDriver Bidiプロトコルコマンド。詳細は公式プロトコルドキュメントで確認できます。

使用法​
browser.networkContinueWithAuth(params)
パラメータ​
名前型詳細
paramsremote.NetworkContinueWithAuthParameters
{
  request: NetworkRequest;
}

networkFailRequest​

パラメータを使用してコマンドメソッド "network.failRequest" を送信するWebDriver Bidiコマンド。

WebDriver Bidiプロトコルコマンド。詳細は公式プロトコルドキュメントで確認できます。

使用法​
browser.networkFailRequest(params)
パラメータ​
名前型詳細
paramsremote.NetworkFailRequestParameters
{
  request: NetworkRequest;
}

networkProvideResponse​

パラメータを使用してコマンドメソッド "network.provideResponse" を送信するWebDriver Bidiコマンド。

WebDriver Bidiプロトコルコマンド。詳細は公式プロトコルドキュメントで確認できます。

使用法​
browser.networkProvideResponse(params)
パラメータ​
名前型詳細
paramsremote.NetworkProvideResponseParameters
{
  request: NetworkRequest;
  body?: NetworkBytesValue;
  cookies?: NetworkSetCookieHeader[];
  headers?: NetworkHeader[];
  reasonPhrase?: string;
  statusCode?: JsUint;
}

networkRemoveIntercept​

パラメータを使用してコマンドメソッド "network.removeIntercept" を送信するWebDriver Bidiコマンド。

WebDriver Bidiプロトコルコマンド。詳細は公式プロトコルドキュメントで確認できます。

使用法​
browser.networkRemoveIntercept(params)
パラメータ​
名前型詳細
paramsremote.NetworkRemoveInterceptParameters
{
  intercept: NetworkIntercept;
}

scriptAddPreloadScript​

パラメータを使用してコマンドメソッド "script.addPreloadScript" を送信するWebDriver Bidiコマンド。

WebDriver Bidiプロトコルコマンド。詳細は公式プロトコルドキュメントで確認できます。

使用法​
browser.scriptAddPreloadScript(params)
パラメータ​
名前型詳細
paramsremote.ScriptAddPreloadScriptParameters
{
  functionDeclaration: string;
  arguments?: ScriptChannelValue[];
  contexts?: BrowsingContextBrowsingContext[];
  sandbox?: string;
}
戻り値​
  • <Object> local.ScriptAddPreloadScriptResult: 以下のインターフェースを持つコマンド戻り値: 
    {
      script: ScriptPreloadScript;
    }

scriptDisown​

パラメータを使用してコマンドメソッド "script.disown" を送信するWebDriver Bidiコマンド。

WebDriver Bidiプロトコルコマンド。詳細は公式プロトコルドキュメントで確認できます。

使用法​
browser.scriptDisown(params)
パラメータ​
名前型詳細
paramsremote.ScriptDisownParameters
{
  handles: ScriptHandle[];
  target: ScriptTarget;
}

scriptCallFunction​

パラメータを使用してコマンドメソッド "script.callFunction" を送信するWebDriver Bidiコマンド。

WebDriver Bidiプロトコルコマンド。詳細は公式プロトコルドキュメントで確認できます。

使用法​
browser.scriptCallFunction(params)
パラメータ​
名前型詳細
paramsremote.ScriptCallFunctionParameters
{
  functionDeclaration: string;
  awaitPromise: boolean;
  target: ScriptTarget;
  arguments?: ScriptLocalValue[];
  resultOwnership?: ScriptResultOwnership;
  serializationOptions?: ScriptSerializationOptions;
  this?: ScriptLocalValue;
  userActivation?: boolean;
}

scriptEvaluate​

パラメータを使用してコマンドメソッド "script.evaluate" を送信するWebDriver Bidiコマンド。

WebDriver Bidiプロトコルコマンド。詳細は公式プロトコルドキュメントで確認できます。

使用法​
browser.scriptEvaluate(params)
パラメータ​
名前型詳細
paramsremote.ScriptEvaluateParameters
{
  expression: string;
  target: ScriptTarget;
  awaitPromise: boolean;
  resultOwnership?: ScriptResultOwnership;
  serializationOptions?: ScriptSerializationOptions;
  userActivation?: boolean;
}
戻り値​
  • <Object> local.ScriptEvaluateResult: 以下のインターフェースを持つコマンド戻り値: 
    ;

scriptGetRealms​

パラメータを使用してコマンドメソッド "script.getRealms" を送信するWebDriver Bidiコマンド。

WebDriver Bidiプロトコルコマンド。詳細は公式プロトコルドキュメントで確認できます。

使用法​
browser.scriptGetRealms(params)
パラメータ​
名前型詳細
paramsremote.ScriptGetRealmsParameters
{
  context?: BrowsingContextBrowsingContext;
  type?: ScriptRealmType;
}
戻り値​
  • <Object> local.ScriptGetRealmsResult: 以下のインターフェースを持つコマンド戻り値: 
    {
      realms: ScriptRealmInfo[];
    }

scriptRemovePreloadScript​

パラメータを使用してコマンドメソッド "script.removePreloadScript" を送信するWebDriver Bidiコマンド。

WebDriver Bidiプロトコルコマンド。詳細は公式プロトコルドキュメントで確認できます。

使用法​
browser.scriptRemovePreloadScript(params)
パラメータ​
名前型詳細
paramsremote.ScriptRemovePreloadScriptParameters
{
  script: ScriptPreloadScript;
}

storageGetCookies​

パラメータを使用してコマンドメソッド "storage.getCookies" を送信するWebDriver Bidiコマンド。

WebDriver Bidiプロトコルコマンド。詳細は公式プロトコルドキュメントで確認できます。

使用法​
browser.storageGetCookies(params)
パラメータ​
名前型詳細
paramsremote.StorageGetCookiesParameters
{
  filter?: StorageCookieFilter;
  partition?: StoragePartitionDescriptor;
}
戻り値​
  • <Object> local.StorageGetCookiesResult: 以下のインターフェースを持つコマンド戻り値: 
    {
      cookies: NetworkCookie[];
      partitionKey: StoragePartitionKey;
    }

storageSetCookie​

パラメータを使用してコマンドメソッド "storage.setCookie" を送信するWebDriver Bidiコマンド。

WebDriver Bidiプロトコルコマンド。詳細は公式プロトコルドキュメントで確認できます。

使用法​
browser.storageSetCookie(params)
パラメータ​
名前型詳細
paramsremote.StorageSetCookieParameters
{
  cookie: StoragePartialCookie;
  partition?: StoragePartitionDescriptor;
}
戻り値​
  • <Object> local.StorageSetCookieResult: 以下のインターフェースを持つコマンド戻り値: 
    {
      partitionKey: StoragePartitionKey;
    }

storageDeleteCookies​

パラメータを使用してコマンドメソッド "storage.deleteCookies" を送信するWebDriver Bidiコマンド。

WebDriver Bidiプロトコルコマンド。詳細は公式プロトコルドキュメントで確認できます。

使用法​
browser.storageDeleteCookies(params)
パラメータ​
名前型詳細
paramsremote.StorageDeleteCookiesParameters
{
  filter?: StorageCookieFilter;
  partition?: StoragePartitionDescriptor;
}
戻り値​
  • <Object> local.StorageDeleteCookiesResult: 以下のインターフェースを持つコマンド戻り値: 
    {
      partitionKey: StoragePartitionKey;
    }

inputPerformActions​

パラメータを使用してコマンドメソッド "input.performActions" を送信するWebDriver Bidiコマンド。

WebDriver Bidiプロトコルコマンド。詳細は公式プロトコルドキュメントで確認できます。

使用法​
browser.inputPerformActions(params)
パラメータ​
名前型詳細
paramsremote.InputPerformActionsParameters
{
  context: BrowsingContextBrowsingContext;
  actions: InputSourceActions[];
}

inputReleaseActions​

パラメータを使用してコマンドメソッド "input.releaseActions" を送信するWebDriver Bidiコマンド。

WebDriver Bidiプロトコルコマンド。詳細は公式プロトコルドキュメントで確認できます。

使用法​
browser.inputReleaseActions(params)
パラメータ​
名前型詳細
paramsremote.InputReleaseActionsParameters
{
  context: BrowsingContextBrowsingContext;
}

inputSetFiles​

パラメータを使用してコマンドメソッド "input.setFiles" を送信するWebDriver Bidiコマンド。

WebDriver Bidiプロトコルコマンド。詳細は公式プロトコルドキュメントで確認できます。

使用法​
browser.inputSetFiles(params)
パラメータ​
名前型詳細
paramsremote.InputSetFilesParameters
{
  context: BrowsingContextBrowsingContext;
  element: ScriptSharedReference;
  files: string[];
}

Welcome! How can I help?

WebdriverIO AI Copilot