C#とSelenium WebDriver：要素が存在するまで待機する方法

Selenium WebDriverでは、明示的待機（Explicit Wait）を使用することで、ページ上に要素が存在するまで待機することができます。これは、ページの読み込み速度やJavaScriptの実行タイミングなどにより、要素がすぐに利用可能にならない同期の問題が発生しうる場面で特に役立ちます。

明示的待機の実装には、WebDriverWaitクラスとExpectedConditionsクラスを使用します。WebDriverWaitオブジェクトを作成し、そのUntilメソッドを通じてExpectedConditionsクラスの期待条件を呼び出します。

WebDriverは、指定された時間の間、期待される条件が満たされるのを待ち続けます。制限時間を過ぎても条件が満たされなかった場合は、例外がスローされます。要素が存在するまで待機したい場合は、期待条件としてElementExistsを使用します。

なお、ElementExistsは要素がDOM上に存在していることのみを確認する条件です。要素が画面上に表示されていることまで確認したい場合は、ElementIsVisibleを使用するとよいでしょう。

構文

WebDriverWait w = new WebDriverWait(driver, TimeSpan.FromSeconds(20));
w.Until(ExpectedConditions.ElementExists(By.TagName("h1")));

この例では、最大20秒間、h1タグの要素がDOM上に存在するようになるのを待機します。

実装例

ここでは、Tutorials Pointのキャリア紹介ページにアクセスし、「About Careers at Tutorials Point」というテキストを持つ見出し（h1）が表示されるまで待機してから、そのテキストを取得してみましょう。

using NUnit.Framework;
using OpenQA.Selenium;
using OpenQA.Selenium.Firefox;
using System;
using OpenQA.Selenium;
using OpenQA.Selenium.Support.UI;

namespace NUnitTestProject2{
    public class Tests{
        String url ="https://www.tutorialspoint.com/about/about_careers.htm";
        IWebDriver driver;
        [SetUp]
        public void Setup(){
            // FirefoxDriverオブジェクトの作成
            driver = new FirefoxDriver("");
        }
        [Test]
        public void Test2(){
            // URLを起動
            driver.Navigate().GoToUrl(url);
            // 要素を特定してクリック
            IWebElement l = driver.FindElement(By.XPath("//*[text()='Careers']"));
            l.Click();
            // ElementExistsの期待条件を設定
            WebDriverWait w = new WebDriverWait(driver, TimeSpan.FromSeconds(20));
            w.Until(ExpectedConditions.ElementExists(By.TagName("h1")));
            // 要素を特定してテキストを取得
            IWebElement m = driver.FindElement(By.TagName("h1"));
            Console.WriteLine("Element text is: " + m.Text);
        }
        [TearDown]
        public void close_Browser(){
            driver.Quit();
        }
    }
}

コードのポイント

• [SetUp]：各テストの前に実行され、FirefoxDriverのインスタンスを生成します。
• [Test]：ページへ移動し、「Careers」リンクをクリックした後、h1要素が存在するまで最大20秒待機します。
• [TearDown]：テスト終了後にブラウザを閉じ、リソースを解放します。

実行結果

このコードを実行すると、テスト対象ページのh1要素がDOM上に現れるまで待機した後、以下のように要素のテキストがコンソールに出力されます。

Element text is: About Careers at Tutorials Point

このように明示的待機を活用することで、固定時間のスリープ処理に頼らず、要素の準備が整ったタイミングで確実に操作を行えるため、テストの安定性と実行速度の両方を向上させることができます。