Lewati ke konten

Barcode Scanner Emulator

Cara menguji pemindai kode batang di aplikasi web

Banyak pemindai kode batang USB dan Bluetooth mengirim data yang sudah didekode sebagai masukan papan ketik, jadi bidang yang sedang fokus di aplikasi web dapat menerima pindaian tanpa API peramban khusus pemindai. Port serial dan SDK vendor adalah integrasi yang terpisah. Jalur papan ketik dapat diuji dengan pemindai fisik atau dengan ketukan tombol yang disimulasikan.

Aplikasi web biasanya melihat pemindai kode batang sebagai papan ketik. Yang diuji adalah apakah kontrol yang sedang fokus menerima muatan yang diharapkan aplikasi, dan apakah halaman menangani penutup yang dikonfigurasi pada pemindai. Penutup itu bisa berupa Enter, Tab, atau tidak ada sama sekali.

Gunakan sesi penguji masukan kode batang saat pemindai fisik terpasang. Gunakan Barcode Scanner Emulator saat Anda membutuhkan jalur papan ketik yang sama selama pengembangan dan perangkat keras tidak ada di meja. Pemeriksaan yang lebih luas atas fokus, tata letak, dan alur kerja POS ada di Cara menguji masukan pemindai kode batang. Panduan ini tetap pada aplikasi peramban: penangkapan, akhiran, validasi, dan peristiwa yang benar-benar dapat diamati.

Cara pemindai kode batang berkomunikasi dengan aplikasi web

Mode antarmuka menentukan apa yang dapat diterima halaman. Konfirmasikan mode itu sebelum mengubah kode formulir. Pemindai sering dapat berganti mode dengan memindai kode batang konfigurasi dari panduan pabrikan.

Baji papan ketik USB HID

Dalam mode papan ketik USB HID, pemindai terenumerasi sebagai papan ketik. Sistem operasi memuat driver papan ketik biasa. Setelah pemindai mendekode simbol, ia mengirim karakter sebagai ketukan tombol ke kontrol yang memegang fokus papan ketik. Halaman mendengarkan ketukan itu, atau membaca teks yang disisipkan. Halaman tidak membuka koneksi ke perangkat.

Jalur itulah sebabnya bidang kasir, kotak pencarian, atau masukan teks lain dapat menerima pindaian dengan HTML biasa. Panduan HID keyboard wedge membahas urutan ketukan, awalan, dan akhiran secara lebih rinci.

Bluetooth HID

Pemindai Bluetooth yang dipasangkan sebagai papan ketik memakai jalur aplikasi yang sama. Host memperlakukannya sebagai papan ketik HID, dan bidang yang fokus menerima ketukan. Penyandingan, baterai, dan radio adalah urusan perangkat. Setelah karakter sampai di peramban, halaman menanganinya dengan cara yang sama seperti masukan baji USB.

Serial dan port COM virtual

Pemindai serial, termasuk banyak mode port COM virtual USB, mengirim teks yang sudah didekode sebagai byte pada sebuah port. Fokus tidak memilih tujuan. Proses yang membuka port yang memilih. Bidang teks yang hanya mendengarkan ketukan tidak akan melihat aliran itu.

Peramban berbasis Chromium dapat membuka port serial melalui Web Serial API setelah pengguna memilih port dan memberi izin. Firefox dan Safari tidak menyediakan API itu. Uji baji tidak melatih integrasi serial, dan uji serial tidak memberi tahu apa yang akan diketik pemindai baji.

Antarmuka khusus vendor

Beberapa perangkat memakai SDK vendor, OPOS, JPOS, atau antarmuka HID non-papan ketik seperti USB HID POS. Antarmuka itu tidak mengetik ke bidang yang fokus. Halaman web biasa tidak dapat memuat SDK native. Chromium dapat meminta beberapa perangkat HID non-papan ketik melalui WebHID setelah gestur pengguna. Perangkat HID kelas papan ketik tetap diblokir, jadi pemindai baji tidak dapat dibedakan dari papan ketik. Perlakukan antarmuka vendor sebagai integrasi tersendiri dan uji dengan perangkat lunak yang benar-benar membuka antarmuka itu.

Apa yang dapat dilihat peramban

Pindaian baji tiba sebagai peristiwa keydown dan keyup, dan karakter yang dapat dicetak memperbarui bidang yang fokus. Peramban tidak menerima nama perangkat, nomor seri USB, atau bendera yang mengatakan bahwa ini pemindai. Peramban yang mengimplementasikan WebHID tetap menolak antarmuka papan ketik, jadi skrip halaman juga tidak dapat membaca laporan HID mentah dari pemindai baji.

event.key adalah karakter atau nama tombol setelah sistem operasi menerapkan tata letak papan ketik yang aktif. event.code menamai tombol fisik, seperti Digit1 atau Numpad1, dan dapat tetap sama saat ketidakcocokan tata letak mengubah event.key. Kedua properti itu tidak mengidentifikasi perangkat keras.

Cara menguji pemindai kode batang fisik di peramban

Jalankan ini sebelum men-debug kode aplikasi. Hasilnya menunjukkan string dan penutup persis yang diterima peramban.

  1. Hubungkan pemindai dan tunggu sampai pemindai menunjukkan bahwa daya sudah masuk. Untuk Bluetooth, selesaikan penyandingan dan pastikan host memakai profil papan ketik.
  2. Pastikan mode masukan. Baji papan ketik, papan ketik USB HID, atau papan ketik Bluetooth HID dapat mengetik ke bidang. Mode serial, SPP, dan SDK vendor tidak bisa.
  3. Buka penguji masukan kode batang.
  4. Klik Mulai pengujian, atau klik area pindai. Area itu menjadi biru saat siap. Halaman tidak mengambil fokus sendiri.
  5. Pindai kode batang yang muatannya sudah Anda ketahui. Mulai dengan nilai numerik pendek, lalu pindai nilai yang memuat tanda baca yang disimpan aplikasi.
  6. Baca nilai yang tertangkap dan jumlah karakter. Bandingkan keduanya dengan muatan yang Anda harapkan, termasuk awalan apa pun yang disisipkan pemindai sebelum data.
  7. Periksa akhiran. Penguji melaporkan ENTER, TAB, atau Tidak ada. Saat Tangkapan otomatis aktif, hasil muncul setelah Enter, Tab, atau jeda singkat begitu tombol berhenti. Matikan Tangkapan otomatis bila Anda ingin tangkapan ditahan sampai Anda menekan Berhenti.
  8. Bandingkan hasil itu dengan string yang seharusnya disimpan aplikasi. Awalan, karakter yang terganti, atau penutup yang hilang harus diperbaiki di konfigurasi pemindai atau ditangani dengan sengaja di halaman. Jangan anggap itu kegagalan dekode sebelum perbandingan ini selesai.

Penguji merekam peristiwa papan ketik yang dapat dilihat peramban. Penguji tidak dapat mengidentifikasi perangkat USB atau membaca port serial. Bila editor teks menerima pindaian dan peramban tidak, lanjutkan dengan Pemindai bekerja di Notepad tetapi tidak di POS.

Menangkap masukan pemindai kode batang dengan JavaScript

Pemindai mengetik ke elemen yang sedang fokus. Beri bidang label yang terlihat, biarkan sebagai masukan teks biasa agar pengguna papan ketik dapat mengetik kode, dan baca nilai saat alur kerja menyatakan entri selesai. Halaman di bawah melakukan itu. Enter mengirim formulir sekali. Tab menyelesaikan nilai yang tidak kosong, lalu membiarkan peramban memindahkan fokus. Pindaian tanpa penutup tetap di bidang sampai seseorang mengaktifkan Look up.

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

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

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

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

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

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

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

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

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

Simpan berkas itu dan buka di peramban desktop. Klik bidang jika fokus sudah berpindah. Pemindai baji, atau emulator di bagian berikutnya, kemudian mengetik ke #barcode.

Fokus wajib ada. Jika document.activeElement adalah body dokumen, sebuah tombol, atau masukan lain, listener bidang ini tidak melihat pindaian. Karakter masuk ke kontrol yang fokus, atau hilang. Panggil field.focus() saat alur kerja siap menerima pindaian, termasuk setelah dialog tertutup.

Masukan kosong diabaikan. Formulir tetap di tempatnya, dan teks status menyatakan bahwa tidak ada yang diterima. Spasi saja menjadi kosong setelah trim().

Contoh ini tidak menambahkan Enter atau Tab. Jika pemindai tidak dikonfigurasi untuk mengirimnya, nilai tetap di bidang dan Look up adalah jalur penyelesaian. autocomplete="off" mengurangi kemungkinan nilai tersimpan menggantikan pindaian. Label, tombol, dan Shift+Tab tetap tersedia, jadi seseorang dapat memasukkan kode tanpa pemindai.

Tangani Enter di satu tempat. Contoh ini memakai peristiwa submit formulir, yang juga mencakup tombol Look up dan Enter dari papan ketik. Listener keydown kedua untuk Enter akan mencatat pindaian yang sama dua kali. Jika masukan tidak berada di dalam formulir, dengarkan Enter pada keydown dan panggil preventDefault() agar formulir leluhur tidak ikut terkirim:

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

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

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

Kosongkan bidang setelah penerimaan berhasil supaya pindaian berikutnya tidak menempel pada muatan sebelumnya. Setelah Enter, contoh memfokuskan bidang yang sama lagi karena alur kerja itu mengharapkan pindaian berikutnya di kotak yang sama. Setelah Tab, fokus dibiarkan agar peramban dapat pindah ke kontrol berikutnya.

Menangani akhiran ENTER dan TAB

Akhiran adalah tombol yang mungkin dikirim pemindai setelah muatan. Itu pengaturan perangkat. Enter umum, dan bersifat opsional. Panduan Akhiran ENTER vs TAB pada pemindai kode batang menjelaskan cara membedakan penutup. Konfirmasikan pengaturan pada pemindai yang sedang diuji, lalu sesuaikan halaman dengan alur kerja itu.

ENTER

Enter di dalam bidang teks satu baris mengirim formulir yang melingkupinya pada peramban saat ini. Pakai itu saat satu pindaian harus mengunci nilai, seperti kotak pencarian. preventDefault() pada peristiwa submit menghentikan peramban agar tidak berpindah halaman. Hilangkan panggilan itu bila navigasi halaman penuh adalah perilaku yang Anda inginkan.

Jika kode batang muncul dan formulir tidak melakukan apa-apa, pemindai mungkin tidak mengirim akhiran. Pemindai kode batang tidak mengirim ENTER menelusuri konfigurasi itu. Beberapa perangkat mengirim NumPad Enter. event.key tetap "Enter". Periksa event.key, jangan hanya event.code === "Enter", atau pemindai itu akan terlihat rusak.

TAB

Tab memindahkan fokus ke kontrol berikutnya yang dapat difokuskan. Itu cocok untuk urutan seperti kode produk, lalu jumlah. Hal itu mengejutkan formulir yang mengharapkan Enter untuk mengirim.

Baca nilai di keydown selagi bidang masih fokus. Peramban memindahkan fokus setelah peristiwa itu. Biarkan tindakan bawaan bila kontrol berikutnya harus menerima fokus. preventDefault() menahan fokus di tempatnya, berguna saat nilai tidak valid dan Anda ingin operator melihatnya. Abaikan Shift+Tab agar pengguna papan ketik dapat bergerak mundur melalui formulir. Akhiran Tab pemindai adalah Tab tanpa Shift.

Akhiran Tab juga dapat memindahkan fokus sebelum kode Anda membaca bidang, jika listener ada di blur atau change dan sesuatu yang lain mengosongkan kontrol. Baca nilai dari target peristiwa keydown.

Tanpa akhiran

Tanpa akhiran, muatan duduk di bidang. Aplikasi harus memutuskan kapan pindaian selesai. Tombol yang eksplisit, Enter belakangan dari operator, atau pindah ke langkah lain adalah titik penyelesaian yang andal. Pewaktu tidak aktif dapat menganggap jeda mengetik sebagai akhir pindaian. Pewaktu itu heuristik. Pemindai yang lambat, tundaan Bluetooth, atau orang yang mengetik cepat dapat jatuh di sisi ambang yang salah. Utamakan akhiran yang dikonfigurasi bila alur kerja membutuhkan sinyal akhir pindaian yang tegas.

Perbedaan konfigurasi

Pemindai merek yang sama dapat dikirim dengan akhiran yang berbeda, dan kode batang konfigurasi dapat mengubah akhiran tanpa perubahan apa pun pada JavaScript Anda. Beberapa perangkat mengirim awalan, pengenal simbologi seperti ]C1, atau CR dan LF. Uji tiga pengaturan penutup yang benar-benar dapat dipilih pengguna: Enter, Tab, dan tidak ada. Catat mana yang dipakai pemindai yang sudah terpasang, dan uji halaman terhadap pengaturan itu.

Validasi masukan pemindai kode batang

Validasi string yang diterima bidang. Jangan menganggap setiap kode batang memiliki panjang, himpunan karakter, atau checksum yang sama. Muatan Code 128 dan QR bervariasi. EAN-13 terdiri dari 13 digit. Aplikasi yang menyimpan keduanya membutuhkan aturan untuk keduanya.

Masukan kosong. Tolak atau abaikan. Akhiran tanpa muatan, atau klik Look up pada bidang kosong, tidak boleh membuat rekaman.

Karakter yang tidak terduga. Bandingkan string yang diterima dengan label yang diketahui. Ketidakcocokan tata letak sering muncul sebagai simbol yang berubah, seperti digit atau tanda baca yang bergeser, sementara panjangnya tetap. Karakter kontrol dapat berasal dari awalan atau dari pemisah grup GS1. Izinkan karakter yang didefinisikan format Anda. Contoh di atas menolak karakter kontrol ASCII agar tetap terlihat di teks status. Parser GS1 yang mengharapkan pemisah grup harus mengizinkan karakter itu dan menolak sisanya.

Panjang. Terapkan panjang yang diterima aplikasi. Minimum dan maksimum global lebih aman daripada satu panjang wajib saat formulir menerima lebih dari satu simbologi. maxlength pada masukan akan memotong muatan yang lebih panjang secara diam-diam, jadi atur hanya bila setiap kode yang diterima muat.

Awalan. Buang awalan hanya bila Anda mengonfigurasi pemindai untuk mengirim awalan yang persis itu dan aplikasi tidak menyimpannya.

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

Pengenal simbologi AIM adalah data jika pemindai diatur untuk mengirimkannya. Biarkan di tempat sampai Anda memutuskan apakah aplikasi menyimpannya.

Akhiran. Jauhkan penutup dari nilai yang disimpan. Enter dan Tab adalah tombol. Keduanya tidak disisipkan ke masukan teks biasa. Muatan serial mungkin masih berisi byte CR atau LF. Buang byte itu di batas tempat Anda mengurai aliran serial, dan uji bahwa Anda tidak membuangnya dari tengah muatan yang memang memuatnya secara sah.

Pengiriman ganda. Satu pindaian dapat ditangani dua kali jika keydown dan submit sama-sama berjalan untuk Enter yang sama. Pakai satu jalur penyelesaian. Pindaian kedua atas kode yang sama adalah pertanyaan lain. Formulir gudang dapat menambah jumlah. Formulir tiket dapat menolak kode yang sudah ditukar. Letakkan aturan itu di aplikasi, dan uji dengan sengaja. Peramban tidak dapat membedakan tarikan pelatuk kedua dari listener kedua.

Aturan aplikasi. Checksum milik simbologi tertentu. EAN-13 memakai digit terakhir sebagai digit periksa. Fungsi ini hanya menerima format itu:

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

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

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

Code 128, Code 39, dan QR tidak memakai perhitungan itu. Pemindai mungkin sudah memeriksa simbologinya sendiri dan mengirim data yang dapat dibaca manusia. Validasi format yang Anda simpan, dan ulangi pemeriksaan di server. String yang dikirim adalah masukan pengguna biasa. Peramban tidak dapat membuktikan bahwa pemindai yang menghasilkannya.

Menguji masukan pemindai kode batang tanpa perangkat keras fisik

Barcode Scanner Emulator adalah aplikasi desktop untuk Windows, macOS, dan Linux. Anda memasukkan teks yang akan dikirim, memilih tundaan ketik, dan memilih akhiran tidak ada, ENTER, atau TAB. Pintasan global mengetik teks itu ke aplikasi yang sedang fokus. Emulator mereproduksi jalur papan ketik yang dipakai pemindai baji. Emulator tidak menyinari label, tidak membaca simbol, dan tidak mendekode simbologi.

Pakai halaman contoh di atas, atau halaman yang sedang Anda bangun:

  1. Buka halaman di peramban desktop dan klik bidang kode batang.
  2. Di emulator, masukkan nilai yang diketahui seperti 123456789012.
  3. Atur akhiran ke ENTER. Atur tundaan ketik jika Anda ingin rentetan itu menyerupai pemindai yang sudah Anda ukur.
  4. Tekan pintasan pindai global emulator selagi bidang peramban masih fokus.
  5. Pastikan teks status dan bahwa nilai diterima satu kali.
  6. Ulangi dengan TAB. Fokus harus berpindah, dan nilai harus diterima satu kali.
  7. Ulangi tanpa akhiran. Teks harus tetap di bidang sampai Anda mengaktifkan Look up.
  8. Fokuskan penguji masukan kode batang dan kirim nilai yang sama lagi. Bandingkan string yang tertangkap, awalan, dan akhiran dengan yang disimpan aplikasi.

Pemasangan dan pintasan pertama dibahas di Memulai. Setelah pengaturan berubah, kirim satu pindaian ke penguji masukan sebelum Anda memercayai hasil di aplikasi.

Perangkat keras tetap diperlukan untuk bagian optik dan bagian yang khas perangkat:

  • Apakah pemindai itu dapat mendekode simbol yang dicetak atau ditampilkan, termasuk label rusak, ukuran, kontras, dan jarak.
  • Dukungan simbologi. Pemindai laser 1D tidak dapat membaca kode QR. Lihat Pengujian kode QR: cara menguji pemindai kode QR.
  • Enumerasi USB, penyandingan Bluetooth, serta konfigurasi tata letak papan ketik dan akhiran milik pemindai sendiri.
  • Integrasi serial, HID POS, dan SDK vendor.

Emulator adalah alat yang tepat untuk logika aplikasi di sepanjang jalur papan ketik. Emulator adalah alat yang salah untuk membuktikan bahwa pemindai tertentu membaca label tertentu.

Men-debug peristiwa papan ketik pemindai kode batang

Perhatikan peristiwa dalam urutan ini saat nilai yang tersimpan salah.

keydown. Menyala untuk setiap tombol, termasuk Enter dan Tab, sebelum peramban menyisipkan karakter atau memindahkan fokus. Baca penutup di sini. event.repeat bernilai true saat sebuah tombol ditahan. Pemindai baji biasanya mengirim tekanan yang terpisah untuk setiap karakter.

input. Menyala pada bidang setelah karakter yang dapat dicetak mengubah nilainya. Ini peristiwa yang tepat untuk diawasi jika Anda membutuhkan teks saat teks itu bertambah. Peristiwa ini tidak menyala untuk Enter atau Tab, karena tombol itu tidak menyisipkan karakter ke masukan teks.

change. Menyala setelah nilai dikunci, biasanya saat bidang kehilangan fokus. Pemindai yang meninggalkan fokus di bidang yang sama tidak menghasilkan change di akhir pindaian. Jangan memakai change sebagai satu-satunya sinyal selesai.

event.key dan event.code. Catat keduanya saat sebuah karakter salah. Ketidakcocokan antara tata letak pemindai dan tata letak sistem operasi mengubah event.key dan membuat event.code tetap terlihat seperti tombol yang dimaksud pemindai. Digit dari papan angka memakai Numpad1 dan kode serupa. Beberapa masker masukan memperlakukan kode itu berbeda dari Digit1. Tata letak papan ketik pemindai kode batang salah menjelaskan ketidakcocokan tata letak.

Fokus. Catat document.activeElement segera sebelum pindaian. Jika itu bukan bidang kode batang, sisa jejak sedang menjelaskan kontrol yang salah. iframe punya fokus sendiri. Pindaian ke bingkai tertanam terlihat oleh skrip di dalam bingkai itu.

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. Ambang celah dapat menganggap pengetik cepat, isi otomatis, atau emulator sebagai pemindai. Pemindai dengan tundaan antarkarakter, tautan Bluetooth, atau muatan panjang dapat terlihat seperti pengetikan. Pakai nilai yang tertangkap dan akhiran. Pakai waktu sebagai petunjuk.

Gunakan penguji peristiwa papan ketik untuk mencantumkan setiap keydown dan keyup beserta key, code, pengubah, dan stempel waktu. Pakai saat string yang sudah tersusun menyembunyikan tombol awalan atau kode papan angka. Catatan itu adalah peristiwa peramban. Itu bukan lalu lintas USB mentah.

Masalah umum di aplikasi web

Pindaian masuk ke bidang yang salah. Masukan baji mengikuti fokus. Klik bidang sasaran setelah setiap navigasi, dialog, atau pesan validasi yang memindahkan fokus. Modal tanpa bidang teks dapat menelan pindaian sebagai tombol pintasan.

Pemindai bekerja di editor teks dan tidak di peramban. Perangkat sedang mengetik. Halaman tidak menerima tombol itu. Periksa fokus, masukan yang dinonaktifkan atau hanya baca, dan listener keydown yang memanggil preventDefault() pada tombol yang dapat dicetak. Listener yang hanya menangani paste tidak pernah melihat masukan baji. Mulai dari Pemindai kode batang tidak bekerja jika tidak ada aplikasi yang menerima karakter.

Enter mengirim formulir dua kali atau berpindah halaman. Peramban mengirim formulir, dan listener Anda juga menangani Enter. Panggil preventDefault() pada salah satu jalur itu dan proses nilai sekali. Formulir banyak bidang dapat terkirim sebelum bidang berikutnya terisi saat pemindai mengirim Enter. Pakai Tab untuk alur kerja itu, atau cegah pengiriman sampai formulir lengkap.

Tab mengubah fokus. Itu adalah tombol Tab. Konfigurasikan Enter pada pemindai, atau baca nilai di keydown dan izinkan perpindahan fokus. Lihat bagian akhiran di atas.

Tata letak papan ketik salah. Digit dapat bertahan dari ketidakcocokan yang mengubah tanda baca. Pindai nilai yang diketahui yang memuat simbol yang Anda simpan, pada tata letak yang benar-benar dipakai stasiun kerja.

Pindaian yang sama membuat dua rekaman. Cari dua listener pada satu Enter sebelum mencari dua pindaian fisik. Lalu uji pindaian kedua yang disengaja dan pastikan aturan jumlah atau duplikat yang didokumentasikan aplikasi.

Nilai hilang atau terpotong. Atribut maxlength, masker masukan, atau preventDefault() pada tombol karakter dapat menjatuhkan atau memotong muatan. Bandingkan jumlah karakter di penguji masukan dengan nilai di bidang Anda. Awalan juga dapat membuat muatan yang benar terlihat terlalu panjang.

Kode QR tidak pernah muncul. Pemindai mungkin hanya 1D, atau simbologi QR mungkin dimatikan. Aplikasi tidak dapat memperbaiki itu. Konfirmasikan perangkat keras dengan Pengujian kode QR: cara menguji pemindai kode QR, lalu kembali ke uji bidang.

Daftar periksa pengujian aplikasi web

Pakai daftar ini pada build yang akan Anda rilis, di setiap peramban yang Anda dukung. Periksa profil baru sekaligus profil dengan ekstensi pengelola kata sandi dan isi otomatis, karena ekstensi itu memindahkan fokus.

  • Pemindai terhubung atau terpasangkan, dan host menunjukkannya siap.
  • Pemindai berada dalam mode baji papan ketik, bukan serial atau mode SDK vendor.
  • Bidang kode batang fokus segera sebelum pindaian. document.activeElement adalah bidang itu.
  • Kode batang yang diketahui tiba karakter demi karakter, termasuk panjangnya.
  • Akhiran ENTER mengirim atau menerima nilai sekali dan tidak meninggalkan penutup di string yang disimpan.
  • Akhiran TAB memindahkan fokus ke kontrol berikutnya yang Anda maksud, dan nilai dibaca sebelum perpindahan.
  • Konfigurasi tanpa akhiran membiarkan nilai tersedia sampai aplikasi menyelesaikannya.
  • Pengiriman kosong ditolak atau diabaikan.
  • Satu pindaian tidak membuat dua rekaman. Pindaian nyata kedua mengikuti aturan duplikat aplikasi.
  • Tanda baca, simbol, dan pemisah GS1 apa pun yang dipakai format Anda bertahan dalam perjalanan pulang pergi.
  • Tata letak papan ketik pemindai dan tata letak sistem operasi menghasilkan karakter yang tercetak pada label.
  • Setelah dicabut dan disambungkan lagi, atau setelah tautan Bluetooth putus, pindaian berikutnya tetap sampai ke bidang.
  • Beberapa pindaian berurutan tetap menjadi nilai yang terpisah. Bidang tidak menggabungkannya.
  • Pemeriksaan yang sama lulus di peramban yang Anda dukung, dengan dan tanpa ekstensi isi otomatis yang umum.

Untuk dialog, urutan tab di seluruh kasir, dan alur jumlah POS, lanjutkan dengan Cara menguji masukan pemindai kode batang.

Matriks kasus uji

Kolom pemindai adalah apa yang dilakukan perangkat dan peramban. Kolom perilaku yang diharapkan adalah apa yang harus dilakukan aplikasi sebagai tanggapan. Aturan bisnis, seperti apakah kode produk yang berulang menambah jumlah, milik aplikasi. Nyatakan di dalam pengujian, jangan menganggap satu aturan untuk setiap produk.

Skenario Perilaku yang diharapkan
Kode batang valid Aplikasi menerima nilai dan menyimpan muatan tanpa penutup.
Masukan kosong Aplikasi menolak atau mengabaikannya dan tidak membuat rekaman.
Akhiran ENTER Aplikasi mengirim atau menerima nilai sekali.
Akhiran TAB Fokus berpindah ke kontrol berikutnya yang dimaksud, dan nilai dipertahankan.
Tanpa akhiran Masukan tetap tersedia sampai aplikasi memprosesnya.
Pindaian beruntun yang cepat Setiap nilai diproses terpisah dan tidak digabung dengan nilai sebelumnya.
Tata letak papan ketik yang salah Karakter yang tidak terduga terlihat di nilai yang tertangkap dan gagal validasi.
Pindaian duplikat Aplikasi mengikuti aturan duplikatnya sendiri, seperti menambah jumlah atau menolak pemutaran ulang.
Format kode batang tidak valid Aplikasi menampilkan kesalahan validasi untuk format itu dan tidak menyimpan nilai.
Fokus masukan hilang Aplikasi tidak mengarang kode batang. Pindaian tidak ada atau jatuh di kontrol yang fokus, dan halaman tetap dalam keadaan aman.

Jalankan baris valid, kosong, ENTER, TAB, dan tanpa akhiran dengan pemindai fisik, lalu ulangi dengan emulator. Jalankan baris tata letak papan ketik, QR, dan sambung ulang pada perangkat keras. Baris itu bergantung pada perangkat, label, atau tata letak sistem operasi, yang tidak direproduksi oleh ketukan yang disimulasikan.