Major versions of Pa11y CI can bring API or compatibility changes. This is a guide to help you make the switch when that happens.
Pa11y CI default concurrency when running tests is now set to 1 instead of the previous 2. This may slow down running of multiple tests but it will help Pa11y CI run more consistently on Continuous Integration environments with limited resources. Users can change this value by setting the concurrency property in the default configuration.
Pa11y CI now creates a new Incognito browser context by default for each page it tests. This will help pa11y-ci run tests more reliably as the state of a page will not depend on pages tested previous any more. This also means that cookies by default won't be shared between different pages on the same origin. If your tests depend on cookies being shared between different tests, you can use the useIncognitoBrowserContext in the default configuration to revert to the previous behaviour.
Pa11y CI 2.0 only supports Node.js v8.0.0 and higher, you'll need to upgrade to be able to use the latest versions of Pa11y CI.
Pa11y CI now uses Pa11y 5.0 to run its tests, which has introduced numerous changes to the underlying test runner.
Most importantly for upgrading your Pa11y CI, the new version of Pa11y has removed or renamed numerous Configuration options. If you are using one of these old configuration options, they will no longer be effective in Pa11y CI 2.0.
You can read more about all of the other changes to Pa11y in the Pa11y Migration Guide