Module: Avo::TestHelpers

Includes:
WaitForLoaded
Included in:
PrefixedTestHelpers
Defined in:
lib/avo/test_helpers.rb

Instance Method Summary collapse

Methods included from WaitForLoaded

#wait_for_action_dialog_to_disappear, #wait_for_body_class_missing, #wait_for_element_missing, #wait_for_element_present, #wait_for_loaded, #wait_for_path_to_be, #wait_for_route_loaded, #wait_for_route_loading, #wait_for_search_loaded, #wait_for_search_to_dissapear, #wait_for_tag_suggestions_to_appear, #wait_for_tag_to_appear, #wait_for_tag_to_disappear, #wait_for_turbo_frame_id, #wait_for_turbo_frame_src, #wait_for_turbo_loaded

Instance Method Details

#accept_custom_alert(&block) ⇒ Object 



325
326
327
328
 
# File 'lib/avo/test_helpers.rb', line 325

def accept_custom_alert(&block)
  block.call
  find('#turbo-confirm button[value="confirm"]').click
end

#add_tag(field:, tag:) ⇒ Object

Example usage:

expect(add_tag(field: :tags, tag: "one")).to eq ["one"]
add_tag(field: :tags, tag: "two")



258
259
260
261
262
263
264
265
266
267
268
 
# File 'lib/avo/test_helpers.rb', line 258

def add_tag(field:, tag:)
  # Find the input field for the specified field and click it
  find("[data-field-id='#{field}'] [data-slot='value'] [role='textbox']").click

  # Enter the specified tag into the input field
  type tag, :return
  wait_for_tag_to_appear(tag)

  # Return an array of the current tags
  tags(field: field)
end

#check_select_all ⇒ Object 



247
248
249
 
# File 'lib/avo/test_helpers.rb', line 247

def check_select_all
  find("input[type='checkbox'][name='Select all'][data-action='input->item-select-all#toggle']").set(true)
end

#click_global_search_input ⇒ Object 



108
109
110
111
 
# File 'lib/avo/test_helpers.rb', line 108

def click_global_search_input
  page.find(:xpath, "//*[contains(@class, 'global-search')]").click
  wait_for_search_loaded
end

#click_on_sidebar_item(label) ⇒ Object 



184
185
186
187
188
 
# File 'lib/avo/test_helpers.rb', line 184

def click_on_sidebar_item(label)
  within main_sidebar do
    click_on label
  end
end

#click_resource_search_input ⇒ Object

Example usage:

click_resource_search_input # opens the first search box on the given page
opens the search box for the "users" resource
within(has_and_belongs_to_many_field_wrapper(id: :users)) {
  click_resource_search_input
  write_in_search("Bob")
}



103
104
105
106
 
# File 'lib/avo/test_helpers.rb', line 103

def click_resource_search_input
  first("[data-search-resource]:not([data-search-resource='global'])").click
  wait_for_search_loaded
end

#click_tab(tab_name = "", within_target: nil, **args) ⇒ Object 



153
154
155
156
157
158
159
160
161
162
163
164
165
166
 
# File 'lib/avo/test_helpers.rb', line 153

def click_tab(tab_name = "", within_target: nil, **args)
  if within_target.present?
    within within_target do
      within find('[data-controller="tabs"] [data-tabs-target="tabSwitcher"]') do
        find_link(tab_name).trigger("click")
      end
    end
  else
    within find('[data-controller="tabs"] [data-tabs-target="tabSwitcher"]') do
      find_link(tab_name).trigger("click")
    end
  end
  wait_for_loaded
end

#close_picker ⇒ Object 



211
212
213
214
 
# File 'lib/avo/test_helpers.rb', line 211

def close_picker
  find('[data-target="title"]').trigger("click")
  sleep 0.3
end

#empty_dash ⇒ Object 



92
93
94
 
# File 'lib/avo/test_helpers.rb', line 92

def empty_dash
  "—"
end

#first_tab_group ⇒ Object 



172
173
174
 
# File 'lib/avo/test_helpers.rb', line 172

def first_tab_group
  tab_group 0
end

#grid_field_wrapper(record_id:) ⇒ Object

Finds the wrapper element on the index grid view type for the given record id Example usage:

grid_field_wrapper(record_id: 5)



22
23
24
 
# File 'lib/avo/test_helpers.rb', line 22

def grid_field_wrapper(record_id:)
  find("[data-component-name='avo/index/grid_item_component'][data-resource-id='#{record_id}']")
end

#has_and_belongs_to_many_field_wrapper(id:, view: :show) ⇒ Object

Finds the table on the show view for the given has_and_belongs_to_many field id and view Example usage:

has_and_belongs_to_many_field_wrapper(id: :users)
has_and_belongs_to_many_field_wrapper(id: :users, view: :edit)



52
53
54
 
# File 'lib/avo/test_helpers.rb', line 52

def has_and_belongs_to_many_field_wrapper(id:, view: :show)
  related_field_context(id: id, relation: :has_and_belongs_to_many, view: view)
end

#has_many_field_wrapper(id:, view: :show) ⇒ Object

Finds the table on the show view for the given has_many field id and view Example usage:

has_many_field_wrapper(id: :users)
has_many_field_wrapper(id: :users, view: :edit)



44
45
46
 
# File 'lib/avo/test_helpers.rb', line 44

def has_many_field_wrapper(id:, view: :show)
  related_field_context(id: id, relation: :has_many, view: view)
end

#has_one_field_wrapper(id:, view: :show) ⇒ Object

Finds the table on the show view for the given has_one field id and view Example usage:

has_one_field_wrapper(id: :users)
has_one_field_wrapper(id: :users, view: :edit)



60
61
62
 
# File 'lib/avo/test_helpers.rb', line 60

def has_one_field_wrapper(id:, view: :show)
  related_field_context(id: id, relation: :has_one, view: view)
end

#index_field_label(id:) ⇒ Object

Finds the label element on the index view for the given field id Example usage:

index_field_label(id: "name")



67
68
69
 
# File 'lib/avo/test_helpers.rb', line 67

def index_field_label(id:)
  find("[data-component-name='avo/partials/table_header'] [data-table-header-field-id='#{id}']").text
end

#index_field_value(id:, record_id:, type: nil) ⇒ Object

Finds the value element on the index view for the given field id Example usage:

index_field_value(id: "name", record_id: 2)



81
82
83
 
# File 'lib/avo/test_helpers.rb', line 81

def index_field_value(id:, record_id:, type: nil)
  index_field_wrapper(id: id, record_id: record_id, type: type).text
end

#index_field_wrapper(id:, record_id:, type: nil) ⇒ Object

Finds the wrapper element on the index view for the given field id and type, and associated with the given record id Example usage:

index_field_wrapper(id: "name", type: "text", record_id: 2)
index_field_wrapper(id: "name", record_id: 2)



9
10
11
12
13
14
15
16
17
 
# File 'lib/avo/test_helpers.rb', line 9

def index_field_wrapper(id:, record_id:, type: nil)
  base_data = "#{row(record_id)} [data-field-id='#{id}']"

  if type.present?
    find("#{base_data}[data-resource-index-target='#{wrapper_name_for(id: id, type: type)}']")
  else
    find(base_data)
  end
end

#open_panel_action(action_name:, list: "Actions") ⇒ Object

Click on the action from the panel (index and show above the table) Pass list: nil to run an action outside of the list Pass list: “List name” if list is not the default “Actions” Example usage:

open_panel_action(action_name: "Dummy action")
open_panel_action(list: nil, action_name: "Release fish")
open_panel_action(list: "Runnables", action_name: "Release fish")



223
224
225
 
# File 'lib/avo/test_helpers.rb', line 223

def open_panel_action(action_name:, list: "Actions")
  open_action(action_name: action_name, list: list, context: first("[data-target='panel-tools']"))
end

#open_picker ⇒ Object 



207
208
209
 
# File 'lib/avo/test_helpers.rb', line 207

def open_picker
  text_input.click
end

#open_row_action(record_id:, action_name:, list: "Actions") ⇒ Object

Open the action from the record_id row Pass list: nil to run an action outside of the list Pass list: “List name” if list is not the default “Actions” Example usage:

open_row_action(action_name: "Dummy action")
open_row_action(list: nil, action_name: "Release fish")
open_row_action(list: "Runnables", action_name: "Release fish")



234
235
236
 
# File 'lib/avo/test_helpers.rb', line 234

def open_row_action(record_id:, action_name:, list: "Actions")
  open_action(action_name: action_name, list: list, context: row(record_id))
end

#remove_tag(field:, tag:) ⇒ Object

Example usage:

expect(remove_tag(field: :tags, tag: "one")).to eq ["three"]
remove_tag(field: :tags, tag: "one")



273
274
275
276
277
278
279
280
281
282
283
284
 
# File 'lib/avo/test_helpers.rb', line 273

def remove_tag(field:, tag:)
  # Within the specified field
  within("[data-field-id='#{field}'] [data-slot='value']") do
    # Find the tag with the specified text and click the remove button for the tag
    page.find(".tagify__tag", text: tag).find(".tagify__tag__removeBtn").click

    wait_for_tag_to_disappear(tag)
  end

  # Return an array of the current tags
  tags(field: field)
end

#run_action ⇒ Object

Click on submit action button if dialog is open



239
240
241
242
243
244
245
 
# File 'lib/avo/test_helpers.rb', line 239

def run_action
  within(find("[role='dialog']")) do
    find("[data-target='submit_action']").click
  end

  wait_for_action_dialog_to_disappear
end

#save ⇒ Object

Save a record and wait for the page to load For most cases ‘.click` works Sometimes other element may be overlapping the button so the `.trigger(“click”)` solves the issue Trigger can’t be used by default because it breaks on some feature specs



144
145
146
147
148
149
150
151
 
# File 'lib/avo/test_helpers.rb', line 144

def save
  button = find("button.button-component", text: "Save")
  button.click
rescue Capybara::Cuprite::MouseEventFailed
  button.trigger("click")
ensure
  wait_for_loaded
end

#second_tab_group ⇒ Object 



176
177
178
 
# File 'lib/avo/test_helpers.rb', line 176

def second_tab_group
  tab_group 1
end

#select_first_result_in_search ⇒ Object

Should use the click_global_search_input or click_resource_search_input method to open the search box first and optionaly write_in_search. Example usage:

open_search_box(:users) # opens the search box for the "users" resource
write_in_search("John Doe")
select_first_result_in_search



131
132
133
134
135
136
137
138
 
# File 'lib/avo/test_helpers.rb', line 131

def select_first_result_in_search
  type :down, :enter
rescue
  find(".aa-Input").send_keys :arrow_down
  find(".aa-Input").send_keys :enter
ensure
  wait_for_search_loaded
end

#set_picker_day(date) ⇒ Object 



190
191
192
193
 
# File 'lib/avo/test_helpers.rb', line 190

def set_picker_day(date)
  find(".flatpickr-day[aria-label=\"#{date}\"]").click
  sleep 0.2
end

#set_picker_hour(value) ⇒ Object 



195
196
197
 
# File 'lib/avo/test_helpers.rb', line 195

def set_picker_hour(value)
  find(".flatpickr-hour").set(value)
end

#set_picker_minute(value) ⇒ Object 



199
200
201
 
# File 'lib/avo/test_helpers.rb', line 199

def set_picker_minute(value)
  find(".flatpickr-minute").set(value)
end

#set_picker_second(value) ⇒ Object 



203
204
205
 
# File 'lib/avo/test_helpers.rb', line 203

def set_picker_second(value)
  find(".flatpickr-second").set(value)
end

#show_field_label(id:) ⇒ Object

Finds the label element on the show view for the given field id Example usage:

show_field_label(id: "name")



74
75
76
 
# File 'lib/avo/test_helpers.rb', line 74

def show_field_label(id:)
  within(show_field_wrapper(id: id)) { find("[data-slot='label']").text }
end

#show_field_value(id:, type: nil) ⇒ Object

Finds the value element on the show view for the given field id Example usage:

show_field_value(id: "name")



88
89
90
 
# File 'lib/avo/test_helpers.rb', line 88

def show_field_value(id:, type: nil)
  within(show_field_wrapper(id: id, type: type)) { find("[data-slot='value']").text }
end

#show_field_wrapper(id:, type: nil) ⇒ Object

Finds the wrapper element on the show view for the given field id and type Example usage:

show_field_wrapper(id: "name", type: "text")
show_field_wrapper(id: "name")



30
31
32
33
34
35
36
37
38
 
# File 'lib/avo/test_helpers.rb', line 30

def show_field_wrapper(id:, type: nil)
  base_data = "[data-panel-id='main'] [data-field-id='#{id}']"

  if type.present?
    find("#{base_data}[data-resource-show-target='#{wrapper_name_for(id: id, type: type)}']")
  else
    find(base_data)
  end
end

#tab_group(index = 0) ⇒ Object 



168
169
170
 
# File 'lib/avo/test_helpers.rb', line 168

def tab_group(index = 0)
  find_all('[data-controller="tabs"]')[index]
end

#tag_suggestions(field:, input:) ⇒ Object

Example usage:

expect(tag_suggestions(field: :tags, input: "")).to eq ["one", "two", "three"]
expect(tag_suggestions(field: :tags, input: "t")).to eq ["two", "three"]



298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
 
# File 'lib/avo/test_helpers.rb', line 298

def tag_suggestions(field:, input:)
  # Find the input field for the specified tag field
  input_area = find("[data-field-id='#{field}'] [data-slot='value'] [role='textbox']")

  # If the input argument is present, enter it into the input field
  # Else, set input to "open" than to " " to trigger dropdown
  if input.present?
    input_area.set(input)
  else
    input_area.set("open")
    input_area.set(" ")
  end
  wait_for_tag_suggestions_to_appear

  # Find all elements with class 'tagify_dropdown_item' within the dropdown
  # Map the elements to their 'label' attribute values and return the array of labels
  page.all(".tagify__dropdown__item").map { |element| element[:label] }
end

#tags(field:) ⇒ Object

Example usage:

expect(tags(field: :tags)).to eq ["one", "two", "three"]
expect(tags(field: :tags)).to eq []



289
290
291
292
293
 
# File 'lib/avo/test_helpers.rb', line 289

def tags(field:)
  # Find all elements with class 'tagify__tag'
  # Map the elements to text and return the array of texts
  page.all(".tagify__tag").map(&:text)
end

#third_tab_group ⇒ Object 



180
181
182
 
# File 'lib/avo/test_helpers.rb', line 180

def third_tab_group
  tab_group 3
end

#toggle_collapsable(section) ⇒ Object 



251
252
253
 
# File 'lib/avo/test_helpers.rb', line 251

def toggle_collapsable(section)
  find("[data-action='click->menu#triggerCollapse'][data-menu-key-param*='main_menu.#{section.underscore}'] svg").click
end

#type ⇒ Object 



317
318
319
320
321
322
323
 
# File 'lib/avo/test_helpers.rb', line 317

def type(...)
  if page.driver.browser.respond_to?(:keyboard)
    page.driver.browser.keyboard.type(...)
  else
    page.send_keys(...)
  end
end

#write_in_search(input) ⇒ Object

Should use the click_global_search_input or click_resource_search_input method to open the search box first. Example usage:

open_search_box(:users)
within(has_and_belongs_to_many_field_wrapper(id: :users)) {
  click_resource_search_input # opens the search box for the "users" resource
  write_in_search("Bob")
}



120
121
122
123
124
 
# File 'lib/avo/test_helpers.rb', line 120

def write_in_search(input)
  # Use xpath to find outside of within context if any
  find(:xpath, "//input[@class='aa-Input']").set(input)
  wait_for_search_loaded
end