accessibility-insights-report
Accessibility Insights Report
Last updated 25 days ago by accessibility-insights-team .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install accessibility-insights-report 
SYNC missed versions from official npm registry.

accessibility-insights-report

Publish axe-core accessibility scan results as self-contained HTML files in the same format as accessibility-insights-web.

Usage

Before using accessibility-insights-report, you will need to run an axe accessibility scan to produce some axe results to convert. Typically, you would do this by using an axe integration library for your favorite browser automation tool (@axe-core/puppeteer, @axe-core/webdriverjs, cypress-axe).

accessibility-insights-report exports a factory that can be used to create a report object and output its results as HTML.

Use it like this:

import { reporterFactory } from "accessibility-insights-report";
import * as Axe from 'axe-core';
import { AxePuppeteer } from '@axe-core/puppeteer';
import * as fs from 'fs';
import * as Puppeteer from 'puppeteer';
import * as util from 'util';

test('my accessibility test', async () => {
    // This example uses @axe-core/puppeteer, but you can use any axe-based library
    // that outputs axe scan results in the default axe output format
    const browser = await Puppeteer.launch();
    const testPage = await browser.newPage();
    await testPage.setBypassCSP(true);
    await testPage.goto('https://www.example.com');

    const results: Axe.AxeResults = await new AxePuppeteer(testPage).analyze();

    // Construct the reporter object from the factory
    const reporter = reporterFactory();

    // Perform the conversion
    const html = reporter.fromAxeResult({
        results,
        description: "description of report",
        serviceName: "service name",
        scanContext: {
            pageTitle: await testPage.title(),
        }
    }).asHTML();

    // Output the HTML file for offline viewing in any modern browser
    await util.promisify(fs.writeFile)(
        'my-accessibility-test.html',
        JSON.stringify(html),
        { encoding: 'utf8' });
    await browser.close();
}

Contributing

To contribute, please visit accessibility-insights-web for more information.

Contributor License Agreement

This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.microsoft.com.

When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.

Code of Conduct

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.

Current Tags

  • 2.2.1                                ...           latest (25 days ago)

13 Versions

  • 2.2.1                                ...           25 days ago
  • 2.2.0                                ...           a month ago
  • 2.1.2                                ...           a month ago
  • 2.1.1                                ...           a month ago
  • 2.1.0                                ...           a month ago
  • 2.0.0                                ...           2 months ago
  • 1.0.3                                ...           5 months ago
  • 1.0.2                                ...           8 months ago
  • 1.0.1                                ...           8 months ago
  • 1.0.0                                ...           9 months ago
  • 0.1.0                                ...           a year ago
  • 0.0.2                                ...           a year ago
  • 0.0.1                                ...           a year ago
Downloads
Today 0
This Week 0
This Month 20
Last Day 0
Last Week 0
Last Month 25
Dependencies (9)
Dev Dependencies (0)
None

Copyright 2014 - 2016 © taobao.org |