Webinject(3pm)

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.

     ex.: http://proxy.company.net:3128

    with authentication:

     ex.: http://user:password@proxy.company.net:3128

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.