qualitymeter

    1.7.0 • Public • Published

    qualitymeter

    A customizable web performance metrics collector.

    Build Status npm version npm Downloads Dependency Status npm


    Requirements


    Installation


    npm install qualitymeter -g
    

    Usage

    • Using default settings
    qualitymeter [url]
    
    • Avaiable tags
    --help, -h                                  View the help screen of the module
    
    --config, -c [/path/to/config/file.json]    Use a custom configuration file.
    
    --verbose, -v                               Outputs configuration details being used, 
                                                along with additional output that may help with debugging.
    
    --report, -r                                Generates an html report from the performance data retrieved.
                                                A report can only be generated if the save_to_file property has a valid file.
    

    Configuration File


    Default configurations are as follows:

    urls: null
    output_to_screen: true
    save_to_file: null
    file_write_format: w
    report_output: qualitymeter.html (created in current directory)
    report_template: qualitymeter.jade (read from the qualitymeter module)
    whitelist: null
    timeout: 15

    A custom configuration file can be added with the following format

    {
        "urls": ["url1", "url2", ...],          //urls to be tested
        "output_to_screen": true,               //output performance results to screen
        "save_to_file": "path/to/file.json",    //file that performance results are saved to
        "file_write_format": "a",               //a to append, w to overwrite the report json file
        "report_output": "/path/to/file.html",  //HTML file that will be created in the current directory
        "report_template":"/path/to/file.jade", //Jade template to be used when generating HTML report
        "whitelist": ["metrics.timeToFirstByte", "", ...]   //List of properties to be returned by performance test
    }
    

    The suggested whitelist array is

    [
        "metrics.timeToFirstByte",
        "metrics.domInteractive",
        "metrics.domContentLoaded",
        "metrics.domComplete",
        "metrics.DOMelementsCount",
        "metrics.smallestResponse",
        "metrics.biggestResponse",
        "metrics.fastestResponse",
        "metrics.fastestResponse",
        "metrics.slowestResponse",
        "metrics.smallestLatency",
        "metrics.biggestLatency",
        "metrics.medianResponse",
        "metrics.medianLatency"
    ]
    

    N.B. the whitelist property can be used to retrieve specific information from the performance metrics. The other possible metrics can be seen at the phantomas module

    This module was made possible with the help of the phantomjs and phantomas frameworks.

    Keywords

    none

    Install

    npm i qualitymeter

    DownloadsWeekly Downloads

    2

    Version

    1.7.0

    License

    MIT

    Last publish

    Collaborators

    • avatar