Skip to main content

open

open [url]

Opens a url and returns the page contents

arguments:​

url​

The url for the request. (type: string)

flags:​

--appendStage​

Used to append the results from a previous stage to the current stage. (provide a label, stage index, or boolean true to append the previous results)

--args​

array of JSON encoded values to pass to expression as input

--attributes​

A comma separated list of attributes to include in the command results. If not provided, all attributes will be included.

--cache​

A boolean value of true/false that determines whether or not to use the cache. Generally most commands will default to true.

--cookieStorage​

JSON serialized Cookie values to set pre-request

--device​

device to emulate, see devices command

--dimension​

extract dimension calculations from matching elements. NOTE: Running certain selectors like '*' can with dimension enabled can have performance implications due to DOM thrashing.

--engine​

css selector engine; "dom" or "jquery"

--expression​

javascript expression to evaluate after completion ES6 fat-arrow format with an argument of data passed (example "(data)=>data.map(item=>item.innerText)")

--filter​

A filter to run on the command results before completing the command. If not provided, no filter is run on the results.

--format​

screenshot format type (jpeg or png)

--fresh​

Starts the stage as if it was a fresh query, so will not use any previous result.

--headers​

JSON header values to set pre-request

--html​

extract innerHTML and outerHTML from matching elements. NOTE: Running certain selectors like '*' can with html enabled can have performance implications.

--jquery​

inject jquery library in last object argument passed to expression (example "(data, { $ })=>$('a').html()

--labelStage​

Used to label a stage with a user provided label.

--localStorage​

JSON sessionStorage values to set pre-request

--lodash​

inject lodash library in last object argument passed to expression (example "(data, { })=>)

--mathjs​

inject mathjs library in last object argument passed to expression (example "(data, { mathjs })=>mathjs)

--quality​

screenshot compression/quality for jpeg only

--retry​

number attempts to sucessfully run the following task

--screenshot​

take a screenshot of page

--selector​

CSS selector expression

--session​

capture session information; cookieStorage, localStorage and sessionStorage

--sessionStorage​

JSON serialized sessionStorage values to set pre-request

--stats​

Controls if a stats calculation is run on a stage after it completes.

--wait​

Wait criteria before resolving page load. Think of it as when to take a snapshot of browser data. window.onload: open http://crul.com --wait 'winload'

DOMContentLoaded: open http://crul.com --wait 'domload'

No more than 0 network connections for at least 500 ms. open http://crul.com --wait 'idle'

No more than 2 network connections for at least 500 ms. open http://crul.com --wait 'net2'

Element with matching selector exists: open http://crul.com --wait '.enjoying-it'

Wait for 30 seconds: open http://crul.com --wait 3000

Run the following fat-arrow ()=> until returns truthy: open http://google.com --wait '()=>true'

'winload' - consider navigation to be finished when the window load event is fired. 'domload' - consider navigation to be finished when the DOMContentLoaded event is fired. 'idle' - consider navigation to be finished when there are no more than 0 network connections for at least 500 ms. 'net2' - consider navigation to be finished when there are no more than 2 network connections for at least 500 ms. <integer> - the number of milliseconds to wait for. <()=>expression> - the function to be evaluated in browser context. <cssselector> A css selector of an element to wait for.