pa11y-reporter-csv's Introduction

Pa11y CSV Reporter

A CSV reporter for Pa11y 5.0.

⚠️ this reporter is built into Pa11y, there's no need to install separately ⚠️

Requirements
- Compatibility chart
Usage
- Command-Line
- JavaScript
Contributing
License

Requirements

Pa11y CSV Reporter is compatible with Pa11y 5 and later versions. It will not work with older versions of Pa11y.

Compatibility chart

Pa11y version	Pa11y CLI reporter version
1.x - 4.x	Unsupported
5.x	1.x
6.x	2.x

Usage

Command-Line

Install Pa11y and Pa11y CSV Reporter with npm (locally or globally is fine):

npm install -g pa11y pa11y-reporter-csv

Run Pa11y using the CSV reporter:

pa11y --reporter csv http://example.com

JavaScript

Assuming you've installed both Pa11y and Pa11y CSV Reporter:

const csv = require('pa11y-reporter-csv');
const pa11y = require('pa11y');

pa11y('http://example.com').then(results => {
    // Returns a string with the results formatted as CSV
    const csvResults = csv.results(results);
    console.log(csvResults);
});

Contributing

There are many ways to contribute to Pa11y CSV Reporter, we cover these in the contributing guide for this repo.

If you're ready to contribute some code, clone this repo locally and commit your code on a new branch.

Please write unit tests for your code, and check that everything works by running the following before opening a Pull Request:

make ci

You can also run verifications and tests individually:

make verify              # Verify all of the code (ESLint)
make test                # Run all tests
make test-unit           # Run the unit tests
make test-unit-coverage  # Run the unit tests with coverage