Pāriet uz saturu

Barcode Scanner Emulator

Kā testēt QR koda skenera ievadi tīmekļa lietojumprogrammās

Daudzi ārēji skeneri, kas prot lasīt QR, izmanto tastatūras ķīļa režīmu un atkodēto QR tekstu ieraksta fokusētajā laukā. Šo ceļu pārbaudiet, noskenējot zināmu kravu un salīdzinot to ar vērtību, ko saņēma lapa. Ne katrs QR skeneris raksta kā tastatūra. Seriālās ierīces un kameras dekoderi ir citas integrācijas, un pārlūka tastatūras notikumi fizisko skeneri neidentificē.

QR kods glabā datus. Skeneris vai kameras dekoders šos datus pārvērš tekstā. Tīmekļa lietojumprogrammai tad šis teksts ir jāsaņem, jāizlemj, kad skenējums ir pabeigts, un tas jāpārbauda. Šis ceļvedis ir šis lietojumprogrammas tests. Etiķešu ģenerēšana, kontrasta pārbaude un apstiprinājums, ka ierīce var atkodēt QR Code, ir ceļvedī QR koda testēšana: kā testēt QR kodu skenerus. Vispārīgas svītrkodu formas, ieskaitot EAN kontrolciparus, ir ceļvedī Kā testēt svītrkodu skenerus tīmekļa lietojumprogrammās.

QR skenera ievades tests 60 sekundēs

Izmantojiet kravu, kuru izvēlējāties paši, lai nepareiza rakstzīme būtu acīmredzama. Šajā aprakstā izmantota QR-INPUT-TEST-12345.

  1. Atveriet QR koda ģeneratoru un ģenerējiet QR kodu vērtībai QR-INPUT-TEST-12345. Ģenerators darbojas pārlūkā. Ar skeneri tas nesazinās.
  2. Pievienojiet QR spējīgu skeneri, kas ir iestatīts tastatūras ķīļa režīmā. Tikai 1D skeneris šo simbolu atkodēt nevar.
  3. Atveriet svītrkoda ievades testētāju.
  4. Noklikšķiniet uz Sākt testu vai noklikšķiniet skenēšanas apgabalā, lai laukam būtu fokuss. Testētājs pats fokusu nepaņem un skeneri neatver.
  5. Noskenējiet QR kodu.
  6. Izlasiet tverto tekstu un rakstzīmju skaitu.
  7. Salīdziniet šo tekstu ar QR-INPUT-TEST-12345. Atbilstība ietver burtu reģistru, defises un garumu.
  8. Izlasiet piedēkli. Testētājs ziņo ENTER, TAB vai Nav, kad skeneris nosūta vienu no šiem taustiņiem.

Testētājs reģistrē tastatūras notikumus, kurus redz pārlūks. Tas neidentificē USB ierīci, nelasa seriālo portu un neatkodē QR attēlu.

QR skenera ievades režīmi

Tas pats drukātais QR kods var nonākt pa trim dažādām integrācijām. Viena režīma tests pārējos neizpilda.

Tastatūras ķīļa QR skeneri

USB HID tastatūras režīmā vai Bluetooth HID tastatūras režīmā operētājsistēma skeneri uztver kā tastatūru. Pēc atkodēšanas skeneris ieraksta kravu tajā vadīklā, kurai ir fokuss. To var saņemt parasts <input> vai <textarea>. Lapa ierīci neatver. Ceļvedis HID tastatūras ķīlis apraksta taustiņu secību, priedēkļus un piedēkļus.

Fokuss izlemj galamērķi. Ja fokusētais elements ir dokumenta ķermenis, poga vai cits ietvars, šī lauka klausītāji skenējumu neredz.

Seriālie QR skeneri

USB seriālā vai virtuālā COM porta skeneris nosūta atkodēto tekstu kā baitus procesam, kas atvēra portu. Fokuss šo procesu neizvēlas. Lauks, kas klausās tikai taustiņu spiedienus, paliek tukšs, kamēr terminālis šajā portā rāda kravu.

Uz Chromium balstīti pārlūki var atvērt lietotāja izvēlētu portu ar Web Serial API drošā kontekstā pēc lietotāja žesta. Firefox un Safari šo API nepiedāvā. Ķīļa skeneris neparādās kā seriālais ports. Portu nosaukumi, ātrums bodos un kadrēšana ir atkarīgi no ierīces un draivera. USB HID un seriālie svītrkodu skeneri salīdzina abas saskarnes. Svītrkoda ievades testētājs COM portu lasīt nevar.

QR skenēšana ar kameru

Kameras integrācija uzņem attēlu un QR kodu atkodē programmatūrā. Lapa izmanto kameras API un dekoderi. Kravas keydown notikumus tā nesaņem. Tālruņa kameras lietotnes, lapas kameras pogas un aparatūras attēlu skeneris, kas raksta laukā, ir trīs dažādi produkti. Izturēts ķīļa tests nenozīmē, ka kameras poga darbojas, un veiksmīga kameras atkodēšana nenozīmē, ka ķīļa skeneris ierakstīs to pašu virkni.

QR skenera ievades tveršana ar JavaScript

Tālāk esošā lapa nolasa vienu fokusētu lauku. Enter iesniedz veidlapu, un poga Accept izmanto to pašu iesniegšanas apdarinātāju, tāpēc viens skenējums tiek apstrādāts vienu reizi. Bez ENTER piedēkļa teksts paliek laukā, līdz kāds aktivizē Accept. Tvertā krava tiek rakstīta ar textContent, tāpēc rakstzīmes, piemēram <, paliek redzamas kā teksts.

Piemērs pieņem trīs lietojumprogrammas formātus: biļetes identifikatoru, piemēram QR-INPUT-TEST-12345, http vai https URL, vai JSON objektu. Tas pieraksta noskenēto tekstu. Tas nepāriet uz URL, kas atrasts QR kodā. Skeneris, kas nesūta Enter, joprojām darbojas caur pogu. Tab kā parasti pārvietojas pa etiķeti, lauku un pogu, jo skripts to neaiztur.

<!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>

Saglabājiet failu un atveriet to darbvirsmas pārlūkā. Pirms skenēšanas noklikšķiniet laukā. autocomplete="off" samazina iespēju, ka saglabāta vērtība aizstāj skenējumu. Etiķete un poga paliek pieejamas, tāpēc cilvēks var ievadīt kravu bez skenera.

Enter apstrādājiet tikai veidlapas submit notikumā. Otrs keydown klausītājs Enter to pašu skenējumu pieraksta divreiz. preventDefault() patur pārlūku šajā lapā. Pēc lēmuma notīriet lauku, lai nākamais skenējums nepievienotos iepriekšējam tekstam.

QR krava var saturēt rindas pārtraukumu. Ķīļa skeneris šo pārtraukumu bieži ieraksta kā Enter. Vienas rindas ievadē veidlapa var tikt iesniegta pie pirmās rindas un pārējais atmests. Izmantojiet textarea vai seriālo lasītāju, kas patur baitus, kad lietojumprogrammai jāpieņem vairāku rindu teksts. Šo uzvedību apstipriniet ar QR kodu, kura kravā ir jauna rinda.

QR kravu apstrāde

QR simbols nesola lietojumprogrammas formātu. Tā pati simbolika var nest jebkuru no šiem:

  • Vienkāršu tekstu, piemēram QR-INPUT-TEST-12345.
  • URL.
  • Identifikatoru, kuru izvēlas lietojumprogramma.
  • Strukturētu kravu, piemēram biļetes numuru un vietas kodu.
  • JSON tekstu, kad lietojumprogramma ir noteikusi šo kodējumu.

Skeneris pārraida atkodētās rakstzīmes. Tas nepārbauda, vai tās atbilst biļetes noteikumam, preču katalogam vai JSON shēmai. Virkni pārbaudiet lapā un vēlreiz serverī. Iesniegtā vērtība ir parasta lietotāja ievade. Pārlūks nevar pierādīt, ka to radīja skeneris.

QR ievades pārbaude

Nepieņemiet, ka QR krava ir skaitliska. EAN-13 noteikumi neattiecas. Tekstu uzskatiet par neuzticamu: rādiet to kā tekstu un nepiešķiriet to location, innerHTML vai skripta URL.

Tukšas vērtības. Tikai Enter vai Accept tukšā laukā nedrīkst izveidot ierakstu. trim() arī noraida kravu, kas ir tikai atstarpes.

Negaidītas rakstzīmes. Salīdziniet saņemto virkni ar zināmo QR saturu. Tastatūras izkārtojuma neatbilstība bieži maina pieturzīmes, bet garums paliek tāds pats. Noraidiet rakstzīmes, kuras formāts nepieļauj, un iemeslu parādiet statusa tekstā.

Kravas garums. Piemērojiet maksimumu, ko glabā jūsu lietojumprogramma. maxlength ievadē garāku skenējumu nogriež bez kļūdas. Iestatiet to tikai tad, kad ietilpst katra pieņemtā krava, un salīdziniet testētāja rakstzīmju skaitu ar lauku, kad vērtība izskatās īsa.

Obligātie priedēkļi. Priedēkļa pārbaude pieder lietojumprogrammai. Šis biļetes noteikums pieņem QR- un lielos burtus, ciparus un defises:

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

Skenera priedēkli noņemiet tikai tad, kad šis skeneris ir konfigurēts sūtīt vienu precīzu priedēkli un lietojumprogramma to neglabā. AIM simbolikas identifikators ir dati, līdz izlemjat citādi.

Lietojumprogrammai raksturīgi formāti. Noteikumu turiet blakus formātam. Biļetes veidlapai, URL atļauto sarakstam un JSON objektam vajag dažādas pārbaudes. Viens skaitlisks raksts noraidītu derīgu QR tekstu.

Atkārtoti skenējumi. Viens fizisks skenējums var trāpīt diviem klausītājiem. Izmantojiet vienu pabeigšanas ceļu, kā to dara piemērs. Otra mēlītes nospiešana ir atsevišķs notikums. Piemērs noraida kravu, kuru jau ir pieņēmis. Noliktavas veidlapa tā vietā var palielināt daudzumu. Testējiet noteikumu, kuru dokumentē jūsu lietojumprogramma.

Nepareizi veidots JSON. JSON.parse met izņēmumu, ja teksts ir nepilnīgs. Pēc veiksmīgas analīzes pārbaudiet formu. Masīvs vai kails skaitlis var būt derīgs JSON un tomēr būt nepareizs tips:

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.' }
  }
}

Negaidīti URL. Analizējiet URL, lai redzētu, vai tas ir lietojams, tad paturiet noskenēto virkni, ja testam jāatbilst QR kravai precīzi. URL.href var pievienot slīpsvītru vai mainīt kodējumu. Pieņemiet tikai tās shēmas, kuras paredz lietojumprogramma. Neatveriet URL kā skenējuma blakusefektu:

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 }
}

Vadības rakstzīmes. Tastatūras kravā noraidiet ASCII vadības rakstzīmes, lai slēpts priedēklis paliktu redzams statusa tekstā. CR un LF ir vadības rakstzīmes. Ķīļa skenerī Enter un Tab ir taustiņi. Tie nav rakstzīmes parastā teksta ievadē. Seriālā krava joprojām var saturēt 0x0D vai 0x0A baitus. Noņemiet tos seriālās kadrēšanas robežā un nenoņemiet CR, kas pieder vairāku rindu kravas vidū.

ENTER un TAB piedēkļi

Piedēklis ir neobligāta skenera konfigurācija. Tas nav QR simbola daļa. ENTER un TAB piedēkļi svītrkodu skeneros parāda, kā atšķirt taustiņus. Piedēkli nolasiet ievades testētājā, tad pielāgojiet lapu skeneriem, kurus izvietojat.

ENTER pašreizējos pārlūkos iesniedz vienas rindas teksta lauka veidlapu. Izmantojiet to, kad vienam skenējumam jāapstiprina vērtība. Izsauciet preventDefault() uz submit, kad lapai jāpaliek vietā.

TAB pārvieto fokusu uz nākamo vadīklu. Vērtību lasiet keydown laikā, kamēr laukam vēl ir fokuss. Atstājiet noklusējuma darbību, kad nākamajam laukam jāsaņem fokuss. Ignorējiet Shift+Tab, lai tastatūras lietotājs varētu virzīties atpakaļ.

Bez piedēkļa krava paliek laukā. Poga Accept piemērā ir pabeigšanas ceļš. Neaktivitātes taimeris var uzskatīt, ka pauze nozīmē skenējuma beigas. Šis taimeris ir heiristika: lēns Bluetooth uzliesmojums un ātrs rakstītājs var šķērsot to pašu spraugu. Dodiet priekšroku konfigurētam piedēklim, kad darbplūsmai vajag stingras beigas.

CR un LF ir baiti. Tastatūras Enter ir event.key === "Enter". Tie nav savstarpēji aizstājami. Klausītājs, kas no ievades vērtības noņem tikai \r, ķīļa Enter neredzēs, jo rakstzīme nekad netika ievietota. Klausītājs, kas skatās tikai event.key, seriālo buferi nedalīs pie 0x0D. Dažas ierīces sūta NumPad Enter. event.key joprojām ir "Enter". Pārbaudiet event.key, ne tikai event.code === "Enter".

Piedēklis var mainīties, kad kāds noskenē konfigurācijas svītrkodu no ierīces rokasgrāmatas. Pēc jebkuras konfigurācijas izmaiņas no jauna testējiet Enter, Tab un gadījumu bez piedēkļa. Neizdomājiet programmēšanas svītrkodu. Šim modelim izmantojiet rokasgrāmatu.

Tastatūras notikumu atkļūdošana

Kad saglabātais teksts ir nepareizs, notikumus pārbaudiet šādā secībā.

keydown. Nostrādā katram taustiņam, ieskaitot Enter un Tab, pirms pārlūks ievieto rakstzīmi vai pārvieto fokusu. Noslēdzēju lasiet šeit.

input. Nostrādā pēc tam, kad drukājama rakstzīme maina lauku. Teksta ievadē tas nenostrādā Enter vai Tab.

event.key. Rakstzīme vai taustiņa nosaukums pēc tam, kad operētājsistēma piemēro tastatūras izkārtojumu.

event.code. Fiziskais taustiņš, piemēram Digit1 vai Numpad1. Tas var palikt tāds pats, kad izkārtojuma neatbilstība maina event.key.

Fokuss. Pirms skenējuma reģistrējiet document.activeElement. Ja tas nav QR lauks, pārējā pēda apraksta nepareizo vadīklu. Iframe ir savs fokuss.

Secība. Ķīļa skenējumā teksta laukā pēc drukājamiem keydown notikumiem seko input atjauninājumi, tad noslēdzošs keydown Enter vai Tab, kad šis piedēklis ir konfigurēts. change nostrādā, kad lauks tiek apstiprināts, parasti zaudējot fokusu. Skenējums, kas fokusu atstāj tajā pašā laukā, beigās change nerada. Neizmantojiet change kā vienīgo pabeigšanas signālu.

Laiks. Skeneri īsu kravu bieži pabeidz krietni ātrāk par sekundi. Ievades testētājs vidējo atstarpi starp rakstzīmēm salīdzina ar 100 ms slieksni un rezultātu apzīmē kā laiku, nevis kā aparatūras atpazīšanu. Ātrs rakstītājs, automātiskā aizpilde vai emulators var nonākt skenera pusē šim slieksnim. Aizkavēts Bluetooth skenējums var izskatīties pēc rakstīšanas. Apstipriniet kravu un piedēkli. Laiku uztveriet kā norādi.

Izmantojiet tastatūras notikumu testētāju. Tas uzskaita katru keydown un keyup ar key, code, modifikatoriem un laikspiedoliem. Žurnāls ir pārlūka notikumi. Tas nav neapstrādāta USB plūsma.

Tests bez fiziska QR skenera

Lietojumprogrammas loģiku var testēt, pirms skeneris ir uz galda.

  • Laukā ierakstiet QR-INPUT-TEST-12345 un aktivizējiet Accept. Tas pārbauda validāciju un attēlojumu. Tas nepārbauda atkodēšanu vai piedēkļus.
  • To pašu lauku vadiet ar pārlūka automatizācijas rīku, kā to dara nākamā sadaļa.
  • Izmantojiet Barcode Scanner Emulator, kad vajag rakstīšanu skenera stilā. Darbvirsmas lietojumprogramma nosūta jūsu ievadīto vērtību ar rakstīšanas aizturi un piedēkli Nav, ENTER vai TAB fokusētajā lietojumprogrammā. Tā atkārto tastatūras ceļu. Tā nefotografē QR attēlu, neatkodē simbolu un neizveido virtuālu COM portu.

Aparatūra joprojām ir vajadzīga optiskajai un ierīces uzvedībai: vai šis skeneris var nolasīt attēloto vai drukāto kodu, vai QR simbolika ir ieslēgta, tastatūras izkārtojums, piedēkļa konfigurācija un seriālie vai ražotāja SDK režīmi. Emulators ir pareizā pārbaude tastatūras ceļam. Tas ir nepareizā pārbaude, lai pierādītu, ka ierīce nolasa konkrētu QR kodu.

QR ievades testu automatizēšana

Tālāk esošie Playwright testi vada parauga lapu. Tie raksta laukā tā, kā rakstītu ķīļa skeneris, un tad apstiprina lietojumprogrammas uzvedību. Tie neatver USB ierīces. @playwright/test ir lasītāja atkarība. Šī vietne to neprasa.

HTML piemēru saglabājiet kā qr-form.html blakus šim testam.

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 ievieto rakstzīmes fokusētajā laukā. Tas nav USB ierīce. Negaidīto rakstzīmju tests izmanto fill, jo mērķis ir validācijas ziņojums un ievietota elementa neesamība. Failu papildiniet ar URL gadījumu un JSON gadījumu, kad šie formāti ir būvējumā, kuru izlaižat. URL apstiprinājumam jāsalīdzina tvertais teksts ar sākotnējo QR virkni.

QR skenera testu matrica

Izpildiet to testējamajā lietojumprogrammā. Augšējā parauga lapa aptver biļetes, URL, JSON, dublikāta, tukšas vērtības un negaidīto rakstzīmju rindas. Tikai skaitliskai vai vairāku rindu lietojumprogrammai vajag savu sagaidāmo rezultātu.

Scenārijs Sagaidāmais rezultāts
Vienkāršs QR teksts Saņemta precīza vērtība
URL QR Tverts pilns URL, un lapa uz to nepāriet
Skaitlisks QR Cipari saglabāti
Speciālās rakstzīmes Saņemtas pareizās rakstzīmes
JSON krava Dati tverti un pārbaudīti
ENTER piedēklis Apstrāde notiek vienu reizi
TAB piedēklis Fokusa uzvedība apstrādāta
Bez piedēkļa Lietojumprogramma izmanto citu pabeigšanas mehānismu
Atkārtots skenējums Lietojumprogramma piemēro dublikātu apstrādes noteikumus
Nederīga krava Parādīta validācijas kļūda
Trūkstošs fokuss Lietojumprogramma droši apstrādā neesošu ievadi
Gara krava Nav neparedzētas nogriešanas

Noskenējiet arī kravu, kurā ir jauna rinda, ja produktam tā jāsaglabā. Pierakstiet, vai lauks saņēma katru rindu.

Problēmu novēršana

Sāciet ar zināmu kravu ievades testētājā. Ja testētāja vērtība jau ir nepareiza, lapa nav pirmā kļūda. Ja testētāja vērtība ir pareiza, bet lietojumprogramma nepareiza, kļūda ir fokusā, validācijā vai notikumu apstrādē. Svītrkodu skeneris nedarbojas ir plašāks ierīces kontrolsaraksts. Kā testēt svītrkodu skenera ievadi aptver fokusu, izkārtojumu un POS darbplūsmas ārpus šīs veidlapas.

Skeneris pīkst, bet ievade neparādās

Pīkstiens parasti nozīmē, ka skeneris atkodēja simbolu. Tas nenozīmē, ka lapa saņēma tekstu. Apstipriniet tastatūras ķīļa režīmu. Seriālais un kameras režīms laukā neraksta. Noklikšķiniet laukā, lai document.activeElement būtu šī ievade, un skenējiet vēlreiz. Atspējots, tikai lasāms vai paslēpts lauks var ignorēt taustiņus.

QR skeneris darbojas piezīmju blokā, bet ne pārlūkā

Ierīce raksta. Lapa šos taustiņus nepieņem. Pārbaudiet fokusu, keydown klausītāju, kas drukājamiem taustiņiem izsauc preventDefault(), un klausītāju, kas apstrādā tikai paste. Ķīļa ievade paste notikumu neizraisa. Salīdziniet testētāja rezultātu ar lietojumprogrammas lauku.

Skeneris nolasa svītrkodus, bet ne QR kodus

Ierīce var būt tikai 1D, vai QR simbolika var būt izslēgta. Lapa to nevar izlabot. Apstipriniet 2D atbalstu un ieslēdziet QR Code pēc ierīces rokasgrāmatas, izmantojot pārbaudes ceļvedī QR koda testēšana: kā testēt QR kodu skenerus. Veiksmīgs Code 128 skenējums pierāda tikai tastatūras ceļu.

Nepareizas rakstzīmes

Vispirms noskenējiet QR-INPUT-TEST-12345. Ja tas sakrīt, bet URL vai JSON krava ne, izkārtojums maina pieturzīmes, piemēram :, /, { vai ". Tastatūras notikumu testētājā salīdziniet event.key ar event.code un skatiet Nepareizs svītrkodu skenera tastatūras izkārtojums. Saskaņojiet skenera tastatūras izkārtojumu ar operētājsistēmu.

ENTER veidlapu iesniedz divreiz

Pārlūks iesniedz veidlapu, un keydown klausītājs arī apstrādā Enter. Paturiet vienu pabeigšanas ceļu un tur izsauciet preventDefault(). Otrs fizisks skenējums ir cita kļūda. Piemēra statusa teksts saka, ka krava jau ir pieņemta. Ja jau pirmais skenējums izveido divus ierakstus, meklējiet divus klausītājus, pirms maināt skeneri.

QR ievade ir nogriezta

Salīdziniet rakstzīmju skaitu ievades testētājā ar vērtību laukā. Atribūts maxlength, ievades maska vai preventDefault() rakstzīmju taustiņiem var nogriezt virkni. Jauna rinda QR kravā var par agru iesniegt vienas rindas ievadi. Daži skeneri arī ierobežo, cik rakstzīmes tie ieraksta. Šo robežu paaugstiniet pēc ierīces rokasgrāmatas, kad īsu vērtību rāda testētājs, ne tikai lietojumprogramma. Svītrkodu skenerim trūkst ENTER aptver saistīto gadījumu, kad krava pienāk, bet veidlapa nekad netiek apstiprināta.

Skeneris nevar nolasīt QR kodu ekrānā

Apstipriniet, ka skeneris ir 2D attēlu skeneris. Palieliniet ekrāna spilgtumu, palieliniet koda izmēru un turiet kluso zonu brīvu no teksta un apmalēm. Atspīdums, blāvs tālruņa ekrāns un kods, kas ir pārāk blīvs darba attālumam, ir optiskas problēmas. Izdrukājiet to pašu kravu, ja lasīšana no ekrāna joprojām neizdodas. Lietojumprogrammas tests joprojām izmanto zināmo virkni, kad jebkurš skenējums rada tekstu.