NAME¶
Webinject - Perl Module for testing web services
SYNOPSIS¶
use Webinject;
my $webinject = Webinject->new();
$webinject->engine();
DESCRIPTION¶
WebInject is a free tool for automated testing of web applications and web
services. It can be used to test individual system components that have HTTP
interfaces (JSP, ASP, CGI, PHP, AJAX, Servlets, HTML Forms, XML/SOAP Web
Services, REST, etc), and can be used as a test harness to create a suite of
[HTTP level] automated functional, acceptance, and regression tests. A test
harness allows you to run many test cases and collect/report your results.
WebInject offers real-time results display and may also be used for monitoring
system response times.
CONSTRUCTOR¶
new ( [ARGS] )¶
Creates an "Webinject" object.
- reporttype
- possible values are 'standard', 'nagios', 'nagios2', 'mrtg'
or 'external:'
- nooutput
- suppress all output to STDOUT, create only logilfes
- break_on_errors
- stop after the first testcase fails, otherwise Webinject
would go on and execute all tests regardless of the previous case.
- timeout
- Default timeout is 180seconds. Timeout starts again for
every testcase.
- useragent
- Set the useragent used in HTTP requests. Default is
'Webinject'.
- max_redirect
- Set maximum number of HTTP redirects. Default is 0.
- proxy
- Sets a proxy which is then used for http and https
requests.
- output_dir
- Output directory where all logfiles will go to. Defaults to
current directory.
- globalhttplog
- Can be 'yes' or 'onfail'. Will log the http request and
response to a http.log file.
- httpauth
- Provides credentials for webserver authentications. The
format is:
['servername', 'portnumber', 'realm-name', 'username', 'password']
- baseurl
- the value can be used as {BASEURL} in the test cases
- baseurl1
- the value can be used as {BASEURL1} in the test cases
- baseurl2
- the value can be used as {BASEURL2} in the test cases
- standaloneplot
- can be "on" or "off". Default is off.
Create gnuplot graphs when enabled.
- graphtype
- Defaults to 'lines'
- gnuplot
- Defines the path to your gnuplot binary.
METHODS¶
engine¶
start the engine of webinject
EXAMPLES¶
example test case¶
<testcases>
<case
id = "1"
description1 = "Sample Test Case"
method = "get"
url = "{BASEURL}/test.jsp"
verifypositive = "All tests succeded"
warning = "5"
critical = "15"
label = "testpage"
errormessage = "got error: {PARSERESPONSE}"
/>
</testcases>
detailed description about the syntax of testcases can be found on the Webinject
homepage.
SEE ALSO¶
For more information about webinject visit
http://www.webinject.org
AUTHOR¶
Corey Goldberg, <corey@goldb.org>
Sven Nierlein, <nierlein@cpan.org>
COPYRIGHT AND LICENSE¶
Copyright (C) 2010 by Sven Nierlein
Copyright (C) 2004-2006 by Corey Goldberg
This library is free software; you can redistribute it under the GPL2
license.