NAME

HTTP::Cookies::Find - Locate cookies for the current user on the local machine.

SYNOPSIS

  use HTTP::Cookies::Find;
  my $oCookies = HTTP::Cookies::Find->new('domain.com');
  my @asMsg = HTTP::Cookies::Find::errors;
  # Now $oCookies is a subclass of HTTP::Cookies
  # and @asMsg is an array of error messages

  # Call in array context to find cookies from multiple
  # browsers/versions:
  my @aoCookies = HTTP::Cookies::Find->new('domain.com');
  # Now @aoCookies is an array of HTTP::Cookies objects

DESCRIPTION

Looks in various normal places for HTTP cookie files.

METHODS

new

Returns a list of cookie jars of type HTTP::Cookies::[vendor], for all vendor browsers found on the system. If called in scalar context, returns one cookie jar for the "first" vendor browser found on the system. The returned cookie objects are not tied to the cookie files on disk; the returned cookie objects are read-only copies of the found cookies. If no argument is given, the returned cookie objects contain read-only copies of ALL cookies. If an argument is given, the returned cookie objects contain read-only copies of only those cookies whose hostname "matches" the argument. Here "matches" means case-insensitive pattern match; you can pass a qr{} regexp as well as a plain string for matching.

errors

If anything went wrong while finding cookies, errors() will return a list of string(s) describing the error(s).

BUGS

Please notify the author if you find any.

AUTHOR

Martin Thurn mthurn at cpan.org

COPYRIGHT

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

SEE ALSO

HTTP::Cookies, HTTP::Cookies::Microsoft, HTTP::Cookies::Mozilla, HTTP::Cookies::Netscape

SPECIAL THANKS

To David Gilder, for the FireFox (Mozilla) code additions. To David Gilder, for the Vista MSIE code additions.