The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.

NAME

Archive::Har::Entry - Represents a single http request/response pair inside the HTTP Archive

VERSION

Version '0.21'

SYNOPSIS

use Archive::Har();

my $http_archive_string = '"log": { "version": "1.1", .... ';
my $har = Archive::Har->new();
$har->string($http_archive_string);
foreach my $entry ($har->entries()) {
    print "PageRef: " . $entry->pageref() . "\n";
    print "DateTime: " . $entry->started_date_time() . "\n";
    print "Total Elasped Time: " . $entry->time() . "\n";
    my $request = $entry->request();
    my $response = $entry->response();
    my $cache = $entry->cache();
    my $timing = $entry->pageTimings();
    print "Server IP Address: " . $entry->server_ip_address() . "\n";
    print "Connection: " . $entry->connection() . "\n";
    print "Comment: " . $entry->comment() . "\n";
    $entry->comment("Something interesting here");
}

DESCRIPTION

This Module is intended to provide an interface to create/read/update Entry objects in HTTP Archive (HAR) files.

SUBROUTINES/METHODS

new

returns a new Entry object

pageref

returns the reference to the parent page. This may be null.

started_date_time

returns the date and time stamp for the beginning of the request (ISO 8601 format)

time

returns the total elapsed time of the request in milliseconds. It is the sum of all the timings available in the timings object (not including undefined values).

request

returns the request object

response

returns the response object

cache

returns the cache object

timings

returns the entry timings object

server_ip_address

returns the IP address of the server that was connected (result of DNS resolution)

connection

returns the unique ID of the parent TCP/IP connection. This can be the client port number.

comment

returns the comment about the Entry

DIAGNOSTICS

started_date_time is not formatted correctly

The started_date_time field must be formatted like so

0000-00-00T00:00:00.0+00:00

%s is not specified in the HAR 1.2 spec and does not start with an underscore

The HAR 1.2 specification allows undocumented fields, but they must start with an underscore

CONFIGURATION AND ENVIRONMENT

Archive::Har::Entry requires no configuration files or environment variables.

DEPENDENCIES

Archive::Har::Entry requires no additional non-core Perl modules

INCOMPATIBILITIES

None reported

AUTHOR

David Dick, <ddick at cpan.org>

BUGS AND LIMITATIONS

Please report any bugs or feature requests to bug-archive-har at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Archive-Har. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

LICENSE AND COPYRIGHT

Copyright 2015 David Dick.

This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.

See http://dev.perl.org/licenses/ for more information.