Lewati ke konten

Barcode Scanner Emulator

Cara menguji masukan pemindai kode QR di aplikasi web

Banyak pemindai eksternal yang mampu QR memakai mode baji papan ketik dan mengetik teks QR yang sudah didekode ke bidang yang sedang fokus. Uji jalur itu dengan memindai muatan yang diketahui dan membandingkannya dengan nilai yang diterima halaman. Tidak setiap pemindai QR mengetik seperti papan ketik. Perangkat serial dan dekoder kamera adalah integrasi yang berbeda, dan peristiwa papan ketik peramban tidak mengidentifikasi pemindai fisik.

Kode QR menyimpan data. Pemindai, atau dekoder kamera, mengubah data itu menjadi teks. Aplikasi web kemudian harus menerima teks itu, memutuskan kapan pindaian selesai, dan memvalidasinya. Panduan ini adalah uji aplikasi itu. Membuat label, memeriksa kontras, dan memastikan perangkat dapat mendekode QR Code dibahas di Pengujian kode QR: cara menguji pemindai kode QR. Formulir kode batang umum, termasuk digit periksa EAN, dibahas di Cara menguji pemindai kode batang di aplikasi web.

Uji masukan pemindai QR dalam 60 detik

Pakai muatan yang Anda pilih sendiri, supaya karakter yang salah terlihat. Langkah ini memakai QR-INPUT-TEST-12345.

  1. Buka pembuat kode QR dan buat kode QR untuk QR-INPUT-TEST-12345. Pembuat ini berjalan di peramban. Pembuat ini tidak menghubungi pemindai.
  2. Hubungkan pemindai yang mampu QR dan diatur ke mode baji papan ketik. Pemindai yang hanya 1D tidak dapat mendekode simbol ini.
  3. Buka penguji masukan kode batang.
  4. Klik Mulai pengujian, atau klik area pindai, supaya bidang mendapat fokus. Penguji tidak mengambil fokus sendiri, dan tidak membuka pemindai.
  5. Pindai kode QR.
  6. Baca teks yang tertangkap dan jumlah karakter.
  7. Bandingkan teks itu dengan QR-INPUT-TEST-12345. Kecocokan mencakup huruf besar-kecil, tanda hubung, dan panjang.
  8. Baca akhiran. Penguji melaporkan ENTER, TAB, atau Tidak ada saat pemindai mengirim salah satu tombol itu.

Penguji merekam peristiwa papan ketik yang dapat dilihat peramban. Penguji tidak mengidentifikasi perangkat USB, tidak membaca port serial, dan tidak mendekode gambar QR.

Mode masukan pemindai QR

Kode QR tercetak yang sama dapat masuk melalui tiga integrasi yang berbeda. Uji satu mode tidak melatih mode yang lain.

Pemindai QR baji papan ketik

Dalam mode papan ketik USB HID, atau mode papan ketik Bluetooth HID, sistem operasi memperlakukan pemindai sebagai papan ketik. Setelah dekode, pemindai mengetik muatan ke kontrol yang memegang fokus. <input> atau <textarea> biasa dapat menerimanya. Halaman tidak membuka perangkat. Panduan HID keyboard wedge menjelaskan urutan ketukan, awalan, dan akhiran.

Fokus menentukan tujuan. Jika elemen yang fokus adalah body dokumen, sebuah tombol, atau bingkai lain, listener bidang ini tidak melihat pindaian.

Pemindai QR serial

Pemindai port serial USB atau port COM virtual mengirim teks yang sudah didekode sebagai byte ke proses yang membuka port. Fokus tidak memilih proses itu. Bidang yang hanya mendengarkan ketukan tetap kosong sementara terminal pada port itu menampilkan muatan.

Peramban berbasis Chromium dapat membuka port yang dipilih pengguna dengan Web Serial API, dalam konteks aman, setelah gestur pengguna. Firefox dan Safari tidak menyediakan API itu. Pemindai baji tidak muncul sebagai port serial. Nama port, baud, dan pembingkaian bergantung pada perangkat dan driver. Pemindai kode batang USB HID dan serial membandingkan kedua antarmuka. Penguji masukan kode batang tidak dapat membaca port COM.

Pemindaian QR berbasis kamera

Integrasi kamera mengambil gambar dan mendekode kode QR di perangkat lunak. Halaman memakai API kamera dan sebuah dekoder. Halaman tidak menerima peristiwa keydown untuk muatan. Aplikasi kamera ponsel, tombol kamera di dalam halaman, dan pencitra perangkat keras yang mengetik ke bidang adalah tiga produk yang berbeda. Lulus uji baji tidak berarti tombol kamera bekerja, dan dekode kamera yang berhasil tidak berarti pemindai baji akan mengetik string yang sama.

Menangkap masukan pemindai QR dengan JavaScript

Halaman di bawah membaca satu bidang yang sedang fokus. Enter mengirim formulir, dan tombol Accept memakai penangan submit yang sama, jadi satu pindaian diproses sekali. Tanpa akhiran ENTER, teks tetap di bidang sampai seseorang mengaktifkan Accept. Muatan yang tertangkap ditulis dengan textContent, jadi karakter seperti < tetap terlihat sebagai teks.

Contoh menerima tiga format aplikasi: id tiket seperti QR-INPUT-TEST-12345, URL http atau https, atau objek JSON. Contoh mencatat teks yang dipindai. Contoh tidak menavigasi ke URL yang ditemukan di kode QR. Pemindai yang tidak mengirim Enter tetap bekerja lewat tombol. Tab berpindah melalui label, bidang, dan tombol seperti biasa, karena skrip tidak menjebaknya.

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

Simpan berkas dan buka di peramban desktop. Klik bidang sebelum memindai. autocomplete="off" mengurangi kemungkinan nilai tersimpan menggantikan pindaian. Label dan tombol tetap tersedia, jadi seseorang dapat mengetik muatan tanpa pemindai.

Tangani Enter hanya di peristiwa submit formulir. Listener keydown kedua untuk Enter mencatat pindaian yang sama dua kali. preventDefault() menahan peramban di halaman ini. Kosongkan bidang setelah keputusan agar pindaian berikutnya tidak menempel pada teks sebelumnya.

Muatan QR dapat berisi pemisah baris. Pemindai baji sering mengetik pemisah itu sebagai Enter. Pada masukan satu baris, formulir dapat terkirim di baris pertama dan membuang sisanya. Pakai textarea, atau pembaca serial yang menyimpan byte, bila aplikasi harus menerima teks banyak baris. Konfirmasikan perilaku itu dengan kode QR yang muatannya berisi baris baru.

Menangani muatan QR

Simbol QR tidak menjanjikan format aplikasi. Simbologi yang sama dapat membawa salah satu dari ini:

  • Teks biasa, seperti QR-INPUT-TEST-12345.
  • Sebuah URL.
  • Pengidentifikasi yang dipilih aplikasi.
  • Muatan terstruktur, seperti nomor tiket ditambah kode lokasi.
  • Teks JSON, bila aplikasi mendefinisikan pengodean itu.

Pemindai mengirimkan karakter yang sudah didekode. Pemindai tidak memeriksa apakah karakter itu cocok dengan aturan tiket, katalog produk, atau skema JSON. Validasi string di halaman, dan validasi lagi di server. Nilai yang diposting adalah masukan pengguna biasa. Peramban tidak dapat membuktikan bahwa pemindai yang menghasilkannya.

Validasi masukan QR

Jangan menganggap muatan QR berupa angka. Aturan EAN-13 tidak berlaku. Perlakukan teks sebagai tidak tepercaya: tampilkan sebagai teks, dan jangan menetapkannya ke location, innerHTML, atau URL skrip.

Nilai kosong. Enter kosong, atau Accept pada bidang kosong, tidak boleh membuat rekaman. trim() juga menolak muatan yang hanya berisi spasi.

Karakter yang tidak terduga. Bandingkan string yang diterima dengan isi QR yang diketahui. Ketidakcocokan tata letak papan ketik sering mengubah tanda baca sementara panjangnya tetap. Tolak karakter yang tidak diizinkan format, dan tunjukkan alasannya di teks status.

Panjang muatan. Terapkan maksimum yang disimpan aplikasi. maxlength pada masukan memotong pindaian yang lebih panjang tanpa kesalahan. Atur hanya bila setiap muatan yang diterima muat, dan bandingkan jumlah karakter penguji dengan bidang saat sebuah nilai terlihat pendek.

Awalan yang wajib. Pemeriksaan awalan milik aplikasi. Aturan tiket ini menerima QR- plus huruf besar, digit, dan tanda hubung:

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

Buang awalan pemindai hanya bila pemindai itu dikonfigurasi untuk mengirim satu awalan yang persis dan aplikasi tidak menyimpannya. Pengidentifikasi simbologi AIM adalah data sampai Anda memutuskan lain.

Format khusus aplikasi. Simpan aturan di samping format. Formulir tiket, daftar URL yang diizinkan, dan objek JSON membutuhkan pemeriksaan yang berbeda. Satu pola numerik akan menolak teks QR yang valid.

Pindaian ganda. Satu pindaian fisik dapat mengenai dua listener. Pakai satu jalur penyelesaian, seperti yang dilakukan contoh. Tarikan pelatuk kedua adalah peristiwa terpisah. Contoh menolak muatan yang sudah diterima. Formulir gudang dapat menambah jumlah. Uji aturan yang didokumentasikan aplikasi.

JSON yang rusak. JSON.parse melempar pada teks yang belum lengkap. Periksa bentuk setelah penguraian berhasil. Array atau angka telanjang dapat berupa JSON yang valid dan tetap bertipe salah:

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 yang tidak terduga. Urai URL untuk melihat apakah URL itu dapat dipakai, lalu simpan string yang dipindai jika pengujian harus cocok persis dengan muatan QR. URL.href dapat menambahkan garis miring atau mengubah pengodean. Terima hanya skema yang dimaksud aplikasi. Jangan membuka URL sebagai efek samping pindaian:

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

Karakter kontrol. Tolak karakter kontrol ASCII dalam muatan papan ketik agar awalan tersembunyi tetap terlihat di teks status. CR dan LF adalah karakter kontrol. Pada pemindai baji, Enter dan Tab adalah tombol. Keduanya bukan karakter di dalam masukan teks biasa. Muatan serial mungkin masih berisi byte 0x0D atau 0x0A. Buang byte itu di batas pembingkaian serial, dan jangan menghapus CR yang berada di tengah muatan banyak baris.

Akhiran ENTER dan TAB

Akhiran adalah konfigurasi pemindai yang opsional. Akhiran bukan bagian dari simbol QR. Akhiran ENTER vs TAB pada pemindai kode batang menunjukkan cara membedakan tombol. Baca akhiran di penguji masukan, lalu buat halaman cocok dengan pemindai yang Anda terapkan.

ENTER mengirim formulir bidang teks satu baris di peramban saat ini. Pakai saat satu pindaian harus mengunci nilai. Panggil preventDefault() pada submit bila halaman harus tetap di tempat.

TAB memindahkan fokus ke kontrol berikutnya. Baca nilai di keydown selagi bidang masih fokus. Biarkan tindakan bawaan bila bidang berikutnya harus menerima fokus. Abaikan Shift+Tab agar pengguna papan ketik dapat bergerak mundur.

Tanpa akhiran meninggalkan muatan di bidang. Tombol Accept pada contoh adalah jalur penyelesaian. Pewaktu tanpa aktivitas dapat menebak bahwa jeda berarti pindaian selesai. Pewaktu itu adalah perkiraan: semburan Bluetooth yang lambat dan pengetik yang cepat dapat sama-sama melewati celah yang sama. Utamakan akhiran yang dikonfigurasi bila alur kerja membutuhkan akhir yang tegas.

CR dan LF adalah byte. Enter papan ketik adalah event.key === "Enter". Keduanya tidak dapat saling menggantikan. Listener yang hanya membuang \r dari nilai masukan tidak akan melihat Enter baji, karena karakter itu tidak pernah disisipkan. Listener yang hanya mengawasi event.key tidak akan memecah buffer serial pada 0x0D. Beberapa perangkat mengirim NumPad Enter. event.key tetap "Enter". Periksa event.key, bukan hanya event.code === "Enter".

Akhiran dapat berubah saat seseorang memindai kode batang konfigurasi dari panduan perangkat. Uji lagi Enter, Tab, dan tanpa akhiran setelah setiap perubahan konfigurasi. Jangan membuat kode batang pemrograman sendiri. Pakai panduan untuk model itu.

Debug peristiwa papan ketik

Saat teks yang tersimpan salah, periksa peristiwa dalam urutan ini.

keydown. Menyala untuk setiap tombol, termasuk Enter dan Tab, sebelum peramban menyisipkan karakter atau memindahkan fokus. Baca penutup di sini.

input. Menyala setelah karakter yang dapat dicetak mengubah bidang. Peristiwa ini tidak menyala untuk Enter atau Tab pada masukan teks.

event.key. Karakter atau nama tombol setelah sistem operasi menerapkan tata letak papan ketik.

event.code. Tombol fisik, seperti Digit1 atau Numpad1. Nilainya dapat tetap sama saat ketidakcocokan tata letak mengubah event.key.

Fokus. Catat document.activeElement sebelum pindaian. Jika itu bukan bidang QR, sisa jejak sedang menjelaskan kontrol yang salah. iframe punya fokus sendiri.

Urutan. Untuk pindaian baji ke bidang teks, peristiwa keydown yang dapat dicetak diikuti pembaruan input, lalu keydown terakhir untuk Enter atau Tab bila akhiran itu dikonfigurasi. change menyala saat bidang mengunci nilai, biasanya pada blur. Pindaian yang meninggalkan fokus di bidang yang sama tidak menghasilkan change di akhir. Jangan memakai change sebagai satu-satunya sinyal selesai.

Waktu. Pemindai sering menyelesaikan muatan pendek jauh di bawah satu detik. Penguji masukan membandingkan celah rata-rata antarkarakter dengan ambang 100 ms dan memberi label hasil sebagai waktu, bukan identifikasi perangkat keras. Pengetik cepat, isi otomatis, atau emulator dapat jatuh di sisi pemindai dari ambang itu. Pindaian Bluetooth yang tertunda dapat terlihat seperti pengetikan. Tegaskan muatan dan akhiran. Perlakukan waktu sebagai petunjuk.

Gunakan penguji peristiwa papan ketik untuk mencantumkan setiap keydown dan keyup beserta key, code, pengubah, dan stempel waktu. Catatan itu adalah peristiwa peramban. Itu bukan lalu lintas USB mentah.

Uji tanpa pemindai QR fisik

Logika aplikasi dapat diuji sebelum pemindai ada di meja.

  • Ketik QR-INPUT-TEST-12345 ke bidang dan aktifkan Accept. Itu memeriksa validasi dan tampilan. Itu tidak memeriksa dekode atau akhiran.
  • Kendalikan bidang yang sama dari alat otomatisasi peramban, seperti yang dilakukan bagian berikutnya.
  • Pakai Barcode Scanner Emulator saat Anda membutuhkan pengetikan bergaya pemindai. Aplikasi desktop mengirim nilai yang Anda masukkan, dengan tundaan ketik dan akhiran tidak ada, ENTER, atau TAB, ke aplikasi yang sedang fokus. Emulator mereproduksi jalur papan ketik. Emulator tidak memotret gambar QR, tidak mendekode simbol, dan tidak membuat port COM virtual.

Perangkat keras tetap diperlukan untuk perilaku optik dan perangkat: apakah pemindai itu dapat membaca kode yang ditampilkan atau dicetak, apakah simbologi QR diaktifkan, tata letak papan ketik, konfigurasi akhiran, serta mode serial atau SDK vendor. Emulator adalah pemeriksaan yang tepat untuk jalur papan ketik. Emulator adalah pemeriksaan yang salah untuk membuktikan bahwa perangkat membaca kode QR tertentu.

Otomatiskan uji masukan QR

Pengujian Playwright berikut menggerakkan halaman contoh. Pengujian mengetik ke bidang seperti yang dilakukan pemindai baji, lalu menegaskan perilaku aplikasi. Pengujian tidak membuka perangkat USB. @playwright/test adalah dependensi pembaca. Situs ini tidak memerlukannya.

Simpan contoh HTML sebagai qr-form.html di samping pengujian ini.

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 menyisipkan karakter ke bidang yang fokus. Itu bukan gawai USB. Pengujian karakter tak terduga memakai fill karena tujuannya adalah pesan validasi dan tidak adanya elemen yang disuntikkan. Perluas berkas dengan kasus URL dan kasus JSON bila format itu ada dalam build yang Anda rilis. Penegasan URL harus membandingkan teks yang tertangkap dengan string QR asli.

Matriks uji pemindai QR

Jalankan ini terhadap aplikasi yang diuji. Halaman contoh di atas mencakup baris tiket, URL, JSON, duplikat, kosong, dan karakter tak terduga. Aplikasi yang hanya numerik atau banyak baris membutuhkan hasil yang diharapkan sendiri.

Skenario Hasil yang diharapkan
QR teks biasa Nilai persis diterima
QR berupa URL URL lengkap tertangkap, dan halaman tidak menavigasi ke sana
QR numerik Digit tetap utuh
Karakter khusus Karakter yang benar diterima
Muatan JSON Data tertangkap dan divalidasi
Akhiran ENTER Pemrosesan terjadi sekali
Akhiran TAB Perilaku fokus ditangani
Tanpa akhiran Aplikasi memakai mekanisme penyelesaian lain
Pindaian ganda Aplikasi menerapkan aturan penanganan duplikat
Muatan tidak valid Kesalahan validasi ditampilkan
Fokus tidak ada Aplikasi menangani masukan yang tidak ada dengan aman
Muatan panjang Tidak ada pemotongan yang tidak disengaja

Pindai juga muatan yang berisi baris baru jika produk harus menyimpannya. Catat apakah bidang menerima setiap baris.

Pemecahan masalah

Mulai dengan muatan yang diketahui di penguji masukan. Jika nilai penguji sudah salah, halaman bukan kesalahan pertama. Jika nilai penguji benar dan aplikasi salah, kesalahannya ada pada fokus, validasi, atau penanganan peristiwa. Pemindai kode batang tidak bekerja adalah daftar periksa perangkat yang lebih luas. Cara menguji masukan pemindai kode batang membahas fokus, tata letak, dan alur kerja POS di luar formulir ini.

Pemindai berbunyi bip tetapi tidak ada masukan

Bunyi bip biasanya berarti pemindai mendekode sebuah simbol. Bunyi itu tidak berarti halaman menerima teks. Pastikan mode baji papan ketik. Mode serial dan kamera tidak akan mengetik ke bidang. Klik bidang supaya document.activeElement adalah masukan itu, lalu pindai lagi. Bidang yang dinonaktifkan, hanya baca, atau tersembunyi dapat mengabaikan tombol.

Pemindai QR bekerja di Notepad tetapi tidak di peramban

Perangkat sedang mengetik. Halaman tidak menerima tombol itu. Periksa fokus, listener keydown yang memanggil preventDefault() pada tombol yang dapat dicetak, dan listener yang hanya menangani paste. Masukan baji tidak memicu peristiwa paste. Bandingkan hasil penguji dengan bidang aplikasi.

Pemindai membaca kode batang tetapi tidak membaca kode QR

Perangkat mungkin hanya 1D, atau simbologi QR mungkin dimatikan. Halaman tidak dapat memperbaiki itu. Pastikan dukungan 2D dan aktifkan QR Code dari panduan perangkat, dengan pemeriksaan di Pengujian kode QR: cara menguji pemindai kode QR. Pindaian Code 128 yang berhasil hanya membuktikan jalur papan ketik.

Karakter salah

Pindai QR-INPUT-TEST-12345 lebih dahulu. Jika itu cocok dan muatan URL atau JSON tidak, tata letak sedang mengubah tanda baca seperti :, /, {, atau ". Bandingkan event.key dengan event.code di penguji peristiwa papan ketik, dan lihat Tata letak papan ketik pemindai kode batang salah. Cocokkan tata letak papan ketik pemindai dengan sistem operasi.

ENTER mengirim formulir dua kali

Peramban mengirim formulir, dan listener keydown juga menangani Enter. Pertahankan satu jalur penyelesaian dan panggil preventDefault() di sana. Pindaian fisik kedua adalah kegagalan yang berbeda. Teks status pada contoh mengatakan muatan sudah diterima. Jika pindaian pertama sendiri membuat dua rekaman, cari dua listener sebelum mengubah pemindai.

Masukan QR terpotong

Bandingkan jumlah karakter di penguji masukan dengan nilai di bidang. Atribut maxlength, masker masukan, atau preventDefault() pada tombol karakter dapat memotong string. Baris baru di dalam muatan QR dapat mengirim masukan satu baris terlalu awal. Beberapa pemindai juga membatasi jumlah karakter yang diketik. Naikkan batas itu dari panduan perangkat bila penguji, bukan hanya aplikasi, menunjukkan nilai yang pendek. Pemindai kode batang tidak mengirim ENTER membahas kasus terkait, saat muatan tiba dan formulir tidak pernah mengunci nilai.

Pemindai tidak dapat membaca kode QR di layar

Pastikan pemindai adalah pencitra 2D. Naikkan kecerahan layar, perbesar ukuran kode, dan jaga zona tenang bebas dari teks dan bingkai. Silau, layar ponsel yang redup, dan kode yang terlalu rapat untuk jarak kerja adalah masalah optik. Cetak muatan yang sama jika pembacaan layar terus gagal. Uji aplikasi tetap memakai string yang diketahui begitu pindaian apa pun menghasilkan teks.