NAME
Test::Mojo - Testing Mojo!
SYNOPSIS
use Test::Mojo;
my $t = Test::Mojo->new(app => 'MyApp');
$t->get_ok('/welcome')
->status_is(200)
->content_like(qr/Hello!/, 'welcome message!');
$t->post_form_ok('/search', {title => 'Perl', author => 'taro'})
->status_is(200)
->content_like(qr/Perl.+taro/);
$t->delete_ok('/something')
->status_is(200)
->header_is('X-Powered-By' => 'Mojolicious (Perl)')
->content_is('Hello world!');DESCRIPTION
Test::Mojo is a collection of testing helpers for everyone developing Mojo and Mojolicious applications.
ATTRIBUTES
Test::Mojo implements the following attributes.
app
my $app = $t->app;
$t = $t->app(MyApp->new);Application to be tested.
client
my $client = $t->client;
$t = $t->client(Mojo::Client->new);Client used for testing.
redirects
my $redirects = $t->redirects;
$t = $t->redirects([]);History of redirected requests.
tx
my $tx = $t->tx;
$t = $t->tx(Mojo::Transaction::Simple->new);Current transaction.
max_redirects
my $max_redirects = $t->max_redirects;
$t = $t->max_redirects(3);Maximum number of redirects, defaults to 0.
METHODS
Test::Mojo inherits all methods from Mojo::Base and implements the following new ones.
content_is
$t = $t->content_is('working!');
$t = $t->content_is('working!', 'right content!');Check response content for exact match.
content_like
$t = $t->content_like(qr/working!/);
$t = $t->content_like(qr/working!/, 'right content!');Check response content for similar match.
content_type_is
$t = $t->content_type_is('text/html');
$t = $t->content_type_is('text/html', 'right content type!');Check response content type for exact match.
content_type_like
$t = $t->content_type_like(qr/text/);
$t = $t->content_type_like(qr/text/, 'right content type!');Check response content type for similar match.
delete_ok
$t = $t->delete_ok('/foo');
$t = $t->delete_ok('/foo', {Expect => '100-continue'});
$t = $t->delete_ok('/foo', 'Hi there!');
$t = $t->delete_ok('/foo', {Expect => '100-continue'}, 'Hi there!');
$t = $t->delete_ok(
'/foo',
{Expect => '100-continue'},
'Hi there!',
'request worked!'
);Perform a DELETE request.
get_ok
$t = $t->get_ok('/foo');
$t = $t->get_ok('/foo', {Expect => '100-continue'});
$t = $t->get_ok('/foo', 'Hi there!');
$t = $t->get_ok('/foo', {Expect => '100-continue'}, 'Hi there!');
$t = $t->get_ok(
'/foo',
{Expect => '100-continue'},
'Hi there!',
'request worked!'
);Perform a GET request.
head_ok
$t = $t->head_ok('/foo');
$t = $t->head_ok('/foo', {Expect => '100-continue'});
$t = $t->head_ok('/foo', 'Hi there!');
$t = $t->head_ok('/foo', {Expect => '100-continue'}, 'Hi there!');
$t = $t->head_ok(
'/foo',
{Expect => '100-continue'},
'Hi there!',
'request worked!'
);Perform a HEAD request.
header_is
$t = $t->header_is(Expect => '100-continue');
$t = $t->header_is(Expect => '100-continue', 'right header!');Check response header for exact match.
header_like
$t = $t->header_like(Expect => qr/100-continue/);
$t = $t->header_like(Expect => qr/100-continue/, 'right header!');Check response header for similar match.
json_content_is
$t = $t->json_content_is([1, 2, 3]);
$t = $t->json_content_is([1, 2, 3], 'right content!');Check response content for JSON data.
post_ok
$t = $t->post_ok('/foo');
$t = $t->post_ok('/foo', {Expect => '100-continue'});
$t = $t->post_ok('/foo', 'Hi there!');
$t = $t->post_ok('/foo', {Expect => '100-continue'}, 'Hi there!');
$t = $t->post_ok('/foo', 'Hi there!', 'request worked!');
$t = $t->post_ok(
'/foo',
{Expect => '100-continue'},
'Hi there!',
'request worked!'
);Perform a POST request.
post_form_ok
$t = $t->post_form_ok('/foo' => {test => 123});
$t = $t->post_form_ok('/foo' => 'UTF-8' => {test => 123});
$t = $t->post_form_ok('/foo', {test => 123}, {Expect => '100-continue'});
$t = $t->post_form_ok(
'/foo',
'UTF-8',
{test => 123},
{Expect => '100-continue'}
);
$t = $t->post_form_ok('/foo', {test => 123}, 'Hi there!');
$t = $t->post_form_ok('/foo', 'UTF-8', {test => 123}, 'Hi there!');
$t = $t->post_form_ok(
'/foo',
{test => 123},
{Expect => '100-continue'},
'Hi there!'
);
$t = $t->post_form_ok(
'/foo',
'UTF-8',
{test => 123},
{Expect => '100-continue'},
'Hi there!'
);Submit a POST form.
put_ok
$t = $t->put_ok('/foo');
$t = $t->put_ok('/foo', {Expect => '100-continue'});
$t = $t->put_ok('/foo', 'Hi there!');
$t = $t->put_ok('/foo', {Expect => '100-continue'}, 'Hi there!');
$t = $t->put_ok(
'/foo',
{Expect => '100-continue'},
'Hi there!',
'request worked!'
);Perform a PUT request.
reset_session
$t = $t->reset_session;Reset user agent session.
status_is
$t = $t->status_is(200);
$t = $t->status_is(200, 'right status!');Check response status for exact match.