NAME

HTTP::WebTest::Cookies - Cookie storage and management

SYNOPSIS

    use HTTP::WebTest::Cookies;

    $cookie_jar = HTTP::WebTest::Cookies->new;

    $cookie_jar->accept_cookies($bool);
    $cookie_jar->send_cookies($bool);

    $cookie_jar->add_cookie_header($request);
    $cookie_jar->extract_cookies($response);

DESCRIPTION

Subclass of HTTP::Cookies which enables optional transmission and receipt of cookies.

METHODS

accept_cookies($optional_accept_cookies)

Returns the current setting of accept_cookies. If optional boolean parameter $optional_accept_cookies is passed, enables or disables receipt of cookies.

Returns

True if receipt of cookies is enabled; false otherwise.

send_cookies($optional_send_cookies)

Returns the current setting of send_cookies. If optional boolean parameter $optional_send_cookies is passed, enables or disables transmission of cookies.

Returns

True if transmission of cookies is enabled; false otherwise.

extract_cookies (...)

Overloaded method. If receipt of cookies is enabled, passes all arguments to SUPER::extract_cookies. Otherwise, does nothing.

Overloaded method. If transmission of cookies is enabled, passes all arguments to SUPER::add_cookie_header. Otherwise, does nothing.

COPYRIGHT

Copyright (c) 2000-2001 Richard Anderson. All rights reserved.

Copyright (c) 2001-2002 Ilya Martynov. All rights reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

SEE ALSO

HTTP::WebTest

HTTP::WebTest::API

HTTP::Cookies