Add integration test use case to Examples section in README

[dlisboa]

Since running integration tests in parallel is one of the great benefits of the project it'd be good to have a small example showing how it can be done. The examples available right now enlighten the uses in automation and scraping, but not so much on tests.

[chebyte]

anyone knows how run many instances in parallel?

[adieuadieu]

While we don't yet have a "recommended" way, here are two options. Both assume you're running the tests over the Proxy.:

1. Write tests with a test runner that supports concurrent execution (e.g. ava --concurrency <num>, jest--maxWorkers=<num>). Then write any number of tests, for example:

import test from 'ava'
import Chromeless from 'chromeless'

test('google title', async t => {
  const chromeless = new Chromeless({ remote: true })
  const title = await chromeless
    .goto('https://www.google.com')
    .evaluate(() => document.title)

  await chromeless.end()

  t.is(title, 'Google')
})

Then:

export CHROMELESS_ENDPOINT_URL=https://XXXXX.execute-api.eu-west-1.amazonaws.com/dev
export CHROMELESS_ENDPOINT_API_KEY=mulolKOvmeowIaqEC6Azs9Csausages2lCychahal
ava

This first method is used by Graphcool for integration tests on in-production code. You can see a work-in-progress example of this in their Console repository. You'll start seeing these types of tests more within this repository as we improve our test coverage.

2. Initialise a Chromeless instance n-times that you need it. For example, here's a hacky way I test the Proxy's parallelisation:

const Chromeless = require('chromeless').default

async function run() {
  const chromeless = new Chromeless({
    remote: {
      endpointUrl: 'https://XXXXX.execute-api.eu-west-1.amazonaws.com/dev',
      apiKey: 'mulolKOvmeowIaqEC6Azs9Csausages2lCychahal',
    },
    debug: true,
  })

  const screenshot = await chromeless
    .goto('https://www.google.com')
    .type('chromeless', 'input[name="q"]')
    .press(13)
    .wait('#resultStats')
    .screenshot()

  console.log(screenshot) // prints local file path or S3 url

  await chromeless.end()
}

const concurrency = 1 // increase this to run multiple at once. May cause unexpected AWS usage billing if you're not careful.

for (var i = 0; i < concurrency; i++) {
  run().catch(console.error.bind(console))
}