TestSelector

A set of Elixir and Hound helpers to set/get test selectors to/from elements in a Phoenix app (when Mix.env == :test). These selectors are hashed (scoped to the view module they are used in) for accurate selection and "leakage" prevention. See our Wiki for examples.

Why? Because we prefer reserving classes for styling, and id's have limitations because they have to be unique.

Dependencies

• Hound v1.x.x
• Floki v0.25.x and higher

Installation

def deps do
  [{:test_selector, "~> 0.3.1"}]
end

Use TestSelector.HTML.Helpers to your web.ex.

• In phoenix 1.2.0 at web/web.ex
• In newer Phoenix versions lib/your_project/web/web.ex

Add somewhere along:

  def view(opts \\ []) do
    quote do
      ...
      use Phoenix.HTML

      use TestSelector.HTML.Helpers
      ...
    end
  end

Testing with Floki

In the tests import the TestSelector.Test.HoundHelpers :

defmodule Project.Web.MyTest do
  ...
  use Hound.Helpers

  import TestSelector.Test.FlokiHelpers
  ...
end

Testing with Hound

In the tests import the TestSelector.Test.HoundHelpers

defmodule Project.Web.MyTest do
  ...
  use Hound.Helpers

  import TestSelector.Test.HoundHelpers
  ...
end

Tests

To run tests you need to install PhantomJS.

brew install phantomjs

Run the webdriver:

phantomjs -w

Run the tests:

mix test