@spec we_see_at_least(String.t(), number(), keyword()) :: boolean()

Checks if an element is present in the rendered component, at least n number of times

This function is similar to we_see_exactly/3, but it checks if the element is present. Please see the documentation for we_see_exactly/3 for more information.

@spec we_see_attribute(String.t(), String.t()) :: boolean()

Checks if an element with a given data-test attribute is present in the rendered component.

Example

Let's say we have the following html code, and we want to check if the confirmation button is present in the rendered component:

<div data-test-confirmation-button>Confirm</div>

We can do so by calling the we_see_attribute/2 function on the html of the rendered component:

assert we_see_attribute(html, "confirmation button")

Arguments

html - the html of the rendered component attribute - the data-test attribute of the element we want to check for

@spec we_see_attribute(String.t(), String.t(), keyword()) :: boolean()

Similar to we_see_attribute/2, but also checks if the element has the given content.

Example

Let's say we have the following html code, and we want to check if the confirmation button is present in the rendered component:

<div data-test-confirmation-button>Confirm</div>

We can do so by calling the we_see_attribute/3 function on the html of the rendered component:

assert we_see_attribute(html, "confirmation button", content: "Confirm")

Arguments

html - the html of the rendered component attribute - the data-test attribute of the element we want to check for content - the content of the element we want to check for

@spec we_see_attribute_and_value(String.t(), String.t(), String.t()) :: boolean()

Checks if an element with a given data-test attribute and value is present in the rendered component.

Example

Let's say we have the following html code, and we want to check if the confirmation button is present in the rendered component:

<div data-test-confirmation-button="confirm">Confirm</div>

We can do so by calling the we_see_attribute_and_value/3 function on the html of the rendered component:

assert we_see_attribute_and_value(html, "confirmation button", "confirm")

Arguments

html - the html of the rendered component attribute - the data-test attribute of the element we want to check for attribute_value - the data-test attribute value of the element we want to check for

@spec we_see_attribute_and_value(String.t(), String.t(), String.t(), keyword()) ::
  boolean()

Similar to we_see_attribute_and_value/3, but also checks if the element has the given content.

Example

Let's say we have the following html code, and we want to check if the confirmation button is present in the rendered component:

<div data-test-confirmation-button="confirm">Confirm</div>

We can do so by calling the we_see_attribute_and_value/4 function on the html of the rendered component:

assert we_see_attribute_and_value(html, "confirmation button", "confirm", content: "Confirm")

Arguments

html - the html of the rendered component attribute - the data-test attribute of the element we want to check for attribute_value - the data-test attribute value of the element we want to check for content - the content of the element we want to check for

@spec we_see_attribute_value(String.t(), String.t()) :: boolean()

Checks if an element with a given data-test attribute value is present in the rendered component.

Example

Let's say we have the following html code, and we want to check if the title is present in the rendered component:

<div data-test="title">Title</div>

We can do so by calling the we_see_attribute_value/2 function on the html of the rendered component:

assert we_see_attribute_value(html, "title")

Arguments

html - the html of the rendered component attribute_value - the data-test attribute value of the element we want to check for

@spec we_see_attribute_value(String.t(), String.t(), keyword()) :: boolean()

Similar to we_see_attribute_value/2, but also checks if the element has the given content.

Example

Let's say we have the following html code, and we want to check if the title is present in the rendered component:

<div data-test="title">Title</div>

We can do so by calling the we_see_attribute_value/3 function on the html of the rendered component:

assert we_see_attribute_value(html, "title", content: "Title")

Arguments

html - the html of the rendered component attribute_value - the data-test attribute value of the element we want to check for content - the content of the element we want to check for

@spec we_see_exactly(String.t(), number(), keyword()) :: boolean()

Checks if an element is present in the rendered component, n number of times

Example

Let's say we have the following html code, and we want to check if buttons are present in the rendered component:

<div data-test="button">Button</div>
<div data-test="button">Button</div>

We can do so by calling the we_see_exactly/3 function on the html of the rendered component:

assert we_see_exactly(html, 2, attribute: "button")

Arguments

html - the html of the rendered component number - the number of times the element should be present

Optional arguments

attribute - the data-test attribute of the element we want to check for content - the content of the element we want to check for attribute_value - the data-test attribute value of the element we want to check for

We can have any combination of the above optional arguments, but we must have at least one attribute or attribute_value argument. For instance, lets look at the following html code:

<div data-test="button">Button</div>
<div data-test="button">Second Button</div>
<div data-test-cancellation>Third Button</div>
<div data-test-cancellation>Fourth Button</div>
<div data-test-optional="option">Fifth Button</div>
<div data-test-optional="option">Sixth Button</div>

We can check the number of buttons by calling the we_see_exactly/2 function with multiple optional arguments:

With attribute:

assert we_see_exactly(html, 2, attribute: "cancellation")

With attribute_value:

assert we_see_exactly(html, 2, attribute_value: "button")

With attribute and attribute_value:

assert we_see_exactly(html, 2, attribute: "optional", attribute_value: "option")

With attribute and content:

assert we_see_exactly(html, 1, attribute: "cancellation", content: "Third Button")

With attribute_value and content:

assert we_see_exactly(html, 1, attribute_value: "button", content: "Second Button")

With attribute, attribute_value and content:

assert we_see_exactly(html, 1, attribute: "optional", attribute_value: "option", content: "Fifth Button")