Axe DevTools Node Reporter API リファレンス
@axe-devtools/reporter パッケージのAPIリファレンス
Not for use with personal data
このドキュメントは、AxeDevToolsReporterクラスが提供するメソッドについて説明します。
AxeDevToolsReporterクラスは@axe-devtools/loggerパッケージのAxeDevToolsLoggerクラスを拡張しており、AxeDevToolsReporterのインスタンスを作成し、AxeDevToolsLoggerクラスが提供するメソッドを呼び出すことができます。Axe DevTools Logger リファレンスを参照して、AxeDevToolsLoggerクラスが提供するメソッドに関する詳細情報をご覧ください。
コンストラクター
constructor(reportName: string, directory?: string)使用例:
const axeReporter = new AxeDevToolsReporter("AxeDevTools-Results", "./test-results/");パラメータ
| 名前 | タイプ | 説明 |
|---|---|---|
| reportName | 文字列 | レポートのタイトル。reportNameの値は、JSON結果のファイル名の最初のセグメントになります。 |
| ディレクトリ | 文字列(オプション) | レポートが書き込まれるディレクトリ。指定されたディレクトリが存在しない場合は、再帰的に作成されます。 |
メソッド
これらのメソッドのそれぞれは、logTestResultメソッドによって生成された結果JSONファイルから指定されたレポートを作成します。
| 名前 | 説明 |
|---|---|
| buildCSV | CSVレポートを作成 |
| buildEARL | W3C EARL JSON-LDレポートを作成 |
| buildHTML | HTMLレポートを作成 |
| buildJUnitXML | XMLレポートを作成 |
buildCSV
logTestResultメソッドによって作成された結果JSONファイルからCSVファイルを作成します。
buildCSV(directory: string, userAgent?: string, filterOpts?: string[]): Promise<void>;パラメータ
| 名前 | タイプ | 説明 |
|---|---|---|
| ディレクトリ | 文字列 | 出力用の .csv ファイルを作成するディレクトリ。ディレクトリが存在しない場合にはすべて再帰的に作成されます。 |
| ユーザーエージェント | 文字列(オプション) | 指定されたユーザーエージェントの結果のみが .csv ファイルに表示されます |
| filterOpts | 文字列の配列(任意) | 結果を選択するためのフィルタオプションの配列。 |
返り値
Promise<void>buildEARL
指定されたディレクトリにaxe-devtools-results.earl.jsonという名前のW3C EARL (Evaluation and Report Language) JSON-LDファイルを作成します。
note
EARL出力はAxe DevTools Mobileの結果をサポートしていません。モバイルの結果が存在する場合、buildEARLはファイルを書き始める前にエラーをスローします。
buildEARL(directory: string, userAgent?: string): Promise<void>;パラメータ
| 名前 | タイプ | 説明 |
|---|---|---|
| ディレクトリ | 文字列 | 出力.earl.jsonファイルを作成するディレクトリ。すべてのディレクトリは、既に存在しない場合は再帰的に作成されます。 |
| ユーザーエージェント | 文字列(オプション) | 指定されたユーザーエージェントの結果のみが EARL レポートに表示されます |
返り値
Promise<void>buildHTML
指定されたディレクトリに、アクセシビリティ結果 JSON ファイルから HTML ファイルを作成します。
buildHTML(directory: string, userAgent?: string): Promise<void>;パラメータ
| 名前 | タイプ | 説明 |
|---|---|---|
| ディレクトリ | 文字列 | 出力用の .html ファイルを作成するディレクトリ。ディレクトリが存在しない場合にはすべて再帰的に作成されます。 |
| ユーザーエージェント | 文字列(オプション) | 指定されたユーザーエージェントの結果のみが .html レポートファイルに表示されます |
返り値
Promise<void>buildJUnitXML
指定されたディレクトリに、JSON のアクセシビリティ結果から JUnit XML ファイルを作成します。
buildJUnitXML(directory: string, userAgent?: string): Promise<void>;パラメータ
| 名前 | タイプ | 説明 |
|---|---|---|
| ディレクトリ | 文字列 | 出力用の.xmlファイルを作成するディレクトリ。ディレクトリが既に存在しない場合は、すべて再帰的に作成されます。 |
| ユーザーエージェント | 文字列(オプション) | 指定したユーザーエージェントでの結果のみが.xmlレポートファイルに表示されます |
返り値
Promise<void>