Salta al contingut

Barcode Scanner Emulator

Com provar l'entrada d'un escàner de codis QR en aplicacions web

Molts escàners externs compatibles amb QR fan servir el mode de falca de teclat i escriuen el text QR descodificat al camp amb el focus. Proveu aquest camí llegint una càrrega coneguda i comparant-la amb el valor que ha rebut la pàgina. No tots els escàners QR escriuen com un teclat. Els dispositius sèrie i els descodificadors de càmera són integracions diferents, i els esdeveniments de teclat del navegador no identifiquen l'escàner físic.

Un codi QR emmagatzema dades. L'escàner, o un descodificador de càmera, converteix aquestes dades en text. L'aplicació web ha de rebre aquest text, decidir quan la lectura s'ha acabat i validar-lo. Aquesta guia és aquesta prova de l'aplicació. La generació d'etiquetes, la comprovació del contrast i la confirmació que un dispositiu pot descodificar QR Code es tracten a Proves de codis QR: com provar escàners de codis QR. Els formularis generals de codis de barres, inclosos els dígits de control EAN, es tracten a Com provar escàners de codis de barres en aplicacions web.

Proveu l'entrada de l'escàner QR en 60 segons

Feu servir una càrrega que hàgiu triat, perquè un caràcter incorrecte sigui evident. Aquest recorregut fa servir QR-INPUT-TEST-12345.

  1. Obriu el Generador de codis QR i genereu un codi QR per a QR-INPUT-TEST-12345. El generador s'executa al navegador. No contacta amb l'escàner.
  2. Connecteu un escàner compatible amb QR que estigui configurat en mode de falca de teclat. Un escàner només 1D no pot descodificar aquest símbol.
  3. Obriu el Provador d'entrada de codis de barres.
  4. Feu clic a Inicieu la prova, o feu clic a la zona de lectura, perquè el camp tingui el focus. El provador no agafa el focus per si sol i no obre l'escàner.
  5. Llegiu el codi QR.
  6. Llegiu el text capturat i el nombre de caràcters.
  7. Compareu aquest text amb QR-INPUT-TEST-12345. La coincidència inclou les majúscules i les minúscules, els guions i la longitud.
  8. Llegiu el sufix. El provador informa ENTER, TAB o Cap quan l'escàner envia una d'aquestes tecles.

El provador registra els esdeveniments de teclat que el navegador pot veure. No identifica el dispositiu USB, no llegeix un port sèrie ni descodifica la imatge QR.

Modes d'entrada de l'escàner QR

El mateix codi QR imprès pot arribar per tres integracions diferents. Una prova d'un mode no exercita els altres.

Escàners QR de falca de teclat

En el mode de teclat USB HID, o en el mode de teclat Bluetooth HID, el sistema operatiu tracta l'escàner com un teclat. Després d'una descodificació, l'escàner escriu la càrrega al control que té el focus. Un <input> o un <textarea> normals la poden rebre. La pàgina no obre el dispositiu. La guia Falca de teclat HID descriu la seqüència de pulsacions, els prefixos i els sufixos.

El focus decideix la destinació. Si l'element amb el focus és el cos del document, un botó o un altre marc, els escoltadors d'aquest camp no veuen la lectura.

Escàners QR sèrie

Un escàner de port sèrie USB o de port COM virtual envia el text descodificat com a bytes al procés que ha obert el port. El focus no tria aquest procés. Un camp que només escolta pulsacions es queda buit mentre un terminal d'aquest port mostra la càrrega.

Els navegadors basats en Chromium poden obrir un port seleccionat per l'usuari amb l'API Web Serial, en un context segur, després d'un gest de l'usuari. Firefox i Safari no ofereixen aquesta API. Un escàner de falca no apareix com un port sèrie. Els noms de port, els bauds i l'enquadrament depenen del dispositiu i del controlador. Escàners de codis de barres USB HID i sèrie compara les dues interfícies. El Provador d'entrada de codis de barres no pot llegir un port COM.

Lectura QR basada en càmera

Una integració de càmera captura una imatge i descodifica el codi QR en programari. La pàgina fa servir una API de càmera i un descodificador. No rep esdeveniments keydown per a la càrrega. Les aplicacions de càmera del telèfon, els botons de càmera de la pàgina i un escàner d'imatges de maquinari que escriu en un camp són tres productes diferents. Superar una prova de falca no vol dir que el botó de la càmera funcioni, i una descodificació de càmera correcta no vol dir que un escàner de falca escrigui la mateixa cadena.

Captureu l'entrada de l'escàner QR amb JavaScript

La pàgina de sota llegeix un camp amb el focus. Enter envia el formulari, i el botó Accept fa servir el mateix gestor d'enviament, de manera que una lectura es processa una vegada. Sense un sufix ENTER, el text es queda al camp fins que algú activa Accept. La càrrega capturada s'escriu amb textContent, així que caràcters com < es queden visibles com a text.

L'exemple accepta tres formats d'aplicació: un identificador de tiquet com QR-INPUT-TEST-12345, un URL http o https, o un objecte JSON. Registra el text llegit. No navega a un URL trobat al codi QR. Un escàner que no envia Enter continua funcionant a través del botó. Tab es mou per l'etiqueta, el camp i el botó com de costum, perquè l'script no el captura.

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>QR input example</title>
</head>
<body>
  <form id="qr-form">
    <label for="qr">QR payload</label>
    <input id="qr" name="qr" type="text" autocomplete="off" spellcheck="false">
    <button type="submit">Accept</button>
  </form>
  <p id="status" role="status"></p>
  <pre id="captured"></pre>
  <script>
    const form = document.querySelector('#qr-form')
    const field = document.querySelector('#qr')
    const status = document.querySelector('#status')
    const captured = document.querySelector('#captured')

    if (
      !(form instanceof HTMLFormElement) ||
      !(field instanceof HTMLInputElement) ||
      !(status instanceof HTMLElement) ||
      !(captured instanceof HTMLElement)
    ) {
      throw new Error('QR form markup is missing.')
    }

    const accepted = new Set()

    function classify(raw) {
      if (/[\u0000-\u001F\u007F]/.test(raw)) {
        return { status: 'invalid', message: 'Control character in the QR payload.' }
      }

      const value = raw.trim()
      if (!value) {
        return { status: 'empty' }
      }
      if (value.length > 2048) {
        return { status: 'invalid', message: 'QR payload is longer than this form accepts.' }
      }
      if (/^QR-[A-Z0-9-]{1,64}$/.test(value)) {
        return { status: 'ok', value }
      }
      if (value.startsWith('{')) {
        try {
          const data = JSON.parse(value)
          if (!data || typeof data !== 'object' || Array.isArray(data)) {
            return { status: 'invalid', message: 'QR JSON must be an object.' }
          }
          return { status: 'ok', value }
        } catch {
          return { status: 'invalid', message: 'QR text is not valid JSON.' }
        }
      }
      if (value.startsWith('http://') || value.startsWith('https://')) {
        try {
          const url = new URL(value)
          if (url.protocol !== 'http:' && url.protocol !== 'https:') {
            return { status: 'invalid', message: 'Only http and https URLs are accepted.' }
          }
          return { status: 'ok', value }
        } catch {
          return { status: 'invalid', message: 'The QR text is not a valid URL.' }
        }
      }
      return { status: 'invalid', message: 'Unexpected QR payload.' }
    }

    form.addEventListener('submit', (event) => {
      event.preventDefault()
      const outcome = classify(field.value)
      if (outcome.status === 'empty') {
        status.textContent = 'No QR payload received.'
        field.focus()
        return
      }
      if (outcome.status === 'invalid') {
        status.textContent = outcome.message
        captured.textContent = ''
        field.focus()
        return
      }
      if (accepted.has(outcome.value)) {
        status.textContent = 'Already accepted ' + outcome.value
        field.value = ''
        field.focus()
        return
      }
      accepted.add(outcome.value)
      captured.textContent = outcome.value
      status.textContent = 'Accepted ' + outcome.value
      field.value = ''
      field.focus()
    })
  </script>
</body>
</html>

Deseu el fitxer i obriu-lo en un navegador d'escriptori. Feu clic al camp abans de llegir. autocomplete="off" redueix la possibilitat que un valor desat substitueixi la lectura. L'etiqueta i el botó continuen disponibles, de manera que una persona pot escriure una càrrega sense escàner.

Gestioneu Enter només a l'esdeveniment submit del formulari. Un segon escoltador keydown per a Enter registra la mateixa lectura dues vegades. preventDefault() manté el navegador en aquesta pàgina. Buideu el camp després d'una decisió perquè la lectura següent no s'afegeixi al text anterior.

Una càrrega QR pot contenir un salt de línia. Un escàner de falca sovint escriu aquest salt com a Enter. En una entrada d'una línia, el formulari es pot enviar a la primera línia i perdre la resta. Feu servir un textarea, o un lector sèrie que conservi els bytes, quan l'aplicació hagi d'acceptar text de diverses línies. Confirmeu aquest comportament amb un codi QR la càrrega del qual inclogui una línia nova.

Gestió de les càrregues QR

Un símbol QR no promet un format d'aplicació. La mateixa simbologia pot portar qualsevol d'aquests:

  • Text pla, com QR-INPUT-TEST-12345.
  • Un URL.
  • Un identificador triat per l'aplicació.
  • Una càrrega estructurada, com un número de tiquet més un codi d'ubicació.
  • Text JSON, quan l'aplicació ha definit aquesta codificació.

L'escàner transmet els caràcters descodificats. No comprova que coincideixin amb una regla de tiquet, un catàleg de productes o un esquema JSON. Valideu la cadena a la pàgina i torneu-la a validar al servidor. El valor enviat és entrada d'usuari ordinària. El navegador no pot demostrar que l'hagi produït un escàner.

Valideu l'entrada QR

No suposeu que una càrrega QR és numèrica. Les regles EAN-13 no s'apliquen. Tracteu el text com a no fiable: mostreu-lo com a text i no l'assigneu a location, innerHTML ni a un URL d'script.

Valors buits. Un Enter sol, o Accept en un camp en blanc, no ha de crear un registre. trim() també rebutja una càrrega que només són espais.

Caràcters inesperats. Compareu la cadena rebuda amb el contingut QR conegut. Un desajust de distribució de teclat sovint canvia la puntuació mentre la longitud es manté. Rebutgeu els caràcters que el format no permet i mostreu el motiu al text d'estat.

Longitud de la càrrega. Apliqueu el màxim que emmagatzema la vostra aplicació. maxlength a l'entrada trunca una lectura més llarga sense error. Establiu-lo només quan cada càrrega acceptada hi cap, i compareu el nombre de caràcters del provador amb el camp quan un valor sembla curt.

Prefixos obligatoris. Una comprovació de prefix pertany a l'aplicació. Aquesta regla de tiquet accepta QR- més lletres majúscules, dígits i guions:

function isTicketId(value) {
  return /^QR-[A-Z0-9-]{1,64}$/.test(value)
}

Traieu un prefix de l'escàner només quan aquest escàner estigui configurat per enviar un prefix exacte i l'aplicació no l'emmagatzemi. Un identificador de simbologia AIM són dades fins que decidiu el contrari.

Formats específics de l'aplicació. Mantingueu la regla al costat del format. Un formulari de tiquet, una llista d'URL permesos i un objecte JSON necessiten comprovacions diferents. Un sol patró numèric rebutjarà text QR vàlid.

Lectures duplicades. Una lectura física pot arribar a dos escoltadors. Feu servir un sol camí de compleció, com fa l'exemple. Una segona estirada del gallet és un esdeveniment a part. L'exemple rebutja una càrrega que ja ha acceptat. Un formulari de magatzem podria incrementar una quantitat. Proveu la regla que documenta la vostra aplicació.

JSON mal format. JSON.parse llança una excepció amb text incomplet. Comproveu la forma després d'una anàlisi correcta. Una matriu o un nombre sol pot ser JSON vàlid i continuar sent el tipus incorrecte:

function readJsonObject(value) {
  try {
    const data = JSON.parse(value)
    if (!data || typeof data !== 'object' || Array.isArray(data)) {
      return { ok: false, message: 'QR JSON must be an object.' }
    }
    return { ok: true, data }
  } catch {
    return { ok: false, message: 'QR text is not valid JSON.' }
  }
}

URL inesperats. Analitzeu l'URL per veure si és utilitzable i després conserveu la cadena llegida si la prova ha de coincidir exactament amb la càrrega QR. URL.href pot afegir una barra o canviar la codificació. Accepteu només els esquemes que pretén l'aplicació. No obriu l'URL com a efecte secundari de la lectura:

function readWebUrl(value) {
  let url
  try {
    url = new URL(value)
  } catch {
    return { ok: false, message: 'The QR text is not a valid URL.' }
  }
  if (url.protocol !== 'http:' && url.protocol !== 'https:') {
    return { ok: false, message: 'Only http and https URLs are accepted.' }
  }
  return { ok: true, value }
}

Caràcters de control. Rebutgeu els caràcters de control ASCII en una càrrega de teclat perquè un prefix ocult continuï visible al text d'estat. CR i LF són caràcters de control. En un escàner de falca, Enter i Tab són tecles. No són caràcters dins d'una entrada de text normal. Una càrrega sèrie encara pot contenir bytes 0x0D o 0x0A. Traieu-los al límit de l'enquadrament sèrie i no traieu un CR que pertany al mig d'una càrrega de diverses línies.

Sufixos ENTER i TAB

Un sufix és una configuració opcional de l'escàner. No forma part del símbol QR. Sufixos ENTER i TAB als escàners de codis de barres mostra com distingir les tecles. Llegiu el sufix al provador d'entrada i feu que la pàgina coincideixi amb els escàners que desplegueu.

ENTER envia el formulari d'un camp de text d'una línia als navegadors actuals. Feu-lo servir quan una lectura hagi de confirmar el valor. Crideu preventDefault() a submit quan la pàgina hagi de quedar-se al lloc.

TAB mou el focus al control següent. Llegiu el valor a keydown mentre el camp encara té el focus. Deixeu l'acció per defecte quan el camp següent hagi de rebre el focus. Ignoreu Shift+Tab perquè un usuari de teclat pugui anar enrere.

Sense sufix deixa la càrrega al camp. El botó Accept de l'exemple és el camí de compleció. Un temporitzador d'inactivitat pot endevinar que una pausa vol dir que la lectura s'ha acabat. Aquest temporitzador és una heurística: una ràfega Bluetooth lenta i algú que escriu de pressa poden creuar el mateix interval. Preferiu un sufix configurat quan el flux necessita un final ferm.

CR i LF són bytes. Un Enter de teclat és event.key === "Enter". No són intercanviables. Un escoltador que només treu \r d'un valor d'entrada no veurà un Enter de falca, perquè el caràcter no es va inserir mai. Un escoltador que només mira event.key no partirà un buffer sèrie a 0x0D. Alguns dispositius envien NumPad Enter. event.key continua sent "Enter". Comproveu event.key, no només event.code === "Enter".

El sufix pot canviar quan algú llegeix un codi de barres de configuració del manual del dispositiu. Torneu a provar Enter, Tab i l'absència de sufix després de qualsevol canvi de configuració. No inventeu un codi de barres de programació. Feu servir el manual d'aquest model.

Depureu els esdeveniments de teclat

Quan el text emmagatzemat és incorrecte, inspeccioneu els esdeveniments en aquest ordre.

keydown. Es dispara per a cada tecla, incloent-hi Enter i Tab, abans que el navegador insereixi un caràcter o mogui el focus. Llegiu el terminador aquí.

input. Es dispara després que un caràcter imprimible canvia el camp. No es dispara per a Enter o Tab en una entrada de text.

event.key. El caràcter o el nom de la tecla després que el sistema operatiu aplica la distribució de teclat.

event.code. La tecla física, com Digit1 o Numpad1. Pot mantenir-se igual quan un desajust de distribució canvia event.key.

Focus. Registreu document.activeElement abans de la lectura. Si no és el camp QR, la resta del rastre descriu el control equivocat. Un iframe té el seu propi focus.

Ordre. En una lectura de falca cap a un camp de text, els esdeveniments keydown imprimibles van seguits d'actualitzacions input, i després un keydown final per a Enter o Tab quan aquest sufix està configurat. change es dispara quan el camp es confirma, normalment en perdre el focus. Una lectura que deixa el focus al mateix camp no produeix change al final. No feu servir change com a únic senyal de compleció.

Temporització. Els escàners sovint acaben una càrrega curta molt per sota d'un segon. El provador d'entrada compara l'interval mitjà entre caràcters amb un llindar de 100 ms i etiqueta el resultat com a temporització, no com a identificació de maquinari. Algú que escriu de pressa, l'emplenament automàtic o l'emulador poden caure al costat de l'escàner d'aquest llindar. Una lectura Bluetooth endarrerida pot semblar escriptura. Afirmeu la càrrega i el sufix. Tracteu la temporització com una pista.

El Provador d'esdeveniments de teclat llista cada keydown i keyup amb key, code, modificadors i marques de temps. El registre són esdeveniments del navegador. No és trànsit USB en brut.

Proveu sense un escàner QR físic

La lògica de l'aplicació es pot provar abans que un escàner sigui a la taula.

  • Escriviu QR-INPUT-TEST-12345 al camp i activeu Accept. Això comprova la validació i la visualització. No comprova la descodificació ni els sufixos.
  • Conduïu el mateix camp des d'una eina d'automatització del navegador, com fa la secció següent.
  • Feu servir el Barcode Scanner Emulator quan necessiteu una escriptura a l'estil d'un escàner. L'aplicació d'escriptori envia un valor que introduïu, amb un retard d'escriptura i un sufix de cap, ENTER o TAB, a l'aplicació amb el focus. Reprodueix el camí de teclat. No fotografia una imatge QR, no descodifica un símbol ni crea un port COM virtual.

El maquinari continua sent necessari per al comportament òptic i del dispositiu: si aquell escàner pot llegir el codi mostrat o imprès, si la simbologia QR està activada, la distribució de teclat, la configuració del sufix i els modes sèrie o d'SDK del fabricant. L'emulador és la comprovació correcta per al camí de teclat. És la comprovació incorrecta per demostrar que un dispositiu llegeix un codi QR concret.

Automatitzeu les proves d'entrada QR

Les proves Playwright següents condueixen la pàgina d'exemple. Escriuen al camp com ho faria un escàner de falca i després afirmen el comportament de l'aplicació. No obren dispositius USB. @playwright/test és una dependència del lector. Aquest lloc no la requereix.

Deseu l'exemple HTML com a qr-form.html al costat d'aquesta prova.

import { readFileSync } from 'node:fs'
import { expect, test } from '@playwright/test'

const html = readFileSync(new URL('./qr-form.html', import.meta.url), 'utf8')

async function openForm(page) {
  await page.setContent(html)
}

test('accepts a known QR payload once', async ({ page }) => {
  await openForm(page)
  const field = page.getByLabel('QR payload')
  await field.pressSequentially('QR-INPUT-TEST-12345')
  await field.press('Enter')
  await expect(page.getByRole('status')).toHaveText('Accepted QR-INPUT-TEST-12345')
  await expect(page.locator('#captured')).toHaveText('QR-INPUT-TEST-12345')
})

test('rejects an unexpected payload', async ({ page }) => {
  await openForm(page)
  const field = page.getByLabel('QR payload')
  await field.pressSequentially('not-a-ticket')
  await field.press('Enter')
  await expect(page.getByRole('status')).toHaveText('Unexpected QR payload.')
  await expect(page.locator('#captured')).toBeEmpty()
})

test('commits on ENTER and rejects a duplicate scan', async ({ page }) => {
  await openForm(page)
  const field = page.getByLabel('QR payload')
  await field.pressSequentially('QR-INPUT-TEST-12345')
  await field.press('Enter')
  await field.pressSequentially('QR-INPUT-TEST-12345')
  await field.press('Enter')
  await expect(page.getByRole('status')).toHaveText('Already accepted QR-INPUT-TEST-12345')
  await expect(page.locator('#captured')).toHaveText('QR-INPUT-TEST-12345')
})

test('does not capture keys while the field is unfocused', async ({ page }) => {
  await openForm(page)
  await page.getByRole('button', { name: 'Accept' }).focus()
  await page.keyboard.type('QR-INPUT-TEST-12345')
  await expect(page.getByLabel('QR payload')).toHaveValue('')
  await expect(page.locator('#captured')).toBeEmpty()
  await expect(page.getByRole('status')).toHaveText('')
})

test('shows unexpected characters as text', async ({ page }) => {
  await openForm(page)
  const payload = '<img src=x onerror=alert(1)>'
  const field = page.getByLabel('QR payload')
  await field.fill(payload)
  await page.getByRole('button', { name: 'Accept' }).click()
  await expect(page.getByRole('status')).toHaveText('Unexpected QR payload.')
  await expect(page.locator('#captured img')).toHaveCount(0)
  await expect(page.locator('img')).toHaveCount(0)
})

pressSequentially insereix caràcters al camp amb el focus. No és un dispositiu USB. La prova de caràcters inesperats fa servir fill perquè l'objectiu és el missatge de validació i l'absència d'un element injectat. Amplieu el fitxer amb un cas d'URL i un cas de JSON quan aquests formats siguin a la versió que publiqueu. Una asserció d'URL ha de comparar el text capturat amb la cadena QR original.

Matriu de proves de l'escàner QR

Executeu-les contra l'aplicació que es prova. La pàgina d'exemple de dalt cobreix les files de tiquet, URL, JSON, duplicat, buit i caràcters inesperats. Una aplicació només numèrica o de diverses línies necessita el seu propi resultat esperat.

Escenari Resultat esperat
QR de text pla Valor exacte rebut
QR d'URL URL complet capturat, i la pàgina no hi navega
QR numèric Dígits conservats
Caràcters especials Caràcters correctes rebuts
Càrrega JSON Dades capturades i validades
Sufix ENTER El processament es produeix una vegada
Sufix TAB Comportament del focus gestionat
Sense sufix L'aplicació fa servir un mecanisme de compleció alternatiu
Lectura duplicada L'aplicació aplica les regles de gestió de duplicats
Càrrega no vàlida Error de validació mostrat
Focus absent L'aplicació gestiona l'entrada absent de manera segura
Càrrega llarga Sense truncament no desitjat

Llegiu també una càrrega que contingui una línia nova si el producte n'ha d'emmagatzemar una. Anoteu si el camp ha rebut cada línia.

Resolució de problemes

Comenceu amb una càrrega coneguda al provador d'entrada. Si el valor del provador ja és incorrecte, la pàgina no és la primera fallada. Si el valor del provador és correcte i l'aplicació és incorrecta, la fallada és el focus, la validació o la gestió d'esdeveniments. L'escàner de codis de barres no funciona és la llista de comprovació més àmplia del dispositiu. Com provar l'entrada d'un escàner de codis de barres cobreix el focus, la distribució i els fluxos de POS més enllà d'aquest formulari.

L'escàner fa un bip però no apareix cap entrada

Un bip sol voler dir que l'escàner ha descodificat un símbol. No vol dir que la pàgina hagi rebut el text. Confirmeu el mode de falca de teclat. Els modes sèrie i de càmera no escriuran al camp. Feu clic al camp perquè document.activeElement sigui aquesta entrada i llegiu una altra vegada. Un camp desactivat, de només lectura o ocult pot ignorar les tecles.

L'escàner QR funciona al Notepad però no al navegador

El dispositiu està escrivint. La pàgina no accepta aquestes tecles. Comproveu el focus, un escoltador keydown que crida preventDefault() en tecles imprimibles i un escoltador que només gestiona paste. L'entrada de falca no dispara un esdeveniment paste. Compareu el resultat del provador amb el camp de l'aplicació.

L'escàner llegeix codis de barres però no codis QR

El dispositiu pot ser només 1D, o la simbologia QR pot estar desactivada. La pàgina no ho pot arreglar. Confirmeu el suport 2D i activeu QR Code des del manual del dispositiu, amb les comprovacions de Proves de codis QR: com provar escàners de codis QR. Una lectura correcta de Code 128 només demostra el camí de teclat.

Caràcters incorrectes

Llegiu primer QR-INPUT-TEST-12345. Si coincideix i una càrrega d'URL o JSON no, la distribució està canviant la puntuació, com :, /, { o ". Compareu event.key amb event.code al Provador d'esdeveniments de teclat i vegeu Distribució de teclat incorrecta a l'escàner de codis de barres. Feu coincidir la distribució de teclat de l'escàner amb el sistema operatiu.

ENTER envia el formulari dues vegades

El navegador envia el formulari, i un escoltador keydown també gestiona Enter. Mantingueu un sol camí de compleció i crideu-hi preventDefault(). Una segona lectura física és una fallada diferent. El text d'estat de l'exemple diu que la càrrega ja s'havia acceptat. Si la primera lectura mateixa crea dos registres, busqueu dos escoltadors abans de canviar l'escàner.

L'entrada QR està truncada

Compareu el nombre de caràcters del provador d'entrada amb el valor del camp. Un atribut maxlength, una màscara d'entrada o preventDefault() en tecles de caràcter poden tallar la cadena. Una línia nova dins de la càrrega QR pot enviar una entrada d'una línia massa aviat. Alguns escàners també limiten quants caràcters escriuen. Apugeu aquest límit des del manual del dispositiu quan el provador, no només l'aplicació, mostri un valor curt. A l'escàner de codis de barres li falta ENTER cobreix el cas relacionat en què la càrrega arriba i el formulari no es confirma mai.

L'escàner no pot llegir un codi QR a la pantalla

Confirmeu que l'escàner és un escàner d'imatges 2D. Apugeu la brillantor de la pantalla, augmenteu la mida del codi i mantingueu la zona tranquil·la lliure de text i de vores. Els reflexos, una pantalla de telèfon fosca i un codi massa dens per a la distància de treball són problemes òptics. Imprimiu la mateixa càrrega si la lectura a la pantalla continua fallant. La prova de l'aplicació continua fent servir la cadena coneguda un cop qualsevol lectura produeix text.