Axe DevTools Node Reporter API リファレンス

This page is not available in the language you requested. You have been redirected to the English version of the page.
Link to this page copied to clipboard

@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>