queryNuHtmlChecker static method
Sends htmlContent to an external Nu HTML Checker instance (W3C v.Nu) for standards validation.
Handles validator availability and network timeouts honestly without falsely reporting passed.
Guarantees that the underlying HttpClient is closed cleanly.
Implementation
static Future<ExternalStandardsValidationResult> queryNuHtmlChecker(
String htmlContent, {
String? endpointUrl,
Duration timeout = const Duration(seconds: 15),
}) async {
final url =
endpointUrl ??
Platform.environment['VNU_URL'] ??
'https://validator.w3.org/nu/?out=json';
final client = HttpClient()..connectionTimeout = timeout;
try {
final uri = Uri.parse(url);
final request = await client.postUrl(uri);
request.headers.set('Content-Type', 'text/html; charset=utf-8');
request.headers.set('User-Agent', 'MetaMantle-HtmlValidator/0.3.0');
request.write(htmlContent);
final response = await request.close().timeout(timeout);
if (response.statusCode != 200) {
return ExternalStandardsValidationResult(
status: ExternalStandardsValidationStatus.unavailable,
validatorName: 'Nu HTML Checker ($url)',
reason: 'Validator returned HTTP status ${response.statusCode}',
);
}
final responseBody = await response.transform(utf8.decoder).join();
dynamic decoded;
try {
decoded = json.decode(responseBody);
} catch (e) {
return ExternalStandardsValidationResult(
status: ExternalStandardsValidationStatus.unavailable,
validatorName: 'Nu HTML Checker ($url)',
reason: 'Validator returned invalid non-JSON response: $e',
);
}
final messages = <String>[];
var hasErrors = false;
if (decoded is Map && decoded['messages'] is List) {
for (final msg in decoded['messages'] as List) {
if (msg is Map) {
final type = msg['type']?.toString() ?? 'info';
final text = msg['message']?.toString() ?? '';
final line = msg['lastLine']?.toString() ?? '?';
messages.add('[$type line $line] $text');
if (type == 'error') {
hasErrors = true;
}
}
}
}
return ExternalStandardsValidationResult(
status: hasErrors
? ExternalStandardsValidationStatus.failed
: ExternalStandardsValidationStatus.passed,
validatorName: 'Nu HTML Checker ($url)',
messages: messages,
);
} catch (e) {
return ExternalStandardsValidationResult(
status: ExternalStandardsValidationStatus.unavailable,
validatorName: 'Nu HTML Checker ($url)',
reason: 'Connection to validator failed or timed out: $e',
);
} finally {
client.close(force: true);
}
}