Fornece verificações manuais e automatizadas, fixtures de teste, critérios de aceitação e orientações de remediação para navegação por teclado. Corrige limites de adoção e evidências observáveis de falha enquanto mantém limites específicos do ambiente configuráveis.
Status do pacote: contexto de referência pronto para revisão humana. O contrato e os cenários de teste estão completos, mas não se afirma que uma implementação adotante os tenha aprovado.
Decisão
Para navegação por teclado, adote primeiro a semântica nativa, com um contrato documentado de teclado e foco. Trate o bloco como um contrato de lançamento e regressão construído a partir de casos representativos positivos, de limite, negação, falha e recuperação. Este pacote é um contrato de referência: a equipe adotante deve escolher limites numéricos, provedores, jurisdições e responsáveis operacionais a partir de evidências em seu próprio ambiente.
Escopo
- Os atores, entradas, saídas, estados, versões de política ou esquema e resultados visíveis externamente descritos por este bloco de teste de navegação por teclado.
- Interfaces primárias e alternativas, trabalhos em segundo plano, caches, integrações, caminhos de suporte e evidências que podem exercitar o mesmo limite.
- Configuração específica de adoção, implantação, recuperação e responsabilidades de verificação necessárias para aplicar a referência com segurança.
Fora deste bloco
- Escolher um fornecedor universal, framework, jurisdição, limite numérico, período de retenção ou objetivo de nível de serviço para todos os adotantes.
- Afirmar que os cenários empacotados foram executados contra uma implementação a jusante ou que esta referência concede certificação legal, de segurança ou acessibilidade.
Contrato
- Expor um nome programático, papel, valor, estado e relacionamento sempre que a interface visual os comunicar.
- Toda ação é operável por teclado sem armadilhas, e a ordem do foco segue a ordem de leitura e interação.
- Anunciar status assíncronos ou erros sem mover o foco inesperadamente, e associar orientações de recuperação ao controle afetado.
- Preservar conteúdo e operação sob zoom, espaçamento de texto, reflow, cores forçadas, movimento reduzido e escala de texto da plataforma quando aplicável.
- Registrar versão do fixture, ambiente, configuração, resultado observado e localização da evidência para cada execução decisória.
- Separar falha do produto, falha de dependência, falha da infraestrutura de teste e evidência inconclusiva nos relatórios.
- Definir ordem de tabulação, comportamento de foco móvel ou descendente ativo, modelo de tecla de seta, ativação, dispensa, atalhos e restauração do foco para cada interação composta.
- Manter todas as ações acessíveis sem armadilhas de tempo ou gestos de ponteiro, expor foco visível em todos os temas e evitar sobrescrever comandos estabelecidos do navegador e da tecnologia assistiva.
Orientações de implementação
- Construa o menor conjunto determinístico de fixtures que abranja classes de risco, depois adicione casos derivados da produção somente após revisão segura de privacidade.
- Modele entradas, saídas, atores, estados, invariantes, efeitos colaterais e evidências da navegação por teclado antes de selecionar detalhes de framework ou fornecedor.
- Armazene a versão aplicável do contrato ou política de navegação por teclado com o estado material para que migrações, reprodução e decisões de suporte permaneçam atribuíveis.
- Introduza o caminho por trás da implantação controlada, compare resultados esperados e observados, e mantenha uma rota de recuperação testada até que a evidência de adoção esteja completa.
Tratamento de falhas e salvaguardas
- Se semântica ou foco não puderem ser preservados, a interação não é lançada atrás de comportamento apenas visual; o defeito permanece bloqueador de lançamento.
- Estado inválido ou contraditório de navegação por teclado é rejeitado ou colocado em quarentena; a implementação nunca supõe um valor que amplie autoridade ou duplique um efeito.
- Retentativas são limitadas e usam identidade durável; após exaustão, o trabalho alcança um estado terminal inspecionável com um responsável contabilizável.
Verificação e operações
- Execute a suíte duas vezes a partir de um estado limpo e confirme que ordenação, retentativas e execução paralela não alteram o veredicto.
- Monitore sucesso, negação, falha de validação, falha de dependência, exaustão de retentativas e recuperação da navegação por teclado por versão do contrato sem dimensões sensíveis de payload.
- Reexecute fixtures positivos e negativos pareados após mudanças de política, esquema, dependência, migração ou limite e preserve a evidência resultante.
Suposições de adoção
- Nomes e valores no exemplo são um fixture concreto, não padrões universais; adotantes os substituem por meio de evidência documentada e propriedade.
- O sistema adotante pode fornecer identidade autenticada, versões duráveis de operação ou registro, telemetria limitada e um caminho controlado para mudança.
Os exemplos com aparência executável neste pacote são fixtures e contratos de aceitação. Execute o validador da coleção para verificar estrutura e metadados, depois traduza e execute os cenários no repositório de destino antes de registrar evidências de implementação.