【Excel VBA×Selenium】NoSuchElementエラーの原因と対処法｜要素が見つからない場合

みなさんこんにちは。

Excel VBAとSeleniumを使ってWebページを操作していると、XPathやCSSセレクターを指定しているのにNoSuchElementErrorが発生することがあります。

このエラーは、指定した要素をSeleniumが現在のページから見つけられないときに発生します。原因はセレクターの間違いだけではなく、読み込み待ちやiframeなどいくつか考えられます。

今回は、NoSuchElementエラーが発生したときに確認したいポイントを順番にご紹介したいと思います。

この記事はこんな人におすすめ

FindElementByXPathで要素を取得できない人
NoSuchElementErrorの原因を切り分けたい人
動的に表示される要素やiframe内の要素を操作したい人

NoSuchElementエラーが発生する例

例えば、ページ内に存在しないidを指定して要素を取得するとエラーになります。

Dim target As Selenium.WebElement

'存在しない要素を取得しようとするとエラーになる
Set target = driver.FindElementByXPath( _
    "//button[@id='btnLogin']" _
)

Excel VBA×SeleniumでNoSuchElementErrorが発生した画面

まずセレクターが正しいか確認する

最初にChromeのデベロッパーツールで対象要素を確認し、XPathやCSSセレクターが現在のHTMLと一致しているか確認します。idやclassが画面表示のたびに変わるサイトもあるため注意してください。

idが動的に変わる場合は、固定部分を使ったXPathも検討できます。

Set target = driver.FindElementByXPath( _
    "//button[contains(@id,'btnLogin')]" _
)

【Excel VBA×Selenium】XPathのcontainsで部分一致する要素を取得・クリックする方法

ページの読み込みを待ってから取得する

セレクターが正しくても、JavaScriptで後から表示される要素では、取得処理の方が先に実行されることがあります。SeleniumBasicではtimeoutを指定して一定時間待つことができます。

Dim target As Selenium.WebElement

'========================================
' 最大10秒間、対象要素が見つかるまで待つ
' raise=Falseで未取得時のエラーを抑える
'========================================
Set target = driver.FindElementByXPath( _
    "//button[@id='btnLogin']", _
    timeout:=10000, _
    raise:=False _
)

If target Is Nothing Then
    MsgBox "対象要素を取得できませんでした。"
    Exit Sub
End If

target.Click

Excel VBA×Seleniumで読み込みを待って対象要素を正常に取得した画面

iframe内の要素か確認する

デベロッパーツールでは要素が見えているのに取得できない場合は、対象要素がiframe内にないか確認します。iframe内の場合は、先に操作対象を切り替える必要があります。

'iframeへ操作対象を切り替える
driver.SwitchToFrame "sampleFrame"

'iframe内の要素を取得する
Set target = driver.FindElementById("btnLogin")

【Excel VBA×Selenium】iframe内の要素を取得・クリックする方法｜SwitchToFrame

画面更新後は要素を再取得する

検索や画面遷移によってHTMLが更新された場合は、更新後のページを対象にもう一度FindElementを実行します。操作する直前に現在のDOMから取得するようにすると、動的なページでも処理を整理しやすくなります。

'検索処理を実行する
driver.FindElementById("btnSearch").Click

'画面更新後の要素を改めて取得する
Set target = driver.FindElementByXPath( _
    "//button[@id='btnLogin']", _
    timeout:=10000, _
    raise:=False _
)