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 } |
userAgent | string |
colorScheme | 'light' | 'dark' |
onLine | boolean |
clock | FakeTimerInstallOpts |
使用方法
browser.emulate(scope, options)
パラメータ
名前 | 型 | 詳細 |
---|---|---|
scope | string | エミュレートするブラウザの機能。`clock`、`geolocation`、`userAgent`、`colorScheme`、または`onLine`のいずれかです。 |
options | EmulationOptions | 特定のスコープのエミュレーションオプション |
例
example.js
loading...
example.js
loading...