Skip to content

How to Handle Searches#

Imagine that you have a list of items and you want to search through them. You can use the search combo method and SearchSettings class to do this at scale.

View all options in the reference documentation.

Examples#

Basic usage:

Python
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
from browserist import Browser, SearchSettings

search_settings = SearchSettings(
    url="https://google.com",
    input_xpath ="//xpath/to/input_field",
    button_xpath="//xpath/to/search_button")

with Browser() as browser:
    browser.combo.search("some search term", search_settings)
    assert browser.tool.count_elements("//xpath/to/search_result_elements") > 0

Let's imagine that we want to test whether a search engine has fuzzy search enabled, For instance, this could mean that American and British English yield the same results for, respectively, "color" and "colour" as search term:

Python
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
from browserist import Browser, SearchSettings

search_settings = SearchSettings(
    url="https://google.com",
    input_xpath="//xpath/to/input_field",
    button_xpath="//xpath/to/search_button")

with Browser() as browser:
    browser.combo.search("color", search_settings)
    color_results = browser.tool.count_elements("//xpath/to/search_result_elements")
    browser.combo.search("colour", search_settings)
    colour_results = browser.tool.count_elements("//xpath/to/search_result_elements")
    assert color_results == colour_results