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

エミュレーション

WebdriverIOでは、emulateコマンドを使用してWeb APIをエミュレートし、特定のブラウザの動作をエミュレートするためのカスタム値を返すことができます。これにはアプリケーションが明示的にこれらのAPIを使用する必要があることに注意してください。

情報

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

テストでWebDriver Bidiを有効にするには、capabilities内にwebSocketUrl: trueが設定されていることを確認してください。

位置情報​

ブラウザの位置情報を特定の地域に変更することができます：

await browser.emulate('geolocation', {
    latitude: 52.52,
    longitude: 13.39,
    accuracy: 100
})
await browser.url('https://www.google.com/maps')
await browser.$('aria/Show Your Location').click()
await browser.pause(5000)
console.log(await browser.getUrl()) // 出力: "https://www.google.com/maps/@52.52,13.39,16z?entry=ttu"

これによりnavigator.geolocation.getCurrentPositionの動作がモンキーパッチされ、あなたが提供した位置情報が返されます。

カラースキーム​

ブラウザのデフォルトカラースキーム設定を以下のように変更できます：

await browser.emulate('colorScheme', 'light')
await browser.url('https://webdriver.io')
const backgroundColor = await browser.$('nav').getCSSProperty('background-color')
console.log(backgroundColor.parsed.hex) // 出力: "#efefef"

await browser.emulate('colorScheme', 'dark')
await browser.url('https://webdriver.io')
const backgroundColor = await browser.$('nav').getCSSProperty('background-color')
console.log(backgroundColor.parsed.hex) // 出力: "#000000"

これにより、(prefers-color-scheme: dark)でカラースキームを照会するときのwindow.matchMediaの動作がモンキーパッチされます。

ユーザーエージェント​

ブラウザのユーザーエージェントを別の文字列に変更できます：

await browser.emulate('userAgent', 'Chrome/1.2.3.4 Safari/537.36')

これによりnavigator.userAgentの値が変更されます。ブラウザベンダーは徐々にユーザーエージェントを非推奨にしていることに注意してください。

onLineプロパティ​

ブラウザのオンラインステータスを以下のように変更できます：

await browser.emulate('onLine', false)

これはブラウザとインターネット間のネットワークトラフィックをオフにするわけではなく、navigator.onLineの戻り値だけを変更します。ブラウザのネットワーク機能を変更することに興味がある場合は、throttleNetworkコマンドを確認してください。

クロック​

emulateコマンドを使用してブラウザのシステムクロックを変更できます。これにより時間に関連するネイティブのグローバル関数が上書きされ、clock.tick()または生成されたクロックオブジェクトを介して同期的に制御できるようになります。これには以下の制御が含まれます：

  • setTimeout
  • clearTimeout
  • setInterval
  • clearInterval
  • Date Objects

クロックはUNIXエポック（タイムスタンプ0）から開始します。つまり、emulateコマンドに他のオプションを渡さない場合、アプリケーションで新しいDateをインスタンス化すると、1970年1月1日の時間になります。

例​

browser.emulate('clock', { ... })を呼び出すと、現在のページと以降のすべてのページのグローバル関数が即座に上書きされます：

const clock = await browser.emulate('clock', { now: new Date(1989, 7, 4) })

console.log(await browser.execute(() => (new Date()).toString()))
// 返り値: "Fri Aug 04 1989 00:00:00 GMT-0700 (Pacific Daylight Time)"

await browser.url('https://webdriverio')
console.log(await browser.execute(() => (new Date()).toString()))
// 返り値: "Fri Aug 04 1989 00:00:00 GMT-0700 (Pacific Daylight Time)"

await clock.restore()

console.log(await browser.execute(() => (new Date()).toString()))
// 返り値: "Thu Aug 01 2024 17:59:59 GMT-0700 (Pacific Daylight Time)"

await browser.url('https://guinea-pig.webdriver.io/pointer.html')
console.log(await browser.execute(() => (new Date()).toString()))
// 返り値: "Thu Aug 01 2024 17:59:59 GMT-0700 (Pacific Daylight Time)"

setSystemTimeまたはtickを呼び出すことでシステム時間を変更できます。

FakeTimerInstallOptsオブジェクトは以下のプロパティを持つことができます：

interface FakeTimerInstallOpts {
    // 指定されたUNIXエポックで偽のタイマーをインストールします
    // @default: 0
    now?: number | Date | undefined;

    // 偽装するグローバルメソッドとAPIの名前の配列。デフォルトでは、WebdriverIO
    // は`nextTick()`と`queueMicrotask()`を置き換えません。例えば、
    // `browser.emulate('clock', { toFake: ['setTimeout', 'nextTick'] })`は
    // `setTimeout()`と`nextTick()`のみを偽装します
    toFake?: FakeMethod[] | undefined;

    // runAll()を呼び出すときに実行されるタイマーの最大数（デフォルト：1000）
    loopLimit?: number | undefined;

    // 実際のシステム時間のシフトに基づいてモックされた時間を自動的に増加させるよう
    // WebdriverIOに指示します（例：実際のシステム時間が20ms変化するごとに、
    // モックされた時間も20ms増加します）
    // @default false
    shouldAdvanceTime?: boolean | undefined;

    // shouldAdvanceTime: trueを使用する場合にのみ関連します。実際のシステム時間で
    // advanceTimeDelta msの変化が発生するたびに、モックされた時間を
    // advanceTimeDelta ms増加させます
    // @default: 20
    advanceTimeDelta?: number | undefined;

    // それぞれのハンドラーに委譲することで、「ネイティブ」（つまり偽ではない）タイマーを
    // クリアするようFakeTimersに指示します。これらはデフォルトではクリアされないため、
    // FakeTimersをインストールする前にタイマーが存在していた場合、予期しない動作を
    // 引き起こす可能性があります。
    // @default: false
    shouldClearNativeTimers?: boolean | undefined;
}

デバイス​

emulateコマンドは、ビューポート、デバイススケールファクター、ユーザーエージェントを変更することで、特定のモバイルまたはデスクトップデバイスのエミュレーションもサポートしています。これはデスクトップブラウザエンジンがモバイルと異なるため、モバイルテスト用に使用すべきではありません。これは、アプリケーションが小さいビューポートサイズに対して特定の動作を提供する場合にのみ使用すべきです。

例えば、ユーザーエージェントとビューポートをiPhone 15に切り替えるには、以下を実行します：

const restore = await browser.emulate('device', 'iPhone 15')
// アプリケーションをテスト...

// 元のビューポートとユーザーエージェントにリセット
await restore()

WebdriverIOは定義されたすべてのデバイスの固定リストを維持しています。

Welcome! How can I help?

WebdriverIO AI Copilot