Saltar para o conteúdo

Barcode Scanner Emulator

Como testar leitores de códigos de barras em aplicações web

Muitos leitores de códigos de barras USB e Bluetooth enviam os dados descodificados como introdução de teclado, pelo que um campo com foco numa aplicação web pode receber uma leitura sem uma API de navegador própria do leitor. As portas série e os SDK do fabricante são integrações distintas. Pode testar o percurso do teclado com um leitor físico ou com premidas simuladas.

Uma aplicação web vê, em regra, um leitor de códigos de barras como um teclado. O teste verifica se o controlo com foco recebe a carga que a aplicação espera e se a página trata o terminador que o leitor está configurado para enviar. Esse terminador pode ser Enter, Tab ou nada.

Utilize uma sessão do testador de introdução de códigos de barras quando um leitor físico estiver ligado. Utilize o Barcode Scanner Emulator quando precisar do mesmo percurso de teclado durante o desenvolvimento e o equipamento não estiver na secretária. Uma passagem mais ampla pelo foco, pela disposição e pelos fluxos de POS está em Como testar a introdução do leitor de códigos de barras. Este guia permanece na aplicação do navegador: captação, sufixos, validação e os eventos que é possível observar.

Como os leitores de códigos de barras comunicam com as aplicações web

O modo de interface decide o que a página pode receber. Confirme-o antes de alterar o código do formulário. Um leitor pode, muitas vezes, mudar de modo ao ler um código de barras de configuração do manual do fabricante.

Cunha de teclado HID USB

No modo de teclado HID USB o leitor enumera-se como um teclado. O sistema operativo carrega o controlador de teclado habitual. Depois de descodificar um símbolo, o leitor envia os caracteres como premidas para o controlo que tem o foco do teclado. A página escuta essas premidas ou lê o texto que elas inserem. Não abre uma ligação ao dispositivo.

É por isso que um campo de caixa, uma caixa de pesquisa ou qualquer outra introdução de texto pode aceitar uma leitura com HTML corrente. O guia Cunha de teclado HID descreve a sequência de premidas, os prefixos e os sufixos com mais pormenor.

HID Bluetooth

Um leitor Bluetooth emparelhado como teclado usa o mesmo percurso da aplicação. O anfitrião trata-o como um teclado HID, e o campo com foco recebe as premidas. O emparelhamento, a bateria e o rádio são assuntos do aparelho. Quando os caracteres chegam ao navegador, a página trata-os da mesma forma que a introdução de uma cunha USB.

Porta série e porta COM virtual

Um leitor série, incluindo muitos modos de porta COM virtual USB, envia o texto descodificado como bytes numa porta. O foco não escolhe o destino. Escolhe-o o processo que abre a porta. Um campo de texto que apenas escuta premidas não vê esse fluxo.

Os navegadores baseados em Chromium podem abrir uma porta série através da Web Serial API depois de o utilizador seleccionar a porta e conceder a permissão. O Firefox e o Safari não disponibilizam essa API. Um ensaio de cunha não exercita uma integração série, e um ensaio série não diz o que um leitor em cunha irá escrever.

Interfaces próprias do fabricante

Alguns aparelhos usam um SDK do fabricante, OPOS, JPOS ou uma interface HID que não é teclado, como USB HID POS. Essas interfaces não escrevem no campo com foco. Uma página web normal não consegue carregar um SDK nativo. O Chromium pode pedir alguns dispositivos HID que não são teclado através de WebHID, após um gesto do utilizador. Os dispositivos HID da classe teclado permanecem bloqueados, pelo que um leitor em cunha continua indistinguível de um teclado. Trate uma interface de fabricante como uma integração própria e ensaie-a com o software que abre de facto essa interface.

O que o navegador consegue ver

Uma leitura em cunha chega como eventos keydown e keyup, e os caracteres imprimíveis actualizam o campo com foco. O navegador não recebe um nome de dispositivo, um número de série USB nem uma marca que indique tratar-se de um leitor. Os navegadores que implementam WebHID continuam a recusar interfaces de teclado, pelo que o script da página também não consegue ler os relatórios HID em bruto de um leitor em cunha.

event.key é o carácter ou o nome da tecla depois de o sistema operativo aplicar a disposição de teclado activa. event.code nomeia a tecla física, como Digit1 ou Numpad1, e pode manter-se igual quando uma disposição divergente altera event.key. Nenhuma das duas propriedades identifica o equipamento.

Como testar um leitor de códigos de barras físico num navegador

Faça isto antes de depurar o código da aplicação. Mostra a cadeia exacta e o terminador que o navegador recebeu.

  1. Ligue o leitor e espere até indicar que tem alimentação. No Bluetooth, conclua o emparelhamento e confirme que o anfitrião usa um perfil de teclado.
  2. Confirme o modo de introdução. A cunha de teclado, o teclado HID USB ou o teclado HID Bluetooth podem escrever num campo. Os modos série, SPP e SDK do fabricante não.
  3. Abra o testador de introdução de códigos de barras.
  4. Clique em Iniciar teste ou na área de leitura. Fica azul quando está pronta. A página não toma o foco por si.
  5. Leia um código de barras cuja carga já conhece. Comece por um valor numérico curto e depois leia um valor que inclua a pontuação que a aplicação guarda.
  6. Leia o valor captado e a contagem de caracteres. Compare ambos com a carga esperada, incluindo qualquer prefixo que o leitor insira antes dos dados.
  7. Verifique o sufixo. O testador indica ENTER, TAB ou Nenhum. Com Captura automática ligada, o resultado aparece após Enter, Tab ou uma pausa breve quando as teclas param. Desligue Captura automática quando quiser que a captação fique retida até premir Parar.
  8. Compare esse resultado com a cadeia que a aplicação deve guardar. Um prefixo, um carácter substituído ou um terminador em falta deve ser corrigido na configuração do leitor ou tratado de propósito na página. Não o trate como uma falha de descodificação enquanto esta comparação não estiver feita.

O testador regista os eventos de teclado que o navegador consegue ver. Não identifica o dispositivo USB nem lê uma porta série. Quando um editor de texto recebe a leitura e o navegador não, continue com Funciona no Notepad mas falha no POS.

Captar a introdução do leitor de códigos de barras com JavaScript

Um leitor escreve no elemento que tem o foco. Dê ao campo um rótulo visível, deixe-o como uma introdução de texto normal para que quem usa o teclado possa escrever um código, e leia o valor quando o fluxo indicar que a introdução está completa. A página abaixo faz isso. Enter submete o formulário uma vez. Tab conclui um valor não vazio e depois deixa o navegador mover o foco. Uma leitura sem terminador permanece no campo até alguém activar Look up.

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>Barcode input example</title>
</head>
<body>
  <form id="barcode-form">
    <label for="barcode">Barcode</label>
    <input id="barcode" name="barcode" type="text" autocomplete="off" spellcheck="false">
    <button type="submit">Look up</button>
  </form>
  <p id="message" role="status"></p>
  <ul id="accepted"></ul>
  <script>
    const form = document.querySelector('#barcode-form')
    const field = document.querySelector('#barcode')
    const message = document.querySelector('#message')
    const list = document.querySelector('#accepted')

    if (
      !(form instanceof HTMLFormElement) ||
      !(field instanceof HTMLInputElement) ||
      !(message instanceof HTMLElement) ||
      !(list instanceof HTMLUListElement)
    ) {
      throw new Error('Barcode form markup is missing.')
    }

    function payload(raw) {
      return raw.replace(/[\r\n]/g, '').trim()
    }

    function classify(raw) {
      const value = payload(raw)
      if (!value) {
        return { status: 'empty' }
      }
      if (/[\u0000-\u001F\u007F]/.test(value)) {
        return {
          status: 'invalid',
          message: 'Control character in the barcode. Check the prefix, suffix, and symbology identifier.',
        }
      }
      return { status: 'ok', value }
    }

    function accept(value) {
      const item = document.createElement('li')
      item.textContent = value
      list.append(item)
      message.textContent = 'Accepted ' + value
      field.value = ''
    }

    function reject(text) {
      message.textContent = text
    }

    form.addEventListener('submit', (event) => {
      event.preventDefault()
      const outcome = classify(field.value)
      if (outcome.status === 'empty') {
        reject('No barcode received.')
        field.focus()
        return
      }
      if (outcome.status === 'invalid') {
        reject(outcome.message)
        field.focus()
        return
      }
      accept(outcome.value)
      field.focus()
    })

    field.addEventListener('keydown', (event) => {
      if (event.key !== 'Tab' || event.shiftKey) {
        return
      }
      const outcome = classify(field.value)
      if (outcome.status === 'empty') {
        return
      }
      if (outcome.status === 'invalid') {
        event.preventDefault()
        reject(outcome.message)
        return
      }
      accept(outcome.value)
    })

    field.focus()
  </script>
</body>
</html>

Guarde esse ficheiro e abra-o num navegador de secretária. Clique no campo se o foco se tiver deslocado. Um leitor em cunha, ou o emulador da secção seguinte, escreve então em #barcode.

O foco é necessário. Se document.activeElement for o corpo do documento, um botão ou outra introdução, os escutadores deste campo não vêem a leitura. Os caracteres caem no controlo com foco ou perdem-se. Chame field.focus() quando o fluxo estiver pronto para uma leitura, inclusive depois de uma caixa de diálogo fechar.

Uma introdução vazia é ignorada. O formulário permanece no lugar, e o texto de estado diz que nada foi recebido. O espaço em branco, por si, fica vazio após trim().

O exemplo não acrescenta Enter nem Tab. Se o leitor não estiver configurado para os enviar, o valor permanece no campo e Look up é o caminho de conclusão. autocomplete="off" reduz a hipótese de um valor gravado substituir a leitura. O rótulo, o botão e Shift+Tab continuam disponíveis, para que uma pessoa possa introduzir um código sem leitor.

Trate Enter num único sítio. Este exemplo usa o evento submit do formulário, que também cobre o botão Look up e um Enter do teclado. Um segundo escutador keydown para Enter registaria a mesma leitura duas vezes. Se a introdução não estiver dentro de um formulário, escute Enter em keydown e chame preventDefault() para que um formulário ascendente também não seja submetido:

field.addEventListener('keydown', (event) => {
  if (event.key !== 'Enter') {
    return
  }

  event.preventDefault()
  const value = field.value.trim()
  if (!value) {
    return
  }

  console.log(value)
  field.value = ''
})

Limpe o campo após uma aceitação bem-sucedida, para que a leitura seguinte não se junte à carga anterior. Após Enter, o exemplo volta a focar o mesmo campo, porque esse fluxo espera outra leitura na mesma caixa. Após Tab, deixa o foco quieto para o navegador poder passar ao controlo seguinte.

Tratamento dos sufixos ENTER e TAB

Um sufixo é uma tecla que o leitor pode enviar após a carga. É uma definição do aparelho. Enter é comum e é facultativo. O guia Sufixos ENTER e TAB nos leitores de códigos de barras descreve como distinguir os terminadores. Confirme a definição no leitor que está a testar e depois faça a página corresponder a esse fluxo.

ENTER

Enter dentro de um campo de texto de uma linha submete o formulário envolvente nos navegadores actuais. Use-o quando uma leitura deve confirmar o valor, como numa caixa de consulta. preventDefault() no evento submit impede o navegador de sair da página. Omita-o quando uma navegação de página inteira for o comportamento pretendido.

Se o código de barras aparece e o formulário nada faz, o leitor pode não estar a enviar sufixo. Leitor de códigos de barras sem ENTER percorre essa configuração. Alguns aparelhos enviam NumPad Enter. event.key continua a ser "Enter". Verifique event.key, e não apenas event.code === "Enter", caso contrário esse leitor parecerá avariado.

TAB

Tab move o foco para o controlo seguinte que o pode receber. Serve para uma sequência como código do artigo e depois quantidade. Surpreende um formulário que esperava que Enter submetesse os dados.

Leia o valor em keydown enquanto o campo ainda tem o foco. O navegador move o foco depois desse evento. Deixe a acção predefinida no lugar quando o controlo seguinte deve receber o foco. preventDefault() mantém o foco onde está, o que é útil quando o valor é inválido e pretende que o operador o veja. Ignore Shift+Tab para que quem usa o teclado possa recuar no formulário. Um sufixo Tab do leitor é Tab sem Shift.

Um sufixo Tab também pode mover o foco antes de o código ler o campo, se o escutador estiver em blur ou change e outra coisa limpar o controlo. Leia o valor a partir do target do evento keydown.

Sem sufixo

Sem sufixo, a carga fica no campo. A aplicação tem de decidir quando a leitura terminou. Um botão explícito, um Enter posterior do operador ou a passagem a outro passo são pontos de conclusão fiáveis. Um temporizador de inactividade pode tratar uma pausa na escrita como o fim de uma leitura. Esse temporizador é uma heurística. Um leitor lento, um atraso de Bluetooth ou uma pessoa que escreve depressa pode cair do lado errado do limiar. Prefira um sufixo configurado quando o fluxo precisa de um sinal firme de fim de leitura.

Diferenças de configuração

Leitores da mesma marca podem sair com sufixos diferentes, e um código de barras de configuração pode alterar o sufixo sem qualquer mudança no JavaScript. Alguns aparelhos enviam um prefixo, um identificador de simbologia como ]C1, ou CR e LF. Ensaie as três definições de terminador que os utilizadores podem escolher de facto: Enter, Tab e nenhum. Registe qual os leitores instalados usam e teste a página contra essa definição.

Validação da introdução do leitor de códigos de barras

Valide a cadeia que o campo recebeu. Não presuma que todos os códigos de barras têm o mesmo comprimento, o mesmo conjunto de caracteres ou a mesma soma de controlo. As cargas de Code 128 e QR variam. O EAN-13 tem 13 algarismos. Uma aplicação que guarda ambos precisa de regras para ambos.

Introdução vazia. Rejeite-a ou ignore-a. Um sufixo sem carga, ou um clique em Look up num campo em branco, não deve criar um registo.

Caracteres inesperados. Compare a cadeia recebida com uma etiqueta conhecida. Uma disposição divergente surge muitas vezes como um símbolo alterado, por exemplo um algarismo ou uma pontuação deslocados, enquanto o comprimento se mantém. Caracteres de controlo podem vir de um prefixo ou de um separador de grupo GS1. Permita os caracteres que o formato define. O exemplo acima rejeita caracteres de controlo ASCII para que permaneçam visíveis no texto de estado. Um analisador GS1 que espera um separador de grupo deve permitir esse carácter e rejeitar o resto.

Comprimento. Aplique os comprimentos que a aplicação aceita. Um mínimo e um máximo globais são mais seguros do que um único comprimento obrigatório quando o formulário recebe mais de uma simbologia. maxlength na introdução trunca em silêncio uma carga mais longa, pelo que só o defina quando cada código aceite couber.

Prefixo. Retire um prefixo apenas quando configurou o leitor para enviar exactamente esse prefixo e a aplicação não o guarda.

function withoutConfiguredPrefix(value, prefix) {
  if (prefix && value.startsWith(prefix)) {
    return value.slice(prefix.length)
  }
  return value
}

Um identificador de simbologia AIM é um dado se o leitor está definido para o transmitir. Deixe-o no lugar até decidir se a aplicação o guarda.

Sufixo. Mantenha o terminador fora do valor guardado. Enter e Tab são teclas. Não são inseridos numa introdução de texto normal. Uma carga série pode ainda incluir bytes CR ou LF. Retire-os na fronteira em que analisa o fluxo série e verifique que não os retira do meio de uma carga que os contém de forma legítima.

Submissões em duplicado. Uma leitura pode ser tratada duas vezes se tanto keydown como submit correrem para o mesmo Enter. Use um único caminho de conclusão. Uma segunda leitura do mesmo código é outra questão. Um formulário de armazém pode incrementar a quantidade. Um formulário de bilhete pode rejeitar um código já utilizado. Coloque essa regra na aplicação e ensaie-a de propósito. O navegador não distingue um segundo accionamento do gatilho de um segundo escutador.

Regras da aplicação. As somas de controlo pertencem a simbologias concretas. O EAN-13 usa o último algarismo como dígito de controlo. Esta função aceita apenas esse formato:

function isEan13(value) {
  if (!/^\d{13}$/.test(value)) {
    return false
  }

  let sum = 0
  for (let index = 0; index < 12; index += 1) {
    const digit = Number(value[index])
    sum += index % 2 === 0 ? digit : digit * 3
  }

  const check = (10 - (sum % 10)) % 10
  return check === Number(value[12])
}

Code 128, Code 39 e QR não usam esse cálculo. O leitor pode já ter verificado a própria simbologia e transmitido os dados legíveis. Valide os formatos que guarda e repita a verificação no servidor. A cadeia enviada é introdução de utilizador corrente. O navegador não pode provar que um leitor a produziu.

Testar a introdução do leitor sem equipamento físico

O Barcode Scanner Emulator é uma aplicação de secretária para Windows, macOS e Linux. Introduz o texto a enviar, escolhe um atraso de escrita e escolhe um sufixo entre nenhum, ENTER ou TAB. Um atalho global escreve esse texto na aplicação com foco. Reproduz o percurso de teclado que um leitor em cunha usa. Não ilumina uma etiqueta, não lê um símbolo e não descodifica uma simbologia.

Utilize a página de exemplo acima ou a página que está a construir:

  1. Abra a página num navegador de secretária e clique no campo do código de barras.
  2. No emulador, introduza um valor conhecido como 123456789012.
  3. Defina o sufixo como ENTER. Ajuste o atraso de escrita se quiser que a rajada se pareça com um leitor que já mediu.
  4. Prima o atalho global de leitura do emulador enquanto o campo do navegador ainda tem o foco.
  5. Confirme o texto de estado e que o valor foi aceite uma vez.
  6. Repita com TAB. O foco deve deslocar-se, e o valor deve ser aceite uma vez.
  7. Repita sem sufixo. O texto deve permanecer no campo até activar Look up.
  8. Dê o foco ao testador de introdução de códigos de barras e envie de novo o mesmo valor. Compare a cadeia captada, o prefixo e o sufixo com o que a aplicação guardou.

A instalação e o primeiro atalho estão em Começar. Após uma alteração de definições, envie uma leitura para o testador de introdução antes de confiar no resultado da aplicação.

O equipamento continua a ser necessário para as partes ópticas e próprias do aparelho do ensaio:

  • Se aquele leitor consegue descodificar o símbolo impresso ou apresentado, incluindo etiquetas danificadas, tamanho, contraste e distância.
  • Suporte de simbologias. Um leitor laser 1D não consegue ler um código QR. Consulte Teste de códigos QR: como testar leitores de códigos QR.
  • Enumeração USB, emparelhamento Bluetooth e a configuração própria do leitor para a disposição do teclado e o sufixo.
  • Integrações série, HID POS e SDK do fabricante.

O emulador é a ferramenta certa para a lógica da aplicação ao longo do percurso do teclado. É a ferramenta errada para provar que um leitor concreto lê uma etiqueta concreta.

Depurar eventos de teclado do leitor de códigos de barras

Observe os eventos por esta ordem quando o valor guardado está errado.

keydown. Dispara para cada tecla, incluindo Enter e Tab, antes de o navegador inserir um carácter ou mover o foco. Leia o terminador aqui. event.repeat é verdadeiro quando uma tecla fica premida. Um leitor em cunha envia, em regra, uma pressão distinta para cada carácter.

input. Dispara no campo depois de um carácter imprimível alterar o valor. É o evento certo a observar se precisar do texto à medida que cresce. Não dispara para Enter nem para Tab, porque essas teclas não inserem um carácter numa introdução de texto.

change. Dispara depois de o valor ser confirmado, em geral quando o campo perde o foco. Um leitor que deixa o foco no mesmo campo não produz change no fim da leitura. Não use change como único sinal de conclusão.

event.key e event.code. Registe ambos quando um carácter está errado. Uma divergência entre a disposição do leitor e a do sistema operativo altera event.key e deixa event.code como a tecla que o leitor pretendia. Os algarismos do teclado numérico usam Numpad1 e códigos semelhantes. Algumas máscaras de introdução tratam-nos de forma diferente de Digit1. Disposição de teclado errada no leitor de códigos de barras explica a divergência de disposição.

Foco. Registe document.activeElement imediatamente antes de uma leitura. Se não for o campo do código de barras, o resto do rasto explica o controlo errado. Os iframes têm o próprio foco. Uma leitura num quadro incorporado é visível para o script dentro desse quadro.

Temporização. Os leitores terminam muitas vezes uma carga curta bastante abaixo de um segundo. O testador de introdução compara o intervalo médio entre caracteres com um limiar de 100 ms e rotula o resultado como temporização, não como identificação do equipamento. Um limiar de intervalo pode tratar quem escreve depressa, o preenchimento automático ou o emulador como um leitor. Um leitor com atraso entre caracteres, uma ligação Bluetooth ou uma carga longa pode parecer escrita. Use o valor captado e o sufixo. Use a temporização como pista.

O testador de eventos de teclado lista cada keydown e keyup com key, code, modificadores e marcas de tempo. Utilize-o quando a cadeia montada esconde uma tecla de prefixo ou um código de teclado numérico. O registo são eventos do navegador. Não é tráfego USB em bruto.

Problemas frequentes em aplicações web

A leitura vai para o campo errado. A introdução em cunha segue o foco. Clique no campo de destino após cada navegação, caixa de diálogo ou mensagem de validação que desloque o foco. Um modal sem campo de texto pode engolir a leitura como atalhos de teclado.

O leitor funciona num editor de texto e não no navegador. O aparelho está a escrever. A página não está a aceitar essas teclas. Verifique o foco, uma introdução desactivada ou só de leitura e um escutador keydown que chame preventDefault() em teclas imprimíveis. Um escutador que apenas trata paste nunca vê a introdução em cunha. Comece por O leitor de códigos de barras não funciona se nenhuma aplicação recebe caracteres.

Enter submete o formulário duas vezes ou sai da página. O navegador submete o formulário, e o escutador também trata Enter. Chame preventDefault() num desses percursos e processe o valor uma vez. Um formulário de vários campos pode ser submetido antes de os campos seguintes estarem preenchidos quando o leitor envia Enter. Use Tab para esse fluxo ou impeça a submissão até o formulário estar completo.

Tab muda o foco. Essa é a tecla Tab. Configure Enter no leitor ou leia o valor em keydown e permita o movimento do foco. Veja a secção dos sufixos acima.

A disposição do teclado está errada. Os algarismos podem sobreviver a uma divergência que altera a pontuação. Leia um valor conhecido que contenha os símbolos que guarda, na disposição que o posto usa de facto.

A mesma leitura cria dois registos. Procure dois escutadores num mesmo Enter antes de procurar duas leituras físicas. Depois ensaie uma segunda leitura de propósito e confirme a regra de quantidade ou de duplicado que a aplicação documenta.

O valor falta ou está truncado. Um atributo maxlength, uma máscara de introdução ou preventDefault() em teclas de carácter podem descartar ou cortar a carga. Compare a contagem de caracteres no testador de introdução com o valor do campo. Um prefixo também pode fazer uma carga correcta parecer demasiado longa.

Os códigos QR nunca aparecem. O leitor pode ser apenas 1D, ou a simbologia QR pode estar desactivada. A aplicação não consegue corrigir isso. Confirme o equipamento com Teste de códigos QR: como testar leitores de códigos QR e volte ao ensaio do campo.

Lista de verificação para testar a aplicação web

Utilize-a na compilação que pretende publicar, em cada navegador que suporta. Verifique um perfil novo e também um perfil com extensões de gestor de palavras-passe e de preenchimento automático, porque essas extensões deslocam o foco.

  • O leitor está ligado ou emparelhado, e o anfitrião mostra-o pronto.
  • O leitor está em modo de cunha de teclado, não em série nem num modo SDK do fabricante.
  • O campo do código de barras tem o foco imediatamente antes da leitura. document.activeElement é esse campo.
  • Um código de barras conhecido chega carácter a carácter, comprimento incluído.
  • Um sufixo ENTER submete ou aceita o valor uma vez e não deixa o terminador na cadeia guardada.
  • Um sufixo TAB move o foco para o controlo pretendido, e o valor é lido antes do movimento.
  • Uma configuração sem sufixo deixa o valor disponível até a aplicação o concluir.
  • Uma submissão vazia é rejeitada ou ignorada.
  • Uma leitura não cria dois registos. Uma segunda leitura real segue a regra de duplicado da aplicação.
  • A pontuação, os símbolos e qualquer separador GS1 que os formatos usem sobrevivem à ida e volta.
  • A disposição de teclado do leitor e a do sistema operativo produzem os caracteres impressos na etiqueta.
  • Depois de desligar e voltar a ligar, ou depois de a ligação Bluetooth cair, a leitura seguinte continua a chegar ao campo.
  • Várias leituras seguidas permanecem valores separados. O campo não os concatena.
  • As mesmas verificações passam nos navegadores que suporta, com e sem extensões habituais de preenchimento automático.

Para caixas de diálogo, a ordem de tabulação num checkout completo e os fluxos de quantidade no POS, continue com Como testar a introdução do leitor de códigos de barras.

Matriz de casos de teste

A coluna do leitor é o que o aparelho e o navegador fazem. A coluna de comportamento esperado é o que a aplicação deve fazer em resposta. As regras de negócio, como um código de artigo repetido incrementar a quantidade, pertencem à aplicação. Declare-as no ensaio em vez de presumir uma regra única para cada artigo.

Cenário Comportamento esperado
Código de barras válido A aplicação aceita o valor e guarda a carga sem o terminador.
Introdução vazia A aplicação rejeita-a ou ignora-a e não cria um registo.
Sufixo ENTER A aplicação submete ou aceita o valor uma vez.
Sufixo TAB O foco passa ao controlo seguinte pretendido, e o valor é mantido.
Sem sufixo A introdução permanece disponível até a aplicação a processar.
Leituras rápidas consecutivas Cada valor é processado à parte e não é concatenado com o anterior.
Disposição de teclado errada Caracteres inesperados ficam visíveis no valor captado e falham a validação.
Leitura em duplicado A aplicação segue a própria regra de duplicado, como incrementar a quantidade ou rejeitar uma repetição.
Formato de código de barras inválido A aplicação mostra o erro de validação desse formato e não guarda o valor.
Foco de introdução perdido A aplicação não inventa um código de barras. A leitura está ausente ou cai no controlo com foco, e a página permanece num estado seguro.

Execute as linhas de válido, vazio, ENTER, TAB e sem sufixo com o leitor físico e de novo com o emulador. Execute as linhas de disposição do teclado, QR e religação no equipamento. Essas linhas dependem do aparelho, da etiqueta ou da disposição do sistema operativo, o que premidas simuladas não reproduzem.