Headless browser testing for tap with coverage reporting.
Clone or download
mikeal Merge pull request #2 from soldair/master
feat(require): add support for browserify.require and options.
Latest commit 71d9e59 Apr 3, 2018

README.md

Cappadonna

Headless browser testing for tap with coverage reporting.

Cappadonna merges several tools together for integrated testing.

Example:

const path = require('path')
const cappadonna = require('cappadonna')
const test = cappadonna(path.join(__dirname, 'bundle-entry-point.js'))

test('basic test', async (page, t) => {
  /* we get a new webpage object with our bundle loaded for every test */
  
  t.plan(1)
  let str = '<test-element>pass</test-element>'
  
  /* append string to document.body and wait for the selector to succeed */
  await page.appendAndWait(str, 'test-element')
  
  /* execute the given function in the browser */
  await page.evaluate(() => {
    t.same('pass', document.querySelector('test-element').textContent)
  })
})
$ tap tests/test-*.js --coverage

When coverage is enabled all code, including what gets bundled and sent to the browser, will be instrumented and included in coverage.

The test function and t variable are part of tap and document here.

The page object is part of puppeteer and documented here.

page.appendAndWait(htmlString, selector)

Appends the htmlString to the page's body and waits for the selector to return true.