How to Count Elements in Vibium

To count elements in Vibium, call count() on a located element, like vibe.find("li").count(), which returns the number of matching nodes as an integer. This is the terse way to answer "how many of these are on the page?" — list items, table rows, links, search results, or cards. The equivalent is len(vibe.findAll("li")), which returns the same total by measuring the list that findAll() produces. Use count() when you only need the number, and findAll() when you also want to iterate over the actual Element objects to read their text, pull attributes, or click each one. Both work with CSS strings and with Vibium's semantic locators (role, text, label, placeholder, testid). Counting is one of the most common assertions in real test suites, where you verify that exactly N results, errors, or rows rendered after an action.

How do I count matching elements?

Locate the elements with find() and call count(), or call findAll() and take its length. Both return the same total.

from vibium import browser_sync as browser
 
vibe = browser.launch()
vibe.go("https://example.com/blog")
 
# Direct count
posts = vibe.find("article.post").count()
print(f"{posts} posts on this page")
 
# Equivalent: length of the findAll list
posts = len(vibe.findAll("article.post"))
print(f"{posts} posts on this page")
 
vibe.quit()

count() is the lighter call when you only need the number, since it does not need to hand back every Element. Reach for len(findAll()) when you are about to loop over the matches anyway and want the count for free.

How do I count and then iterate over the results?

Use findAll() to get the list, count it with len(), and loop over the same list to read each element. This avoids querying the page twice.

from vibium import browser_sync as browser
 
vibe = browser.launch()
vibe.go("https://example.com/search?q=vibium")
 
results = vibe.findAll(".result")
print(f"Found {len(results)} results")
 
for r in results:
    print(r.text())
 
vibe.quit()

findAll() returns its matches as a list immediately rather than auto-waiting, and gives an empty list (length 0) when nothing matches. That makes it safe to count results that may legitimately be zero without raising an error.

How do I assert on a count in a test?

Read the count and compare it with ordinary Python. Since the return value is a normal integer, any assertion style works.

from vibium import browser_sync as browser
 
vibe = browser.launch()
vibe.go("https://example.com/cart")
 
assert vibe.find(".cart-item").count() == 3, "Cart should have 3 items"
 
# Range and emptiness checks read naturally too
assert vibe.find(".error").count() == 0
assert vibe.findAll("nav a") != []
 
vibe.quit()

This keeps Vibium out of your way: there is no special matcher to learn, so counts slot straight into pytest, unittest, or whatever framework you already use. If the count depends on content that loads after the page, wait for at least one element with waitFor() before counting so you do not measure too early.

Next steps

• How to Find Elements in Vibium
• How to Get Element Text in Vibium
• How to Scrape a Table