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]':     '[email protected]',
    '#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.