phantomjs-node-helper

Phantom

Description

This is wrapper under phantomjs-node.

Usage

var utils = require('mservice-utils');
 
var ph = new Phantom(cfg, function()) {
  ph.createPage(function(page) {
    page.open('...');
  });
}

Configuration parameters

Config parameter	Description	Default value
useragent	browser version and agent sent in headers to site	random
referer	first referer sent in headers to site for each page	https://www.facebook.com
viewport	display width and height in '{ width: XXX, height: YYY }'	random
cfg.arg	parameters for phantom.js	--ssl-protocol=tlsv1, --ignore-ssl-errors=yes
proxy	proxy which should be used for requests	none

Events

Name	Parameters	Description
ready	function()	fired on class init if no callback set
*.urlChanged	function(url)	fired on url change
*.loadFinished	function()	fired then page finish loading

** * *** = namespace returned from .createPage

Public methods

createPage(namespace, callback) or createPage(callback)

Create page instance ready for use. This function take namespace (used in events) and callack with err and page parameters.

Page methods

Page instance has few extra methods:

selectorClick(querySelector, callback)

Emulate click with sendEvent('click') on the random place on the element specified with querySelector

selectorClickJS(querySelector, callback)

Emulate click with Javascript MouseEvent on the random place on the element specified with querySelector

selectorType(querySelector, text, callback)

Emulate user behaviour (focusing, typing) with text field specified with querySelector

selectorImageBase64(querySelector, callback)

Find and extract content from image specified with querySelector and call callback(error, imageContent)

processForm(formObj, submitSelector, callback)

Process form like a human. Requiring formObj as a hashmap with keys as a selectors and values which should be passed to the selected input. Also requiring submitSelector - selector for the submit button which will be pressed after form filled. Example:

page.processForm({
    '#form input[name=FirstName]': 'Ivan',
    '#form input[name=LastName]':  'Ivanov',
    '#form input[name=Email]':     '[e-mail]',
    '#form input[name=Password]':  'qwe123',
    '#form input[name=Password2]': 'qwe123'
}, '#form button[role=submit]', function (e) {
    if (e) {
        throw e;
    }
 
    console.log('Form submited!');
});

processForm can be also called without some arguments, for example:

.processForm(formObj, next) - fill form
.processForm(formObj, 'selector', next) - fill form and click the button
.processForm('selector', next) - simply click the button
.processForm(formObj, 'selector', { delay: 200 }, next) - fill form with 200ms switch between selectors and click the button

getRecaptchaImageBase64 (iframeSelector, callback)

Note: this method requires legacy user-agent setted in Phantom constructor. Use https://github.com/arkcore/legacy-random-ua module for this. Get base64 of the image from legacy ReCaptcha. Requires iframeSelector - parameter for query selector to pick ReCaptcha iframe (in most cases it will be .g-recaptcha iframe). Callback will be called with error or base64 string of the image in second argument.

pasteRecaptchaText (iframeSelector, solution, callback)

Paste ReCaptcha solution and verify.