David Dick > Archive-Har > Archive::Har::Entry

Download:
Archive-Har-0.12.tar.gz

Dependencies

Annotate this POD

CPAN RT

Open  0
View/Report Bugs
Module Version: 0.12   Source  

NAME ^

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

VERSION ^

Version 0.12

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.

syntax highlighting: