AssertHTML
AssertHTML is an Elixir library for parsing and extracting data from HTML and XML with CSS.
Usage
Contains
assert_html(html, ~r{Hello World})
- match sting in HTML
refute_html(html, ~r{Another World})
-
assert_html(html, ".content") do
assert_html(~r{Hello World})
end
CSS selectors
assert_html(html, ".css .selector")
- check element exists in CSS selector path
refute_html(html, ".errors .error")
- element not exists in path
Check attributes
assert_html(html, "form", class: "form", method: "post", action: "/session/login") do
assert_html ".-email" do
assert_html("label", text: "Email", for: "staticEmail", class: "col-form-label")
assert_html("div input", type: "text", readonly: true, class: "form-control-plaintext", value: "email@example.com")
end
assert_html(".-password") do
assert_html("label", text: "Password", for: "inputPassword")
assert_html("div input", placeholder: "Password", type: "password", class: "form-control", id: "inputPassword", placeholder: "Password")
end
assert_html("button", type: "submit", class: "primary")
end
Example
defmodule ExampleControllerTest do
use ExUnit.Case, async: true
use AssertHTML
test "shows search form", %{conn: conn} do
conn_resp = get(conn, Routes.page_path(conn, :new))
assert response = html_response(conn_resp, 200)
assert_html response do
# Check element exists in CSS selector path
assert_html "p.description"
# element doesn't exists
refute_html ".flash-message"
# assert form attributes
assert_html "form.new_page", action: Routes.page_path(conn, :create), method: "post" do
# assert elements inside the `form.new_page` selector
assert_html "label", class: "form-label", text: "Page name"
assert_html "input", type: "text", class: "form-control", value: "", name: "page_name"
assert_html "button", class: "form-button", text: "Submit"
end
end
end
end
See HexDocs for additional documentation.
Installation
If available in Hex, the package can be installed
by adding assert_html
to your list of dependencies in mix.exs
:
def deps do
[
{:assert_html, ">= 0.0.1", only: [:test]}
]
end
Contribution
Feel free to send your PR with proposals, improvements or corrections 😉.
License
This software is licensed under the MIT license.