Testing HTML Views with Nokogiri [beta]

The phlex-testing-nokogiri gem provides helpers for working with rendered views as Nokogiri documents and fragments.

Installation

Add the following to the test group in your Gemfile and run bundle install.

gem "phlex-testing-nokogiri"

Testing Documents

If your view represents a whole HTML document, you can require phlex/testing/nokogiri and include the Phlex::Testing::Nokogiri::DocumentHelper module to render your view as Nokogiri::Document using the render method.

require "phlex/testing/nokogiri"

class TestExample < Minitest::Test
	include Phlex::Testing::Nokogiri::DocumentHelper

	def test_example
		output = render Example.new
		assert_equal "Hello Joel", output.css("h1").text
	end
end

class Hello < Phlex::HTML
	def initialize(name)
		@name = name
	end

	def template
		h1 { "Hello #{@name}" }
	end
end

Testing Fragments

If your view represents a fragment (partial), you can require phlex/testing/nokogiri and include the Phlex::Testing::Nokogiri::FragmentHelper module to render your view as Nokogiri::Fragment with the render method.

require "phlex/testing/nokogiri"

class TestExample < Minitest::Test
	include Phlex::Testing::Nokogiri::FragmentHelper

	def test_example
		output = render Example.new("Joel")
		assert_equal "Hello Joel", output.css("h1").text
	end
end

class Hello < Phlex::HTML
	def initialize(name)
		@name = name
	end

	def template
		h1 { "Hello #{@name}" }
	end
end

📝 Edit this page on GitHub