本文へスキップ

emulate

WebdriverIOでは、`emulate`コマンドを使用してWeb APIをエミュレートできます。これらのWeb APIは、指定したとおりに動作します。サポートされているスコープは以下のとおりです。

  • `geolocation`:Geolocation APIをエミュレートします。
  • `userAgent`:ユーザーエージェントをエミュレートします。
  • `colorScheme`:カラースキームをエミュレートします。
  • `onLine`:オンラインステータスをエミュレートします。
  • `device`:特定のモバイルまたはデスクトップデバイスをエミュレートします。
  • `clock`:システムクロックをエミュレートします。

`emulate`コマンドは、エミュレーションをリセットするために呼び出すことができる関数を返します。これは、テストまたはテストスイートの後でエミュレーションをリセットする場合に役立ちます。

詳細については、エミュレーションガイドラインをご覧ください。

情報

`clock`スコープを除き、ページを再読み込みせずにエミュレートされた値を変更することはできません。

情報

この機能には、ブラウザのWebDriver Bidiサポートが必要です。Chrome、Edge、Firefoxの最近のバージョンはこれをサポートしていますが、Safariは**サポートしていません**。最新情報については、wpt.fyiをご覧ください。さらに、ブラウザの起動にクラウドベンダーを使用している場合は、ベンダーもWebDriver Bidiをサポートしていることを確認してください。

`EmulationOptions`オブジェクトは、スコープに基づいて次のプロパティを持つことができます。

スコープオプション
geolocation{ latitude: number, longitude: number }
userAgentstring
colorScheme'light' | 'dark'
onLineboolean
clockFakeTimerInstallOpts
使用方法
browser.emulate(scope, options)
パラメータ
名前詳細
scopestringエミュレートするブラウザの機能。`clock`、`geolocation`、`userAgent`、`colorScheme`、または`onLine`のいずれかです。
optionsEmulationOptions特定のスコープのエミュレーションオプション
example.js
loading...
example.js
loading...

ようこそ!お手伝いしましょうか?

WebdriverIO AI Copilot