NAME
Test::Mojo - Testing Mojo!
SYNOPSIS
use Test::More tests => 12;
use Test::Mojo;
my $t = Test::Mojo->new('MyApp');
$t->get_ok('/welcome')->status_is(200)->text_is('div#message' => 'Hello!');
$t->post_form_ok('/search.json' => {q => 'Perl'})
->status_is(200)
->header_is('X-Powered-By' => 'Mojolicious (Perl)')
->header_isnt('X-Bender' => 'Bite my shiny metal ass!');
->json_is('/results/4/title' => 'Perl rocks!');
$t->websocket_ok('/echo')
->send_message_ok('hello')
->message_is('echo: hello')
->finish_ok;DESCRIPTION
Test::Mojo is a collection of testing helpers for everyone developing Mojo and Mojolicious applications.
ATTRIBUTES
Test::Mojo implements the following attributes.
tx
my $tx = $t->tx;
$t = $t->tx(Mojo::Transaction::HTTP->new);Current transaction, usually a Mojo::Transaction::HTTP object.
# More specific tests
is $t->tx->res->json->{foo}, 'bar', 'right value';ua
my $ua = $t->ua;
$t = $t->ua(Mojo::UserAgent->new);User agent used for testing, defaults to a Mojo::UserAgent object.
$t->get_ok($t->ua->app_url->userinfo('sri:secr3t')->path('/secrets'));METHODS
Test::Mojo inherits all methods from Mojo::Base and implements the following new ones.
new
my $t = Test::Mojo->new;
my $t = Test::Mojo->new('MyApp');
my $t = Test::Mojo->new(MyApp->new);Construct a new Test::Mojo object.
app
my $app = $t->app;
$t = $t->app(MyApp->new);Alias for "app" in Mojo::UserAgent.
my $secret = $t->app->secret;
$t->app->log->level('fatal');
$t->app->defaults(testing => 'oh yea!');content_is
$t = $t->content_is('working!');
$t = $t->content_is('working!', 'right content');Check response content for exact match.
content_isnt
$t = $t->content_isnt('working!');
$t = $t->content_isnt('working!', 'different content');Opposite of content_is.
content_like
$t = $t->content_like(qr/working!/);
$t = $t->content_like(qr/working!/, 'right content');Check response content for similar match.
content_unlike
$t = $t->content_unlike(qr/working!/);
$t = $t->content_unlike(qr/working!/, 'different content');Opposite of content_like.
content_type_is
$t = $t->content_type_is('text/html');Check response Content-Type header for exact match.
content_type_isnt
$t = $t->content_type_isnt('text/html');Opposite of content_type_is.
content_type_like
$t = $t->content_type_like(qr/text/);
$t = $t->content_type_like(qr/text/, 'right content type');Check response Content-Type header for similar match.
content_type_unlike
$t = $t->content_type_unlike(qr/text/);
$t = $t->content_type_unlike(qr/text/, 'different content type');Opposite of content_type_like.
delete_ok
$t = $t->delete_ok('/foo');Perform a DELETE request and check for success, takes the exact same arguments as "delete" in Mojo::UserAgent.
element_exists
$t = $t->element_exists('div.foo[x=y]');
$t = $t->element_exists('html head title', 'has a title');Checks for existence of the CSS3 selectors first matching XML/HTML element with Mojo::DOM.
element_exists_not
$t = $t->element_exists_not('div.foo[x=y]');
$t = $t->element_exists_not('html head title', 'has no title');Opposite of element_exists.
finish_ok
$t = $t->finish_ok;
$t = $t->finish_ok('finished successfully');Finish WebSocket connection. Note that this method is EXPERIMENTAL and might change without warning!
get_ok
$t = $t->get_ok('/foo');Perform a GET request and check for success, takes the exact same arguments as "get" in Mojo::UserAgent.
head_ok
$t = $t->head_ok('/foo');Perform a HEAD request and check for success, takes the exact same arguments as "head" in Mojo::UserAgent.
header_is
$t = $t->header_is(Expect => 'fun');Check response header for exact match.
header_isnt
$t = $t->header_isnt(Expect => 'fun');Opposite of header_is.
header_like
$t = $t->header_like(Expect => qr/fun/);
$t = $t->header_like(Expect => qr/fun/, 'right header');Check response header for similar match.
header_unlike
$t = $t->header_like(Expect => qr/fun/);
$t = $t->header_like(Expect => qr/fun/, 'different header');Opposite of header_like.
json_content_is
$t = $t->json_content_is([1, 2, 3]);
$t = $t->json_content_is([1, 2, 3], 'right content');
$t = $t->json_content_is({foo => 'bar', baz => 23}, 'right content');Check response content for JSON data.
json_is
$t = $t->json_is('/foo' => {bar => [1, 2, 3]});
$t = $t->json_is('/foo/bar' => [1, 2, 3]);
$t = $t->json_is('/foo/bar/1' => 2, 'right value');Check the value extracted from JSON response using the given JSON Pointer with Mojo::JSON::Pointer. Note that this method is EXPERIMENTAL and might change without warning!
json_has
$t = $t->json_has('/foo');
$t = $t->json_has('/minibar', 'has a minibar');Check if JSON response contains a value that can be identified using the given JSON Pointer with Mojo::JSON::Pointer. Note that this method is EXPERIMENTAL and might change without warning!
json_hasnt
$t = $t->json_hasnt('/foo');
$t = $t->json_hasnt('/minibar', 'no minibar');Opposite of json_has. Note that this method is EXPERIMENTAL and might change without warning!
message_is
$t = $t->message_is('working!');
$t = $t->message_is('working!', 'right message');Check WebSocket message for exact match. Note that this method is EXPERIMENTAL and might change without warning!
message_isnt
$t = $t->message_isnt('working!');
$t = $t->message_isnt('working!', 'different message');Opposite of message_is. Note that this method is EXPERIMENTAL and might change without warning!
message_like
$t = $t->message_like(qr/working!/);
$t = $t->message_like(qr/working!/, 'right message');Check WebSocket message for similar match. Note that this method is EXPERIMENTAL and might change without warning!
message_unlike
$t = $t->message_unlike(qr/working!/);
$t = $t->message_unlike(qr/working!/, 'different message');Opposite of message_like. Note that this method is EXPERIMENTAL and might change without warning!
post_ok
$t = $t->post_ok('/foo');Perform a POST request and check for success, takes the exact same arguments as "post" in Mojo::UserAgent.
post_form_ok
$t = $t->post_form_ok('/foo' => {test => 123});Submit a POST form and check for success, takes the exact same arguments as "post_form" in Mojo::UserAgent.
put_ok
$t = $t->put_ok('/foo');Perform a PUT request and check for success, takes the exact same arguments as "put" in Mojo::UserAgent.
reset_session
$t = $t->reset_session;Reset user agent session.
send_message_ok
$t = $t->send_message_ok('hello');
$t = $t->send_message_ok('hello', 'sent successfully');Send WebSocket message. Note that this method is EXPERIMENTAL and might change without warning!
status_is
$t = $t->status_is(200);Check response status for exact match.
status_isnt
$t = $t->status_isnt(200);Opposite of status_is.
text_is
$t = $t->text_is('div.foo[x=y]' => 'Hello!');
$t = $t->text_is('html head title' => 'Hello!', 'right title');Checks text content of the CSS3 selectors first matching XML/HTML element for exact match with Mojo::DOM.
text_isnt
$t = $t->text_isnt('div.foo[x=y]' => 'Hello!');
$t = $t->text_isnt('html head title' => 'Hello!', 'different title');Opposite of text_is.
text_like
$t = $t->text_like('div.foo[x=y]' => qr/Hello/);
$t = $t->text_like('html head title' => qr/Hello/, 'right title');Checks text content of the CSS3 selectors first matching XML/HTML element for similar match with Mojo::DOM.
text_unlike
$t = $t->text_unlike('div.foo[x=y]' => qr/Hello/);
$t = $t->text_unlike('html head title' => qr/Hello/, 'different title');Opposite of text_like.
websocket_ok
$t = $t->websocket_ok('/echo');Open a WebSocket connection with transparent handshake, takes the exact same arguments as "websocket" in Mojo::UserAgent. Note that this method is EXPERIMENTAL and might change without warning!