エミュレート

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

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

View on GitHub

example.js

loading...

View on GitHub

戻り値

• <Function> returns: エミュレーションをリセットするための関数