added chrometrace command

Author: marcelduran

lib/mapping.js

@@ -714,6 +714,12 @@ var commands = {
     options: [options.run],
     info: 'get the Chrome Developer Tools Net log data (if available) from test'
   },
+  'chrometrace': {
+    name: 'getChromeTraceData',
+    param: 'id',
+    options: [options.run],
+    info: 'get the Chrome Trace data (if available) from test'
+  },
   'console': {
     name: 'getConsoleLogData',
     param: 'id',

lib/webpagetest.js

@@ -43,6 +43,7 @@ var filenames = {
   utilization: 'progress.csv',
   request: 'IEWTR.txt',
   netLog: 'netlog.txt',
+  chromeTrace: 'trace.json',
   consoleLog: 'console_log.json',
   testInfo: 'testinfo.json',
   history: 'history.csv',
@@ -529,6 +530,17 @@ function getNetLogData(id, options, callback) {
   }, options);
 }
 
+function getChromeTraceData(id, options, callback) {
+  callback = callback || options;
+  options = options === callback ? {} : options;
+  options.parser = options.parser || helper.netLogParser;
+
+  return api.call(this, paths.gzip, callback, {
+    test: id,
+    file: setFilename(filenames.chromeTrace, options)
+  }, options);
+}
+
 function getConsoleLogData(id, options, callback) {
   callback = callback || options;
   options = options === callback ? {} : options;
@@ -729,6 +741,7 @@ WebPageTest.prototype = {
   getRequestData: getRequestData,
   getTimelineData: getTimelineData,
   getNetLogData: getNetLogData,
+  getChromeTraceData: getChromeTraceData,
   getConsoleLogData: getConsoleLogData,
   getTestInfo: getTestInfo,
   getHistory: getHistory,
@@ -754,6 +767,7 @@ WebPageTest.prototype = {
   request: getRequestData,
   timeline: getTimelineData,
   netlog: getNetLogData,
+  chrometrace: getChromeTraceData,
   console: getConsoleLogData,
   testinfo: getTestInfo,
   history: getHistory,

test/command-line-test.js

@@ -307,8 +307,9 @@ describe('WebPageTest Command Line', function() {
   // loop all commands help
   [
     '', 'status', 'results', 'locations', 'testers', 'test', 'cancel', 'har',
-    'pagespeed', 'utilization', 'request', 'timeline', 'netlog', 'console',
-    'testinfo', 'history', 'waterfall', 'screenshot', 'listen', 'video'
+    'pagespeed', 'utilization', 'request', 'timeline', 'netlog', 'chrometrace',
+    'console', 'testinfo', 'history', 'googlecsi', 'response', 'waterfall',
+    'screenshot', 'video', 'player', 'listen', 'batch'
   ].forEach(function eachCmd(command) {
       it('gets a ' + command + ' help input and returns the help text', function(done) {
         exec(mock(command + ' --help'), function(err, data) {

test/fixtures/command-line/help-batch.txt

@@ -0,0 +1,7 @@
+
+  Usage: batch [options] <file>
+
+  Options:
+
+    -h, --help  output usage information
+

test/fixtures/command-line/help-chrometrace.txt

@@ -0,0 +1,9 @@
+
+  Usage: chrometrace [options] <id>
+
+  Options:
+
+    -h, --help          output usage information
+    -r, --run <number>  which run number on a multiple runs test [1]
+    -c, --cached        get the Repeat View (cached view) instead of default First View (primed cache)
+

test/fixtures/command-line/help-player.txt

@@ -0,0 +1,7 @@
+
+  Usage: player [options] <id>
+
+  Options:
+
+    -h, --help  output usage information
+

test/fixtures/command-line/help.txt

@@ -3,29 +3,78 @@
 
   Commands:
 
-    status [options] <id>  check test status
-    results [options] <id> get test results
-    locations [options]    list locations and the number of pending tests
-    testers [options]      list testers status and details
-    test [options] <url_or_script> run test
-    cancel [options] <id>  cancel running/pending test
-    har <id>               get the HTTPS Archive (HAR) from test
-    pagespeed [options] <id> get the Google Page Speed results (if available) from test
-    utilization [options] <id> get the CPU, bandwidth and memory utilization data from test
-    request [options] <id> get the request data from test
-    timeline [options] <id> get the Chrome Developer Tools Timeline data (if available) from test
-    netlog [options] <id>  get the Chrome Developer Tools Net log data (if available) from test
-    console [options] <id> get the browser console log data (if available) from test
-    testinfo <id>          get test request info/details
-    history [days]         get history of previously run tests
-    googlecsi [options] <id> get Google CSI data (Client Side Instrumentation)
-    response [options] <id> get response body for text resources
-    waterfall [options] <id> get the waterfall PNG image
-    screenshot [options] <id> get the fully loaded page screenshot in JPG format (PNG if in full resolution)
-    video [options] <tests> create a video from <tests> (comma separated test ids)
-    player <id>            get a html5 player for a video <id>
-    listen [options] [hostname:port] start webpagetest-api proxy server on <hostname>:<port> [hostname:7791]
-    batch <file>           run commands in batch, i.e. one command per line from <file> in parallel
+    status [options] <id>
+       check test status
+    
+    results [options] <id>
+       get test results
+    
+    locations [options] 
+       list locations and the number of pending tests
+    
+    testers [options] 
+       list testers status and details
+    
+    test [options] <url_or_script>
+       run test
+    
+    cancel [options] <id>
+       cancel running/pending test
+    
+    har <id>
+       get the HTTPS Archive (HAR) from test
+    
+    pagespeed [options] <id>
+       get the Google Page Speed results (if available) from test
+    
+    utilization [options] <id>
+       get the CPU, bandwidth and memory utilization data from test
+    
+    request [options] <id>
+       get the request data from test
+    
+    timeline [options] <id>
+       get the Chrome Developer Tools Timeline data (if available) from test
+    
+    netlog [options] <id>
+       get the Chrome Developer Tools Net log data (if available) from test
+    
+    chrometrace [options] <id>
+       get the Chrome Trace data (if available) from test
+    
+    console [options] <id>
+       get the browser console log data (if available) from test
+    
+    testinfo <id>
+       get test request info/details
+    
+    history [days]
+       get history of previously run tests
+    
+    googlecsi [options] <id>
+       get Google CSI data (Client Side Instrumentation)
+    
+    response [options] <id>
+       get response body for text resources
+    
+    waterfall [options] <id>
+       get the waterfall PNG image
+    
+    screenshot [options] <id>
+       get the fully loaded page screenshot in JPG format (PNG if in full resolution)
+    
+    video [options] <tests>
+       create a video from <tests> (comma separated test ids)
+    
+    player <id>
+       get a html5 player for a video <id>
+    
+    listen [options] [hostname:port]
+       start webpagetest-api proxy server on <hostname>:<port> [hostname:7791]
+    
+    batch <file>
+       run commands in batch, i.e. one command per line from <file> in parallel
+    
 
   Options: