phantom-promise
A PhantomJS bridge with a promise based api.
Installation
npm install phantom-promise
Usage
var Phantom = ; var phantom = Phantom;phantom ;
API
Phantom
Page
Phantom
create ( )
Returns an instance of Phantom
.
Example
var Phantom = ; var phantom = Phantom;
createPage ( )
Creates a Web Page in PhantomJs. Returns a Promise
that is fulfilled with an instance of Page
.
Example
phantom
initialize ( )
Initializes the Phantom
instance. Returns a Promise
that is fulfilled once the initialization is complete.
This must be called before the instance can be used.
Example
phantom ;
shutdown ( )
Shuts down the phantom instance. Once this has been called, the instance is no longer operable unless it is re-initialized.
Example
phantom;
Page
close ( )
Closes the page. Once this has been called, the page instance can no longer be used.
Example
page;
evaluate ( fn [,arg] )
Evaluates a function on the page. Returns a Promise
that is fulfilled with the return value of the function.
Arguments
fn
- The function to evaluate on the page. This function must callwindow.callPhantom(result)
in order to return.arg
- An argument to evaluatefn
with. This argument must be JSON-serializable (i.e. Closures, functions, DOM nodes, etc. will not work!).
Example
var { window;}; var arg = 'Hello from Phantom.';page ;
get ( property )
Returns a Promise that is fulfilled with the requested page property.
Arguments
property
- A string determining the property to return.
Example
page ;
injectJs ( paths )
Injects external scripts into the page. The scripts are loaded in the order they are supplied so that dependencies can be met.
Arguments
paths
- A path or an array of paths to the script files to be injected.
Example
page;
set ( property , value )
Sets a page property. Returns a promise that is fulfilled with the result.
Arguments
property
- A string determining the property to set.value
- The value to apply.
Example
page;