Langkau ke kandungan

Barcode Scanner Emulator

Cara Menguji Input Pengimbas Kod QR dalam Aplikasi Web

Banyak pengimbas luaran yang menyokong QR menggunakan mod baji papan kekunci dan menaip teks QR yang dinyahkod ke dalam medan yang difokus. Uji laluan itu dengan mengimbas muatan yang diketahui dan membandingkannya dengan nilai yang diterima oleh halaman. Bukan setiap pengimbas QR menaip seperti papan kekunci. Peranti bersiri dan penyahkod kamera ialah integrasi yang berbeza, dan peristiwa papan kekunci pelayar tidak mengenal pasti pengimbas fizikal.

Kod QR menyimpan data. Pengimbas, atau penyahkod kamera, menukar data itu menjadi teks. Aplikasi web kemudian perlu menerima teks itu, memutuskan bila imbasan selesai, dan mengesahkannya. Panduan ini ialah ujian aplikasi itu. Menjana label, menyemak kontras, dan mengesahkan peranti dapat menyahkod QR Code dibincangkan dalam Ujian Kod QR: Cara Menguji Pengimbas Kod QR. Borang kod bar umum, termasuk digit semak EAN, dibincangkan dalam Cara Menguji Pengimbas Kod Bar dalam Aplikasi Web.

Uji Input Pengimbas QR dalam 60 Saat

Gunakan muatan yang anda pilih sendiri, supaya aksara yang salah jelas kelihatan. Langkah ini menggunakan QR-INPUT-TEST-12345.

  1. Buka Penjana Kod QR dan jana kod QR untuk QR-INPUT-TEST-12345. Penjana berjalan dalam pelayar. Penjana tidak menghubungi pengimbas.
  2. Sambungkan pengimbas yang menyokong QR dan ditetapkan kepada mod baji papan kekunci. Pengimbas 1D sahaja tidak dapat menyahkod simbol ini.
  3. Buka Penguji Input Kod Bar.
  4. Klik Mula Ujian, atau klik kawasan imbasan, supaya medan mendapat fokus. Penguji tidak mengambil fokus sendiri, dan tidak membuka pengimbas.
  5. Imbas kod QR.
  6. Baca teks yang ditangkap dan bilangan aksara.
  7. Bandingkan teks itu dengan QR-INPUT-TEST-12345. Padanan merangkumi huruf besar dan kecil, sempang dan panjang.
  8. Baca akhiran. Penguji melaporkan ENTER, TAB atau Tiada apabila pengimbas menghantar salah satu kekunci itu.

Penguji merekod peristiwa papan kekunci yang boleh dilihat oleh pelayar. Ia tidak mengenal pasti peranti USB, tidak membaca port siri, dan tidak menyahkod imej QR.

Mod Input Pengimbas QR

Kod QR bercetak yang sama boleh tiba melalui tiga integrasi yang berbeza. Ujian satu mod tidak menguji mod yang lain.

Pengimbas QR baji papan kekunci

Dalam mod papan kekunci USB HID, atau mod papan kekunci Bluetooth HID, sistem pengendalian menganggap pengimbas sebagai papan kekunci. Selepas penyahkodan, pengimbas menaip muatan ke dalam kawalan yang memegang fokus. <input> atau <textarea> biasa boleh menerimanya. Halaman tidak membuka peranti. Panduan Baji Papan Kekunci HID menerangkan urutan ketukan, awalan dan akhiran.

Fokus menentukan destinasi. Jika elemen yang difokus ialah body dokumen, butang, atau bingkai lain, pendengar medan ini tidak melihat imbasan.

Pengimbas QR bersiri

Pengimbas port siri USB atau port COM maya menghantar teks yang dinyahkod sebagai bait kepada proses yang membuka port. Fokus tidak memilih proses itu. Medan yang hanya mendengar ketukan kekal kosong manakala terminal pada port itu menunjukkan muatan.

Pelayar berasaskan Chromium boleh membuka port yang dipilih pengguna dengan Web Serial API, dalam konteks selamat, selepas gerak isyarat pengguna. Firefox dan Safari tidak menyediakan API itu. Pengimbas baji tidak muncul sebagai port siri. Nama port, baud dan pembingkaian bergantung pada peranti dan pemacu. Pengimbas Kod Bar USB HID dan Bersiri membandingkan kedua-dua antara muka. Penguji Input Kod Bar tidak dapat membaca port COM.

Pengimbasan QR berasaskan kamera

Integrasi kamera menangkap imej dan menyahkod kod QR dalam perisian. Halaman menggunakan API kamera dan penyahkod. Ia tidak menerima peristiwa keydown untuk muatan. Aplikasi kamera telefon, butang kamera dalam halaman, dan pengimej perkakasan yang menaip ke dalam medan ialah tiga produk yang berbeza. Lulus ujian baji tidak bermakna butang kamera berfungsi, dan penyahkodan kamera yang berjaya tidak bermakna pengimbas baji akan menaip rentetan yang sama.

Tangkap Input Pengimbas QR dengan JavaScript

Halaman di bawah membaca satu medan yang difokus. Enter menghantar borang, dan butang Accept menggunakan pengendali submit yang sama, jadi satu imbasan diproses sekali. Tanpa akhiran ENTER, teks kekal dalam medan sehingga seseorang mengaktifkan Accept. Muatan yang ditangkap ditulis dengan textContent, jadi aksara seperti < kekal kelihatan sebagai teks.

Contoh menerima tiga format aplikasi: id tiket seperti QR-INPUT-TEST-12345, URL http atau https, atau objek JSON. Ia merekod teks yang diimbas. Ia tidak menavigasi ke URL yang ditemui dalam kod QR. Pengimbas yang tidak menghantar Enter masih berfungsi melalui butang. Tab bergerak melalui label, medan dan butang seperti biasa, kerana skrip tidak memerangkapnya.

<!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 fail dan buka dalam pelayar desktop. Klik medan sebelum mengimbas. autocomplete="off" mengurangkan kemungkinan nilai yang disimpan menggantikan imbasan. Label dan butang kekal tersedia, jadi seseorang boleh menaip muatan tanpa pengimbas.

Kendalikan Enter dalam peristiwa submit borang sahaja. Pendengar keydown kedua untuk Enter merekod imbasan yang sama dua kali. preventDefault() mengekalkan pelayar pada halaman ini. Kosongkan medan selepas keputusan supaya imbasan seterusnya tidak ditambah pada teks sebelumnya.

Muatan QR boleh mengandungi pemisah baris. Pengimbas baji sering menaip pemisah itu sebagai Enter. Dalam input satu baris, borang boleh dihantar pada baris pertama dan menggugurkan yang lain. Gunakan textarea, atau pembaca siri yang menyimpan bait, apabila aplikasi mesti menerima teks berbilang baris. Sahkan kelakuan itu dengan kod QR yang muatannya mengandungi baris baharu.

Mengendalikan Muatan QR

Simbol QR tidak menjanjikan format aplikasi. Simbologi yang sama boleh membawa mana-mana daripada ini:

  • Teks biasa, seperti QR-INPUT-TEST-12345.
  • URL.
  • Pengecam yang dipilih oleh aplikasi.
  • Muatan berstruktur, seperti nombor tiket ditambah kod lokasi.
  • Teks JSON, apabila aplikasi mentakrifkan pengekodan itu.

Pengimbas menghantar aksara yang dinyahkod. Ia tidak menyemak sama ada aksara itu sepadan dengan peraturan tiket, katalog produk atau skema JSON. Sahkan rentetan pada halaman, dan sahkan sekali lagi pada pelayan. Nilai yang dipos ialah input pengguna biasa. Pelayar tidak dapat membuktikan bahawa pengimbas menghasilkannya.

Sahkan Input QR

Jangan anggap muatan QR berbentuk angka. Peraturan EAN-13 tidak terpakai. Anggap teks sebagai tidak dipercayai: paparkan sebagai teks, dan jangan tetapkan kepada location, innerHTML atau URL skrip.

Nilai kosong. Enter kosong, atau Accept pada medan kosong, tidak patut mencipta rekod. trim() juga menolak muatan yang hanya mengandungi ruang.

Aksara yang tidak dijangka. Bandingkan rentetan yang diterima dengan kandungan QR yang diketahui. Ketidakpadanan susun atur papan kekunci sering mengubah tanda baca manakala panjang kekal sama. Tolak aksara yang tidak dibenarkan oleh format, dan tunjukkan sebab dalam teks status.

Panjang muatan. Kuatkuasakan maksimum yang disimpan oleh aplikasi. maxlength pada input memotong imbasan yang lebih panjang tanpa ralat. Tetapkan hanya apabila setiap muatan yang diterima muat, dan bandingkan bilangan aksara penguji dengan medan apabila nilai kelihatan pendek.

Awalan yang diperlukan. Semakan awalan milik aplikasi. Peraturan tiket ini menerima QR- serta huruf besar, digit dan sempang:

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

Buang awalan pengimbas hanya apabila pengimbas itu dikonfigurasi untuk menghantar satu awalan yang tepat dan aplikasi tidak menyimpannya. Pengecam simbologi AIM ialah data sehingga anda memutuskan sebaliknya.

Format khusus aplikasi. Kekalkan peraturan di sebelah format. Borang tiket, senarai URL yang dibenarkan, dan objek JSON memerlukan semakan yang berbeza. Satu corak angka akan menolak teks QR yang sah.

Imbasan pendua. Satu imbasan fizikal boleh mengenai dua pendengar. Gunakan satu laluan penyiapan, seperti yang dilakukan oleh contoh. Tarikan picu kedua ialah peristiwa yang berasingan. Contoh menolak muatan yang telah diterima. Borang gudang mungkin menambah kuantiti. Uji peraturan yang didokumenkan oleh aplikasi.

JSON yang rosak. JSON.parse membaling ralat pada teks yang tidak lengkap. Semak bentuk selepas penghuraian berjaya. Tatasusunan atau nombor semata-mata boleh menjadi JSON yang sah dan masih jenis yang 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 dijangka. Hurai URL untuk melihat sama ada ia boleh digunakan, kemudian simpan rentetan yang diimbas jika ujian mesti sepadan tepat dengan muatan QR. URL.href boleh menambah garis miring atau mengubah pengekodan. Terima hanya skema yang dimaksudkan oleh aplikasi. Jangan buka URL sebagai kesan sampingan imbasan:

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

Aksara kawalan. Tolak aksara kawalan ASCII dalam muatan papan kekunci supaya awalan tersembunyi kekal kelihatan dalam teks status. CR dan LF ialah aksara kawalan. Pada pengimbas baji, Enter dan Tab ialah kekunci. Ia bukan aksara di dalam input teks biasa. Muatan siri mungkin masih mengandungi bait 0x0D atau 0x0A. Buang bait itu di sempadan pembingkaian siri, dan jangan keluarkan CR yang berada di tengah muatan berbilang baris.

Akhiran ENTER dan TAB

Akhiran ialah konfigurasi pengimbas yang pilihan. Ia bukan sebahagian daripada simbol QR. Akhiran ENTER dan TAB pada Pengimbas Kod Bar menunjukkan cara membezakan kekunci. Baca akhiran dalam penguji input, kemudian jadikan halaman sepadan dengan pengimbas yang anda gunakan.

ENTER menghantar borang medan teks satu baris dalam pelayar semasa. Gunakannya apabila satu imbasan patut mengesahkan nilai. Panggil preventDefault() pada submit apabila halaman patut kekal di tempat.

TAB mengalih fokus ke kawalan seterusnya. Baca nilai dalam keydown semasa medan masih mempunyai fokus. Biarkan tindakan lalai apabila medan seterusnya patut menerima fokus. Abaikan Shift+Tab supaya pengguna papan kekunci boleh bergerak ke belakang.

Tiada akhiran meninggalkan muatan dalam medan. Butang Accept dalam contoh ialah laluan penyiapan. Pemasa tidak aktif boleh meneka bahawa jeda bermakna imbasan tamat. Pemasa itu ialah anggaran: letusan Bluetooth yang perlahan dan penekan yang pantas boleh sama-sama merentasi jurang yang sama. Utamakan akhiran yang dikonfigurasi apabila aliran kerja memerlukan penghujung yang tegas.

CR dan LF ialah bait. Enter papan kekunci ialah event.key === "Enter". Kedua-duanya tidak boleh saling ganti. Pendengar yang hanya membuang \r daripada nilai input tidak akan melihat Enter baji, kerana aksara itu tidak pernah dimasukkan. Pendengar yang hanya memerhati event.key tidak akan memecahkan penimbal siri pada 0x0D. Sesetengah peranti menghantar NumPad Enter. event.key masih "Enter". Semak event.key, bukan hanya event.code === "Enter".

Akhiran boleh berubah apabila seseorang mengimbas kod bar konfigurasi daripada manual peranti. Uji semula Enter, Tab dan tiada akhiran selepas sebarang perubahan konfigurasi. Jangan cipta kod bar pengaturcaraan. Gunakan manual untuk model itu.

Nyahpepijat Peristiwa Papan Kekunci

Apabila teks yang disimpan salah, periksa peristiwa mengikut urutan ini.

keydown. Berlaku untuk setiap kekunci, termasuk Enter dan Tab, sebelum pelayar memasukkan aksara atau mengalih fokus. Baca penamat di sini.

input. Berlaku selepas aksara yang boleh dicetak mengubah medan. Ia tidak berlaku untuk Enter atau Tab pada input teks.

event.key. Aksara atau nama kekunci selepas sistem pengendalian menggunakan susun atur papan kekunci.

event.code. Kekunci fizikal, seperti Digit1 atau Numpad1. Ia boleh kekal sama apabila ketidakpadanan susun atur mengubah event.key.

Fokus. Catat document.activeElement sebelum imbasan. Jika ia bukan medan QR, jejak yang selebihnya menerangkan kawalan yang salah. iframe mempunyai fokus sendiri.

Urutan. Bagi imbasan baji ke dalam medan teks, peristiwa keydown yang boleh dicetak diikuti kemas kini input, kemudian keydown akhir untuk Enter atau Tab apabila akhiran itu dikonfigurasi. change berlaku apabila medan mengesahkan nilai, biasanya pada blur. Imbasan yang meninggalkan fokus pada medan yang sama tidak menghasilkan change pada penghujung. Jangan gunakan change sebagai satu-satunya isyarat selesai.

Pemasa. Pengimbas sering menamatkan muatan pendek jauh di bawah satu saat. Penguji input membandingkan jurang purata antara aksara dengan ambang 100 ms dan melabel hasil sebagai pemasa, bukan pengenalpastian perkakasan. Penekan pantas, isian automatik atau emulator boleh jatuh di sebelah pengimbas ambang itu. Imbasan Bluetooth yang tertunda boleh kelihatan seperti menaip. Tegaskan muatan dan akhiran. Anggap pemasa sebagai petunjuk.

Penguji Peristiwa Papan Kekunci menyenaraikan setiap keydown dan keyup bersama key, code, pengubah dan cap masa. Log itu ialah peristiwa pelayar. Ia bukan trafik USB mentah.

Uji Tanpa Pengimbas QR Fizikal

Logik aplikasi boleh diuji sebelum pengimbas ada di meja.

  • Taip QR-INPUT-TEST-12345 ke dalam medan dan aktifkan Accept. Itu menyemak pengesahan dan paparan. Ia tidak menyemak penyahkodan atau akhiran.
  • Pacu medan yang sama daripada alat automasi pelayar, seperti yang dilakukan oleh bahagian seterusnya.
  • Gunakan Barcode Scanner Emulator apabila anda memerlukan penaipan gaya pengimbas. Aplikasi desktop menghantar nilai yang anda masukkan, dengan lengah menaip dan akhiran tiada, ENTER atau TAB, ke dalam aplikasi yang difokus. Ia menghasilkan semula laluan papan kekunci. Ia tidak mengambil gambar imej QR, tidak menyahkod simbol dan tidak mencipta port COM maya.

Perkakasan masih diperlukan untuk kelakuan optik dan peranti: sama ada pengimbas itu dapat membaca kod yang dipaparkan atau dicetak, sama ada simbologi QR didayakan, susun atur papan kekunci, konfigurasi akhiran, serta mod siri atau SDK vendor. Emulator ialah semakan yang betul untuk laluan papan kekunci. Ia ialah semakan yang salah untuk membuktikan peranti membaca kod QR tertentu.

Automatikkan Ujian Input QR

Ujian Playwright berikut memacu halaman contoh. Ujian menaip ke dalam medan seperti yang dilakukan oleh pengimbas baji, kemudian menegaskan kelakuan aplikasi. Ujian tidak membuka peranti USB. @playwright/test ialah kebergantungan pembaca. Laman ini tidak memerlukannya.

Simpan contoh HTML sebagai qr-form.html di sebelah ujian 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 memasukkan aksara ke dalam medan yang difokus. Ia bukan gajet USB. Ujian aksara yang tidak dijangka menggunakan fill kerana matlamatnya ialah mesej pengesahan dan ketiadaan elemen yang disuntik. Luaskan fail dengan kes URL dan kes JSON apabila format itu ada dalam binaan yang anda keluarkan. Penegasan URL patut membandingkan teks yang ditangkap dengan rentetan QR asal.

Matriks Ujian Pengimbas QR

Jalankan ini terhadap aplikasi yang diuji. Halaman contoh di atas merangkumi baris tiket, URL, JSON, pendua, kosong dan aksara yang tidak dijangka. Aplikasi angka sahaja atau berbilang baris memerlukan hasil yang dijangka sendiri.

Senario Hasil yang dijangka
QR teks biasa Nilai tepat diterima
QR berbentuk URL URL lengkap ditangkap, dan halaman tidak menavigasi ke sana
QR angka Digit kekal
Aksara khas Aksara yang betul diterima
Muatan JSON Data ditangkap dan disahkan
Akhiran ENTER Pemprosesan berlaku sekali
Akhiran TAB Kelakuan fokus dikendalikan
Tiada akhiran Aplikasi menggunakan mekanisme penyiapan lain
Imbasan pendua Aplikasi menggunakan peraturan pengendalian pendua
Muatan tidak sah Ralat pengesahan dipaparkan
Fokus tiada Aplikasi mengendalikan input yang tiada dengan selamat
Muatan panjang Tiada pemotongan yang tidak disengajakan

Imbas juga muatan yang mengandungi baris baharu jika produk mesti menyimpannya. Catat sama ada medan menerima setiap baris.

Penyelesaian Masalah

Mulakan dengan muatan yang diketahui dalam penguji input. Jika nilai penguji sudah salah, halaman bukan kesalahan pertama. Jika nilai penguji betul dan aplikasi salah, kesalahan terletak pada fokus, pengesahan atau pengendalian peristiwa. Pengimbas Kod Bar Tidak Berfungsi ialah senarai semak peranti yang lebih luas. Cara Menguji Input Pengimbas Kod Bar merangkumi fokus, susun atur dan aliran kerja POS di luar borang ini.

Pengimbas berbunyi bip tetapi tiada input

Bunyi bip biasanya bermakna pengimbas menyahkod simbol. Ia tidak bermakna halaman menerima teks. Sahkan mod baji papan kekunci. Mod siri dan kamera tidak akan menaip ke dalam medan. Klik medan supaya document.activeElement ialah input itu, kemudian imbas semula. Medan yang dilumpuhkan, baca sahaja atau tersembunyi boleh mengabaikan kekunci.

Pengimbas QR berfungsi dalam Notepad tetapi tidak dalam pelayar

Peranti sedang menaip. Halaman tidak menerima kekunci itu. Semak fokus, pendengar keydown yang memanggil preventDefault() pada kekunci yang boleh dicetak, dan pendengar yang hanya mengendalikan paste. Input baji tidak mencetuskan peristiwa paste. Bandingkan hasil penguji dengan medan aplikasi.

Pengimbas membaca kod bar tetapi tidak membaca kod QR

Peranti mungkin 1D sahaja, atau simbologi QR mungkin dimatikan. Halaman tidak dapat membetulkannya. Sahkan sokongan 2D dan dayakan QR Code daripada manual peranti, menggunakan semakan dalam Ujian Kod QR: Cara Menguji Pengimbas Kod QR. Imbasan Code 128 yang berjaya hanya membuktikan laluan papan kekunci.

Aksara tidak betul

Imbas QR-INPUT-TEST-12345 dahulu. Jika nilai itu sepadan dan muatan URL atau JSON tidak, susun atur sedang mengubah tanda baca seperti :, /, { atau ". Bandingkan event.key dengan event.code dalam penguji peristiwa papan kekunci, dan lihat Susun Atur Papan Kekunci Pengimbas Kod Bar Salah. Padankan susun atur papan kekunci pengimbas dengan sistem pengendalian.

ENTER menghantar borang dua kali

Pelayar menghantar borang, dan pendengar keydown juga mengendalikan Enter. Kekalkan satu laluan penyiapan dan panggil preventDefault() di situ. Imbasan fizikal kedua ialah kegagalan yang berbeza. Teks status dalam contoh menyatakan muatan telah diterima. Jika imbasan pertama sendiri mencipta dua rekod, cari dua pendengar sebelum menukar pengimbas.

Input QR terpotong

Bandingkan bilangan aksara dalam penguji input dengan nilai dalam medan. Atribut maxlength, topeng input atau preventDefault() pada kekunci aksara boleh memotong rentetan. Baris baharu di dalam muatan QR boleh menghantar input satu baris terlalu awal. Sesetengah pengimbas juga mengehadkan bilangan aksara yang ditaip. Naikkan had itu daripada manual peranti apabila penguji, bukan sahaja aplikasi, menunjukkan nilai yang pendek. Pengimbas Kod Bar Tiada ENTER merangkumi kes berkaitan, apabila muatan tiba dan borang tidak pernah mengesahkan nilai.

Pengimbas tidak dapat membaca kod QR pada skrin

Sahkan pengimbas ialah pengimej 2D. Tinggikan kecerahan paparan, besarkan saiz kod, dan kekalkan zon senyap bebas daripada teks dan sempadan. Silau, skrin telefon yang malap, dan kod yang terlalu padat untuk jarak kerja ialah masalah optik. Cetak muatan yang sama jika bacaan skrin terus gagal. Ujian aplikasi masih menggunakan rentetan yang diketahui sebaik sahaja sebarang imbasan menghasilkan teks.