Paget e s t: W eWebPagetest APIlyUsing the b he Ug he Ba d&TThe Good, T
1 First … some basic tips
Understand the test environmentWindows version? DNS resolver?Hardware specs (RAM, processor)?
Run a large number of tests
Collect RUM data too !
Summary statistics hide insight Mean: ~1400 ms Median: ~1100 ms
Look at individual tests Normal Ouch!
2 New stuff in the WPT ui
Homepage > Advanced tab
Capture Network Log (Chrome)Returns big TXT file with JSON … then what?Pat: “You probably dont want to use thenetwork log - it was added for the Chrometeam themselves to debug the browser :-)”
Minimum test durationIt works, kindof ... Example (minTestDur=45)
3 WPT API introduction
Getting startedGet an API key from Pat (required)Know your requests will have low prio /getLocations.phpBasic process:1. Submit request via POST or GET2. Poll for the test status (or use pingback)3. Fetch test results4. Fetch objects (charts, screen shots, ...)
Submitting requestsSend a POST or GET tohttp://www.webpagetest.org/runtest.phpurl is only required parameterDefaults: Dulles DSL, 1 run, first & repeatview, public, no videoOverview of parameters
ResultsExample XMLIt has it all, incl.1. PageSpeed version & results2. Page <title>3. Links to pages/files for everything in UI4. Video frame URLs & Speed Index score !
DocumentationOfficial API documentationPython lib for ad-hoc batch processingBatch processing command line tool
Lots of possibilities!https://sites.google.com/a/webpagetest.org/docs/using-webpagetest/scriptingNavigation/DOM interaction (submitForm)End Conditions (setDOMelement)Request Manipulation (setDNS)Misc (combineSteps)Great for simulating user-page interaction,multi-page testing and different conditions
Commands youll likely useCommand Descriptionnavigate Navigate to next page, wait for it to completelogData Set to 0 to not record anything; 1 = record!setValue Sets the value attribute of the given DOM element to the provided value.submitForm Triggers a submit event for the identified form.setDOMElement Sets the attribute of a DOM element that is required for the next event to complete successfully.block Blocks individual requests from loadingcombineSteps Causes multiple script steps to be combined into a single "step" in the resultssetViewportSize Changes size of visible browser windowfirefoxPref Allows you to specify arbitrary preferences that will be configured before launching the browser. Eg. firefoxPref network.http.pipelining falsesetDNS Allows for overriding the IP address for a host name.
Why did the test fail?Can be very hard to troubleshoot, esp. onlarge scripts
5 WPT – hidden gems
¬email@example.com address to notify with the test results
&iq=90Specify a jpeg compression level (30-10095)for the screen shots and video capture iq=default iq=90 Video!
&pngss=1Set to 1 to save a full-resolution version ofthe fully loaded screen shot as a png Normal JPG Big PNG24
&f=jsonFormat. Set to "xml" to request an XMLresponse instead of a redirect ("json" is alsoprovisionally supported)
&plr=50Packet loss rate - percent of packets to drop(used when specifying a custom connectivityprofile) plr=0 plr=50 No diff ! Location specific issue?
console.log() outputCan be found on the screen shots page ... Example
Time to TitleNot in UI, but ís in results from API: <titleTime>Can also be found in “Raw Page data” CSV Example