Module: Capybara::Lightpanda::Browser::Finder

Included in:
Capybara::Lightpanda::Browser
Defined in:
lib/capybara/lightpanda/browser/finder.rb

Overview

Element finding in the three dispatch contexts (document, node- scoped, iframe) plus the shared XPath/CSS find fragments and InvalidSelector translation.

Instance Method Summary collapse

Instance Method Details

#find(method, selector) ⇒ Object

Find elements in the current context (top frame or active frame). Returns an array of remote object ID strings.



12
13
14
15
16
17
18
 
# File 'lib/capybara/lightpanda/browser/finder.rb', line 12

def find(method, selector)
  if @frame_stack.empty?
    find_in_document(method, selector)
  else
    find_in_frame(method, selector)
  end
end

#find_within(remote_object_id, method, selector) ⇒ Object

Find child elements within a specific node. Returns an array of remote object ID strings.

Wrapped in with_default_context_wait so a click that triggered a navigation immediately before the find (e.g. a fill_in following a link that mutated the DOM) doesn't race against Runtime.executionContextCreated and surface as NoExecutionContextError. find_in_document and find_in_frame already use the same wrapper; find_within was the odd one out.



29
30
31
32
33
34
35
36
 
# File 'lib/capybara/lightpanda/browser/finder.rb', line 29

def find_within(remote_object_id, method, selector)
  with_default_context_wait do
    result = call_function_on(remote_object_id, FIND_WITHIN_JS, method, selector, return_by_value: false)
    extract_node_object_ids(result)
  end
rescue JavaScriptError => e
  raise_invalid_selector(e, method, selector)
end

#parents_of(remote_object_id) ⇒ Object

Ancestor chain of remote_object_id from parentNode up to (but excluding) document, returned as an array of remote object IDs. Mirrors Cuprite's JS parents helper. Same with_default_context_wait wrapping as find_within — same race window applies.



42
43
44
45
46
47
 
# File 'lib/capybara/lightpanda/browser/finder.rb', line 42

def parents_of(remote_object_id)
  with_default_context_wait do
    result = call_function_on(remote_object_id, PARENTS_JS, return_by_value: false)
    extract_node_object_ids(result)
  end
end