accesslint-scan

Audite uma página ativa e relate o que está quebrado e onde. Localize; não corrija. Se não houver URL em $ARGUMENTS, solicite um.

Quando Usar

• Uma página fornecida precisa de uma auditoria automatizada de contraste, nome-acessível ou marcação-semântica.
• Você precisa de descobertas baseadas em seletores após uma mudança na UI, sem modificar a aplicação.
• Verificações manuais de tecnologia assistiva ou avaliação de conformidade em todo o site são trabalhos separados.

1. Auditoria

Use uma instalação já revisada e fixada ao projeto de @accesslint/chrome e @accesslint/cli; confirme seus binários locais e a ajuda da CLI antes da execução. Não baixe e execute @latest silenciosamente. Confirme o URL e se o acesso pelo navegador poderia expor conteúdo autenticado ou sensível.

Para um projeto cuja instalação bloqueada expõe esses nomes de binários:

session_file="$(mktemp)"
./node_modules/.bin/accesslint-chrome ensure > "$session_file"

Leia o resultado JSON completo uma vez, registre port e managed, e substitua a porta retornada em ./node_modules/.bin/accesslint scan "<target>" --port "<returned-port>" --format json. Nunca analise pedaços arbitrários de stdout como JSON completo. Confirme os nomes reais dos binários dos pacotes instalados; eles podem diferir por versão. A forma atual do comando upstream é scan <target> --port <port> --format json.

Flags conforme necessário: --selector, --wait-for "<selector>", --include-aaa, --disable <rules>.

2. Relatório

Contagens por impacto, depois uma entrada por violação:

• onde — seletor exato + file:line (symbol) se source estiver presente — nunca fabrique. Se nenhuma violação tiver source, anote "mapeamento de origem indisponível — localizado apenas por seletor".
• evidência — proporção de contraste, atributo ausente, nome vazio
• correção — mudança mecânica ou NEEDS HUMAN

Retorne a lista de tarefas sem editar. A remediação requer uma tarefa autorizada separada; o nome upstream atual é accesslint:accessibility-fix, que pode não estar instalado neste host.

3. Desmontagem

Pare apenas a sessão de navegador gerenciada criada para esta auditoria, usando a operação de parada suportada pela ferramenta instalada, específica para sessão/porta. Se ela suportar apenas stop --all, verifique outras sessões gerenciadas primeiro e não termine auditorias não relacionadas. Pule a desmontagem de um navegador não gerenciado.

Armadilhas

• ensure sempre determina a porta — nunca codifique 9222.
• Saída da CLI 2 = URL inválido ou página nunca carregada; verifique o servidor de desenvolvimento.

Limitações

• Regras automatizadas não podem certificar a conformidade total com WCAG; retenha descobertas que exigem intervenção humana e registre falhas de varredura separadamente de zero violações.
• A forma da CLI upstream foi verificada contra a fonte de varredura do AccessLint; esta habilidade AAS não inclui a CLI nem a instala.
• Use esta habilidade apenas quando a tarefa corresponder claramente ao escopo descrito acima.
• Não trate a saída como substituta para validação específica do ambiente, testes ou revisão especializada.
• Pare e peça esclarecimentos se os inputs necessários, permissões, limites de segurança ou critérios de sucesso estiverem ausentes.