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

  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

Looks in various normal places for HTTP cookie files.

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).

Please notify the author if you find any.

Martin Thurn mthurn at cpan.org

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

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

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