スマートロケーターと DOM 選択

要素ピンは、安定したセレクター、DOM パス、タグ、id、name、テスト id、role、クラス、テキスト、ラベル、幾何を組み合わせます。再開時、Pinar は1つの壊れやすいパスを信じるのではなく、セレクター、構造、意味、幾何を評価します。

一致は exact、probable、ambiguous、unresolved のいずれかです。2つの候補が似すぎている場合、Pinar は誤った要素へスナップせず代替を残します。クロスオリジンの iframe 対象は unresolved のままになることがあります。

キャプチャ時、Pinar は id、data-testid または data-test、あるいは tag と name でノードに一意に一致するセレクターを優先します。どれも一意でなければ、構造的な CSS パスを代わりに保存します。生成されたように見えるクラス名はフィンガープリントから落とされ、ハッシュ化された CSS モジュールだけが手がかりにならないようにします。

再開時、stable-selector、structure、semantic、geometry の戦略からの候補が統合され、順位付けされます。exact の信頼度には、高得点の安定セレクターまたは構造ヒットが必要です。semantic と geometry の一致は probable のままです。上位2つの有効スコア差が狭い場合、結果は ambiguous になり、要素は選ばれません。

• 同じ tag、テキスト、クラスを共有する他ノードがあるとき、位置指定の :nth-of-type セレクターは低い点数になります。
• 領域ピンは要素対象として却下され、ロケーター採点中は unresolved のままです。
• iframe の contentDocument が読めない場合、推測せず cross-origin-frame 警告で再配置を止めます。