x-ray-puppeteer
Chromium Puppeteer driver for x-ray.
Why
XRay is great, but on ajax / JS-heavy pages, it needs to use a more complex driver. The best solution there is x-ray-phantom (which, incidentally, doesn't use phantom at all, but nightmarejs, but nightmare is limited in certain environments (plus, puppeteer is basically vanilla chromium, which is great).
Installation
This is a really simple function i whipped up ad hoc, so I haven't really set up for wider distribution yet.
For now you can either just clone this repo or copy the code in index.js into a file in your project
Usage
Driver takes 4 args. See jsdoc in index.js for details.
// set some options for the Puppeteer instance
const puppeteerOptions = {
headless: true,
// In order to persist session info, you need to designate a userDataDir.
// Note that this folder can get large,
// so consider adding it to .gitignore
userDataDir: './USER_SESSION/'
};
var x = Xray({ filters }).driver(
puppeteerDriver(
puppeteerOptions,
undefined, // <- see index.js for comments, but this basically is just an override for using Puppeteer in this driver.
{
// some options to pass to .goto()
timeout: 300000
},
'.some-selector-to-wait-for' // <- a selector that'll be passed to .waitFor() after .goto()
)
);