Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Test the page performance of one or more websites with Phantomjs, a webkit based, headless browser
Ruby
branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
.yardoc
doc
lib
test
vendor
.gitignore
.yardopts
Gemfile
Gemfile.lock
README.md
THANKS.md
run_page_performance

README.md

PagePerformance

Test the page performance of a single or more websites to compare them. You receive the average load time of each website. You can also get a summary about the used script and / or iframe tags used in each page.

This library uses Phantomjs, which is a headless, webkit based browser.

Code Climate

Usage

PagePerformance v. 0.5.3

This program is intended to test the performance of a website. It uses phantomjs which is a headless,
webkit based cli browser.

usage: run_page_performance [options]

    -u, --urls 'URLS'                the URLS to test
    -f, --file FILE                  the URLS to test from a file
    -a, --bau USER                   Basic-Authentication username
    -p, --bap PASSWORD               Basic-Authentication password
    -B, --base-url                   Use this URL as base
    -w, --wait TIME                  the time to wait between the requests after the block of URLs
    -r, --repeate INTEGER            amount of repetition
    -o, --output STRING              write results to this output file
    -g, --gps-api-key STRING         include Google PageSpeed results with this api key
    -s, --script                     count the <script> tags
    -i, --iframe                     count the <iframe> tags
    -I, --ignore-ssl-errors          advice Phantomjs to ignore SSL errors
    -q, --quiet                      no output durng program execution
    -h, --help                       show this message
    -v, --version                    show version

Example for running the tests:

$ ./run_page_performance -o out -u 'http://www.nms.de,http://www.beangie.de' -s -i -r 3
round 1:
 http://www.nms.de: 522 ms
 http://www.beangie.de: 3487 ms
round 2:
 http://www.nms.de: 3244 ms
 http://www.beangie.de: 2830 ms
round 3:
 http://www.nms.de: 475 ms
 http://www.beangie.de: 3857 ms

It's also possible (and mostly more convenient) to put the URLs in a file. One URL per line. Then call the script like this:

$ ./run_page_performance -o out -f file_with_urls -s -i -r 3

You can use the # character at the beginning of a line for comments.

Google PageSpeed Integration

Google PageSpeed service is integrated now. You can use the option -g or --gps-api-key and provide your Google API key. This service allows 2500 queries/per day. This should be enough for smaller testing purposes. One request for each URL will be fired once at the end of the program. Actually it is only available, when you use a result file (-o). For now, there is just the score result shown in the output file (see above). This feature is in early stage and will be enhanced soon.

Example output (file)

PagePerformance test results
============================

Test started at: 2015-04-04 02:23:22 +0200

Results for performance tests for the following URLs:

 + http://www.nms.de
 + http://www.beangie.de

Results:
--------
 http://www.nms.de: 1323 ms
 http://www.beangie.de: 1393 ms
 http://www.nms.de: 976 ms
 http://www.beangie.de: 1428 ms
 http://www.nms.de: 1010 ms
 http://www.beangie.de: 1396 ms

Average load time:
-----------------------------
 http://www.nms.de: 1103 ms
 http://www.beangie.de: 1405 ms

Amount of Tags found per URL:
-----------------------------
 http://www.nms.de:
   script: 4
   iframe: 1
 http://www.beangie.de:
   script: 9
   iframe: 0

GoogleSpeedTest per URL:
-----------------------------
 http://www.nms.de:
   ID: http://andywenk.github.io/
   Title: Welcome to my personal blog where I post about stuff I do
   HTTP-Response Code: 200
   Score: 89

   Page Statistics:
        Number of Resources:            10
        Number of different hosts:      7
        Number of static ressources:    7
        Total Request-Bytes:            0.00 KB
        HTML-Response-Bytes:            13.00 KB
        Number of CSS ressources:       1
        CSS-Response-Bytes:             28.00 KB
        Number of JS ressources:        4
        JavaScript-Response-Bytes:      138.00 KB
        Image-Response-Bytes:           22.00 KB
        Other-Response-Bytes:           0.00 KB

 http://www.beangie.de:
   ID: http://www.beangie.de/
   Title: Freie Art-Direktorin in Hamburg | Angela Becker | Screendesign | Print-Design | Freelance Art Direction Hamburg
   HTTP-Response Code: 200
   Score: 60

   Page Statistics:
        Number of Resources:            51
        Number of different hosts:      1
        Number of static ressources:    50
        Total Request-Bytes:            2.00 KB
        HTML-Response-Bytes:            9.00 KB
        Number of CSS ressources:       2
        CSS-Response-Bytes:             18.00 KB
        Number of JS ressources:        7
        JavaScript-Response-Bytes:      311.00 KB
        Image-Response-Bytes:           1070.00 KB
        Other-Response-Bytes:           0.00 KB

Known Bugs

see https://github.com/andywenk/page_performance/issues?state=open

Code Documentation

http://rdoc.info/github/andywenk/page_performance/master/frames

Debugging

You can debug PagePerformance easily with the awesome pry gem. If you start the program with the environemnt variable DEBUG=true, the pry gem is required in lib/require.rb. Setting a break point inside the code is done by binding.pry.

in lib/page_performance
def self.parse_cl
  binding.pry
  @argv_parser.parse
end

$ DEBUG=true ./run_page_performance -u 'www.google.de'
From: /Users/andwen/Documents/project/pageperformance/lib/page_performance.rb @ line 28 PagePerformance.parse_cl:

28:   def self.parse_cl
=> 29:     binding.pry
30:     @argv_parser.parse
31:   end

Next Steps

_ fix bugs
_ enhance
_ write tests !!!

License (Apache2)

Copyright (c) 2015 Andreas Wenk

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Something went wrong with that request. Please try again.