Playwright で「strict mode violation: locator(“input[name=…]”) resolved to 2 elements」。同じ name の hidden と checkbox が重なっていたので id で指定して直した

結論

同じ name を持つ type="hidden" の input と、本物のチェックボックスが2つ並んでいたのが原因でした。name ではなく id(#user_public_email)で指定したら is_checked() が通りました。

設定画面のチェックボックスの状態を Playwright で読もうとしたところ、セレクターは合っているはずなのに strict mode のエラーで止まりました。

症状

page.locator('input[name="user[public_email]"]').is_checked() を呼ぶと、次のエラーで落ちます。

playwright._impl._errors.Error: Locator.is_checked: Error: strict mode violation: locator("input[name=\"user[public_email]\"]") resolved to 2 elements:
    1) <input value="0" type="hidden" autocomplete="off" name="user[public_email]"/> aka locator("input[name=\"user[public_email]\"]").first
    2) <input value="1" type="checkbox" id="user_public_email" name="user[public_email]"/> aka get_by_role("checkbox", name="公開メールアドレス メールアドレスを全体に公開する")

Call log:
  - waiting for locator("input[name=\"user[public_email]\"]")

同じスクリプトの中で、テキスト欄(user[first_name] など)は name の指定で問題なく読めていました。止まるのはチェックボックスだけです。

環境

  • Windows
  • Python 3.13(Microsoft Store 版)
  • Playwright(sync API)。起動済みの Chromium に connect_over_cdp でつないで操作
  • 対象: Web サービスのプロフィール設定画面のフォーム

原因

エラー文にそのまま出ている通り、input[name="user[public_email]"] に当たる要素が2つありました。

# type value id
1 hidden 0 なし
2 checkbox 1 user_public_email

チェックボックスは、チェックを外すとフォームの送信に値が乗りません。そのため「外した」ことを送るための hidden の input を、同じ name で前に置いておく作りのフォームがあります。今回の画面もそれでした。

Playwright の locator は strict(1つに決まらないと操作しない)なので、2つに当たった時点で is_checked() はエラーになります。テキスト欄にはこの hidden が無いので、name で通っていたわけです。

解決手順

  1. エラー文の 2) の行を見て、チェックボックス側にだけある属性を探します。今回は id="user_public_email" がありました。
  2. セレクターを name から id に替えます。
# 変更前(hidden と checkbox の2つに当たる)
page.locator('input[name="user[public_email]"]').is_checked()

# 変更後(checkbox だけに当たる)
page.locator('#user_public_email').is_checked()
  1. スクリプトの中で同じセレクターを何か所も使っていたので、まとめて置き換えました(Git Bash の sed)。
sed -i 's#input\[name="user\[public_email\]"\]#\#user_public_email#g' qprofile_set.py
grep -c "user_public_email" qprofile_set.py

置き換えて再実行すると、エラーは出ずにチェックボックスの状態(今回はオフ=False)が読めました。テキスト欄の確認もそのまま通っています。

再発防止・気づき

  • strict mode violation のエラー文には、当たった要素の HTML が全部並びます。まずここで type を見ると、hidden が混ざっているかがすぐ分かります。
  • チェックボックスやラジオボタンを name で掴むと、この hidden に当たることがあります。id があれば id で掴む方が確実です。
  • エラー文には get_by_role("checkbox", name="…") という書き方の候補も出ていました。今回は id で直したので、こちらは試していません。
  • .first で逃げると hidden の方(1番目)を掴んでしまうので、この形のフォームでは使えません。

この記事を書いた人

realine

Windows の PC で、MT5(MQL5)の EA・インジケーターの開発、WordPress のプラグイン開発とサイト運営、PowerShell・Python での作業の自動化をしています。このサイトには、その作業で実際につまずいたことと、効いた直し方を、確かめた環境と手順つきで残しています。

運営者情報と記事の作り方