Barcode Scanner Emulator
Cara Menguji Pengimbas Kod Bar dalam Aplikasi Web
Banyak pengimbas kod bar USB dan Bluetooth menghantar data yang dinyahkod sebagai input papan kekunci, jadi medan yang difokus dalam aplikasi web boleh menerima imbasan tanpa API pelayar khusus pengimbas. Port siri dan SDK vendor ialah integrasi yang berasingan. Laluan papan kekunci boleh diuji dengan pengimbas fizikal atau dengan ketukan kekunci yang disimulasikan.
Aplikasi web biasanya melihat pengimbas kod bar sebagai papan kekunci. Ujiannya ialah sama ada kawalan yang difokus menerima muatan yang diharapkan oleh aplikasi, dan sama ada halaman mengendalikan penamat yang dikonfigurasi pada pengimbas. Penamat itu mungkin Enter, Tab, atau tiada langsung.
Gunakan sesi Penguji Input Kod Bar apabila pengimbas fizikal dipasang. Gunakan Barcode Scanner Emulator apabila laluan papan kekunci yang sama diperlukan semasa pembangunan dan perkakasan tiada di meja. Semakan yang lebih luas tentang fokus, susun atur dan aliran kerja POS ada dalam Cara Menguji Input Pengimbas Kod Bar. Panduan ini kekal pada aplikasi pelayar: tangkapan, akhiran, pengesahan, dan peristiwa yang benar-benar boleh diperhatikan.
Bagaimanakah Pengimbas Kod Bar Berkomunikasi dengan Aplikasi Web
Mod antara muka menentukan apa yang boleh diterima oleh halaman. Sahkan mod itu sebelum mengubah kod borang. Pengimbas sering boleh menukar mod dengan mengimbas kod bar konfigurasi daripada manual pengeluar.
Baji papan kekunci USB HID
Dalam mod papan kekunci USB HID, pengimbas dibilang sebagai papan kekunci. Sistem pengendalian memuatkan pemacu papan kekunci biasa. Selepas pengimbas menyahkod simbol, ia menghantar aksara sebagai ketukan kekunci kepada kawalan yang memegang fokus papan kekunci. Halaman mendengar ketukan itu, atau membaca teks yang dimasukkan. Halaman tidak membuka sambungan ke peranti.
Laluan itulah sebab medan daftar keluar, kotak carian, atau input teks lain boleh menerima imbasan dengan HTML biasa. Panduan Baji Papan Kekunci HID menerangkan urutan ketukan, awalan dan akhiran dengan lebih terperinci.
Bluetooth HID
Pengimbas Bluetooth yang dipasangkan sebagai papan kekunci menggunakan laluan aplikasi yang sama. Hos menganggapnya sebagai papan kekunci HID, dan medan yang difokus menerima ketukan. Pemasangan, bateri dan radio ialah hal peranti. Sebaik sahaja aksara sampai ke pelayar, halaman mengendalikannya dengan cara yang sama seperti input baji USB.
Siri dan port COM maya
Pengimbas siri, termasuk banyak mod port COM maya USB, menghantar teks yang dinyahkod sebagai bait pada satu port. Fokus tidak memilih destinasi. Proses yang membuka port yang memilihnya. Medan teks yang hanya mendengar ketukan tidak akan melihat aliran itu.
Pelayar berasaskan Chromium boleh membuka port siri melalui Web Serial API selepas pengguna memilih port dan memberi kebenaran. Firefox dan Safari tidak menyediakan API itu. Ujian baji tidak menguji integrasi siri, dan ujian siri tidak memberitahu apa yang akan ditaip oleh pengimbas baji.
Antara muka khusus vendor
Sesetengah peranti menggunakan SDK vendor, OPOS, JPOS, atau antara muka HID bukan papan kekunci seperti USB HID POS. Antara muka itu tidak menaip ke dalam medan yang difokus. Halaman web biasa tidak dapat memuatkan SDK natif. Chromium boleh meminta sesetengah peranti HID bukan papan kekunci melalui WebHID selepas gerak isyarat pengguna. Peranti HID kelas papan kekunci kekal disekat, jadi pengimbas baji tidak dapat dibezakan daripada papan kekunci. Anggap antara muka vendor sebagai integrasi tersendiri dan uji dengan perisian yang benar-benar membuka antara muka itu.
Apa yang boleh dilihat oleh pelayar
Imbasan baji tiba sebagai peristiwa keydown dan keyup, dan aksara yang boleh dicetak mengemas kini medan yang difokus. Pelayar tidak menerima nama peranti, nombor siri USB, atau bendera yang menyatakan bahawa ini pengimbas. Pelayar yang melaksanakan WebHID tetap menolak antara muka papan kekunci, jadi skrip halaman juga tidak dapat membaca laporan HID mentah pengimbas baji.
event.key ialah aksara atau nama kekunci selepas sistem pengendalian menggunakan susun atur papan kekunci yang aktif. event.code menamakan kekunci fizikal, seperti Digit1 atau Numpad1, dan boleh kekal sama apabila ketidakpadanan susun atur mengubah event.key. Kedua-dua sifat itu tidak mengenal pasti perkakasan.
Cara Menguji Pengimbas Kod Bar Fizikal dalam Pelayar
Jalankan ini sebelum menyahpepijat kod aplikasi. Ia menunjukkan rentetan dan penamat tepat yang diterima oleh pelayar.
- Sambungkan pengimbas dan tunggu sehingga ia menunjukkan kuasa telah masuk. Untuk Bluetooth, selesaikan pemasangan dan sahkan hos menggunakan profil papan kekunci.
- Sahkan mod input. Baji papan kekunci, papan kekunci USB HID, atau papan kekunci Bluetooth HID boleh menaip ke dalam medan. Mod siri, SPP dan SDK vendor tidak boleh.
- Buka Penguji Input Kod Bar.
- Klik Mula Ujian, atau klik kawasan imbasan. Kawasan itu bertukar biru apabila sedia. Halaman tidak mengambil fokus sendiri.
- Imbas kod bar yang muatannya sudah diketahui. Mulakan dengan nilai angka yang pendek, kemudian imbas nilai yang mengandungi tanda baca yang disimpan oleh aplikasi.
- Baca nilai yang ditangkap dan bilangan aksara. Bandingkan kedua-duanya dengan muatan yang diharapkan, termasuk sebarang awalan yang dimasukkan pengimbas sebelum data.
- Semak akhiran. Penguji melaporkan ENTER, TAB atau Tiada. Apabila Tangkap automatik dihidupkan, hasil muncul selepas Enter, Tab, atau jeda singkat sebaik sahaja kekunci berhenti. Matikan Tangkap automatik apabila tangkapan hendak ditahan sehingga anda menekan Henti.
- Bandingkan hasil itu dengan rentetan yang patut disimpan oleh aplikasi. Awalan, aksara yang diganti, atau penamat yang hilang perlu dibetulkan dalam konfigurasi pengimbas atau dikendalikan dengan sengaja pada halaman. Jangan anggap ia kegagalan penyahkodan sehingga perbandingan ini selesai.
Penguji merekod peristiwa papan kekunci yang boleh dilihat oleh pelayar. Ia tidak dapat mengenal pasti peranti USB atau membaca port siri. Apabila editor teks menerima imbasan dan pelayar tidak, teruskan dengan Pengimbas Berfungsi dalam Notepad tetapi Tidak dalam POS.
Tangkap Input Pengimbas Kod Bar dengan JavaScript
Pengimbas menaip ke dalam elemen yang mempunyai fokus. Beri medan label yang kelihatan, biarkan ia sebagai input teks biasa supaya pengguna papan kekunci boleh menaip kod, dan baca nilai apabila aliran kerja menyatakan entri selesai. Halaman di bawah melakukan perkara itu. Enter menghantar borang sekali. Tab melengkapkan nilai yang tidak kosong, kemudian membiarkan pelayar mengalih fokus. Imbasan tanpa penamat kekal dalam medan sehingga 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 fail itu dan buka dalam pelayar desktop. Klik medan jika fokus telah beralih. Pengimbas baji, atau emulator dalam bahagian seterusnya, kemudian menaip ke dalam #barcode.
Fokus diperlukan. Jika document.activeElement ialah badan dokumen, satu butang, atau input lain, pendengar medan ini tidak melihat imbasan. Aksara masuk ke kawalan yang difokus, atau hilang. Panggil field.focus() apabila aliran kerja sedia menerima imbasan, termasuk selepas dialog ditutup.
Input kosong diabaikan. Borang kekal di tempatnya, dan teks status menyatakan bahawa tiada apa-apa diterima. Ruang putih sahaja menjadi kosong selepas trim().
Contoh ini tidak menambah Enter atau Tab. Jika pengimbas tidak dikonfigurasi untuk menghantarnya, nilai kekal dalam medan dan Look up ialah laluan penyiapan. autocomplete="off" mengurangkan kemungkinan nilai yang disimpan menggantikan imbasan. Label, butang dan Shift+Tab kekal tersedia, jadi seseorang boleh memasukkan kod tanpa pengimbas.
Kendalikan Enter di satu tempat. Contoh ini menggunakan peristiwa submit borang, yang turut meliputi butang Look up dan Enter papan kekunci. Pendengar keydown kedua untuk Enter akan merekod imbasan yang sama dua kali. Jika input tidak berada dalam borang, dengar Enter pada keydown dan panggil preventDefault() supaya borang leluhur tidak turut dihantar:
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 medan selepas penerimaan berjaya supaya imbasan seterusnya tidak ditambah pada muatan sebelumnya. Selepas Enter, contoh memfokus medan yang sama semula kerana aliran kerja itu menjangka imbasan seterusnya dalam kotak yang sama. Selepas Tab, fokus dibiarkan supaya pelayar boleh beralih ke kawalan seterusnya.
Mengendalikan Akhiran ENTER dan TAB
Akhiran ialah kekunci yang mungkin dihantar pengimbas selepas muatan. Ia tetapan peranti. Enter biasa, dan ia pilihan. Panduan Akhiran ENTER dan TAB pada Pengimbas Kod Bar menerangkan cara membezakan penamat. Sahkan tetapan pada pengimbas yang sedang diuji, kemudian padankan halaman dengan aliran kerja itu.
ENTER
Enter di dalam medan teks satu baris menghantar borang yang melingkupinya pada pelayar semasa. Gunakannya apabila satu imbasan patut mengesahkan nilai, seperti kotak carian. preventDefault() pada peristiwa submit menghalang pelayar daripada berpindah halaman. Tinggalkan panggilan itu apabila navigasi halaman penuh ialah kelakuan yang dikehendaki.
Jika kod bar muncul dan borang tidak melakukan apa-apa, pengimbas mungkin tidak menghantar akhiran. Pengimbas Kod Bar Tiada ENTER menelusuri konfigurasi itu. Sesetengah peranti menghantar NumPad Enter. event.key masih "Enter". Semak event.key, bukan hanya event.code === "Enter", atau pengimbas itu akan kelihatan rosak.
TAB
Tab mengalih fokus ke kawalan boleh fokus yang seterusnya. Ia sesuai untuk urutan seperti kod produk, kemudian kuantiti. Ia mengejutkan borang yang menjangka Enter untuk menghantar.
Baca nilai dalam keydown semasa medan masih difokus. Pelayar mengalih fokus selepas peristiwa itu. Biarkan tindakan lalai apabila kawalan seterusnya patut menerima fokus. preventDefault() mengekalkan fokus di tempatnya, berguna apabila nilai tidak sah dan operator perlu melihatnya. Abaikan Shift+Tab supaya pengguna papan kekunci boleh bergerak ke belakang melalui borang. Akhiran Tab pengimbas ialah Tab tanpa Shift.
Akhiran Tab juga boleh mengalih fokus sebelum kod anda membaca medan, jika pendengar berada pada blur atau change dan sesuatu yang lain mengosongkan kawalan. Baca nilai daripada target peristiwa keydown.
Tiada akhiran
Tanpa akhiran, muatan duduk dalam medan. Aplikasi perlu memutuskan bila imbasan selesai. Butang yang jelas, Enter kemudian daripada operator, atau perpindahan ke langkah lain ialah titik penyiapan yang boleh dipercayai. Pemasa tidak aktif boleh menganggap jeda menaip sebagai penghujung imbasan. Pemasa itu ialah heuristik. Pengimbas yang perlahan, lengah Bluetooth, atau orang yang menaip dengan pantas boleh jatuh di sebelah ambang yang salah. Utamakan akhiran yang dikonfigurasi apabila aliran kerja memerlukan isyarat tamat imbasan yang tegas.
Perbezaan konfigurasi
Pengimbas jenama yang sama boleh dihantar dengan akhiran yang berbeza, dan kod bar konfigurasi boleh menukar akhiran tanpa sebarang perubahan pada JavaScript anda. Sesetengah peranti menghantar awalan, pengecam simbologi seperti ]C1, atau CR dan LF. Uji tiga tetapan penamat yang pengguna benar-benar boleh pilih: Enter, Tab dan tiada. Rekod yang mana digunakan oleh pengimbas yang telah digunakan, dan uji halaman terhadap tetapan itu.
Pengesahan Input Pengimbas Kod Bar
Sahkan rentetan yang diterima oleh medan. Jangan anggap setiap kod bar mempunyai panjang, set aksara atau hasil tambah semak yang sama. Muatan Code 128 dan QR berubah-ubah. EAN-13 ialah 13 digit. Aplikasi yang menyimpan kedua-duanya memerlukan peraturan untuk kedua-duanya.
Input kosong. Tolak atau abaikan. Akhiran tanpa muatan, atau klik Look up pada medan kosong, tidak patut mencipta rekod.
Aksara yang tidak dijangka. Bandingkan rentetan yang diterima dengan label yang diketahui. Ketidakpadanan susun atur sering kelihatan sebagai simbol yang berubah, seperti digit atau tanda baca yang beralih, manakala panjang kekal sama. Aksara kawalan boleh datang daripada awalan atau daripada pemisah kumpulan GS1. Benarkan aksara yang ditakrifkan oleh format anda. Contoh di atas menolak aksara kawalan ASCII supaya ia kekal kelihatan dalam teks status. Penghurai GS1 yang menjangka pemisah kumpulan patut membenarkan aksara itu dan menolak yang lain.
Panjang. Kuatkuasakan panjang yang diterima oleh aplikasi. Minimum dan maksimum global lebih selamat daripada satu panjang wajib apabila borang menerima lebih daripada satu simbologi. maxlength pada input akan memotong muatan yang lebih panjang secara senyap, jadi tetapkan hanya apabila setiap kod yang diterima muat.
Awalan. Buang awalan hanya apabila anda mengkonfigurasi pengimbas untuk menghantar awalan yang tepat itu dan aplikasi tidak menyimpannya.
function withoutConfiguredPrefix(value, prefix) {
if (prefix && value.startsWith(prefix)) {
return value.slice(prefix.length)
}
return value
}
Pengecam simbologi AIM ialah data jika pengimbas ditetapkan untuk menghantarnya. Biarkan di tempatnya sehingga anda memutuskan sama ada aplikasi menyimpannya.
Akhiran. Jauhkan penamat daripada nilai yang disimpan. Enter dan Tab ialah kekunci. Ia tidak dimasukkan ke dalam input teks biasa. Muatan siri mungkin masih mengandungi bait CR atau LF. Buang bait itu di sempadan tempat anda menghuraikan aliran siri, dan uji bahawa anda tidak membuangnya dari tengah muatan yang sah mengandungi bait itu.
Penyerahan pendua. Satu imbasan boleh dikendalikan dua kali jika kedua-dua keydown dan submit berjalan untuk Enter yang sama. Gunakan satu laluan penyiapan. Imbasan kedua kod yang sama ialah soalan yang berbeza. Borang gudang mungkin menambah kuantiti. Borang tiket mungkin menolak kod yang sudah ditebus. Letakkan peraturan itu dalam aplikasi, dan uji dengan sengaja. Pelayar tidak dapat membezakan tarikan picu kedua daripada pendengar kedua.
Peraturan aplikasi. Hasil tambah semak milik simbologi tertentu. EAN-13 menggunakan digit terakhir sebagai digit semak. 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 menggunakan pengiraan itu. Pengimbas mungkin sudah menyemak simbologinya sendiri dan menghantar data yang boleh dibaca manusia. Sahkan format yang anda simpan, dan ulangi semakan pada pelayan. Rentetan yang dihantar ialah input pengguna biasa. Pelayar tidak dapat membuktikan bahawa pengimbas yang menghasilkannya.
Menguji Input Pengimbas Kod Bar tanpa Perkakasan Fizikal
Barcode Scanner Emulator ialah aplikasi desktop untuk Windows, macOS dan Linux. Anda memasukkan teks yang hendak dihantar, memilih lengah menaip, dan memilih akhiran tiada, ENTER atau TAB. Pintasan global menaip teks itu ke dalam aplikasi yang difokus. Ia menghasilkan semula laluan papan kekunci yang digunakan oleh pengimbas baji. Ia tidak menyinari label, tidak membaca simbol dan tidak menyahkod simbologi.
Gunakan halaman contoh di atas, atau halaman yang sedang dibina:
- Buka halaman dalam pelayar desktop dan klik medan kod bar.
- Dalam emulator, masukkan nilai yang diketahui seperti
123456789012. - Tetapkan akhiran kepada ENTER. Tetapkan lengah menaip jika letusan itu hendak menyerupai pengimbas yang sudah diukur.
- Tekan pintasan imbasan global emulator semasa medan pelayar masih difokus.
- Sahkan teks status dan bahawa nilai diterima sekali.
- Ulang dengan TAB. Fokus patut beralih, dan nilai patut diterima sekali.
- Ulang tanpa akhiran. Teks patut kekal dalam medan sehingga anda mengaktifkan Look up.
- Fokuskan Penguji Input Kod Bar dan hantar nilai yang sama sekali lagi. Bandingkan rentetan yang ditangkap, awalan dan akhiran dengan apa yang disimpan oleh aplikasi.
Pemasangan dan pintasan pertama dibincangkan dalam Bermula. Selepas perubahan tetapan, hantar satu imbasan ke penguji input sebelum mempercayai hasil dalam aplikasi.
Perkakasan masih diperlukan untuk bahagian optik dan bahagian khusus peranti dalam ujian:
- Sama ada pengimbas itu boleh menyahkod simbol yang dicetak atau dipaparkan, termasuk label rosak, saiz, kontras dan jarak.
- Sokongan simbologi. Pengimbas laser 1D tidak dapat membaca kod QR. Lihat Ujian Kod QR: Cara Menguji Pengimbas Kod QR.
- Penghitungan USB, pemasangan Bluetooth, serta konfigurasi susun atur papan kekunci dan akhiran pengimbas itu sendiri.
- Integrasi siri, HID POS dan SDK vendor.
Emulator ialah alat yang betul untuk logik aplikasi di sepanjang laluan papan kekunci. Ia alat yang salah untuk membuktikan bahawa pengimbas tertentu membaca label tertentu.
Menyahpepijat Peristiwa Papan Kekunci Pengimbas Kod Bar
Perhatikan peristiwa dalam urutan ini apabila nilai yang disimpan salah.
keydown. Berlaku untuk setiap kekunci, termasuk Enter dan Tab, sebelum pelayar memasukkan aksara atau mengalih fokus. Baca penamat di sini. event.repeat benar apabila kekunci ditekan dan ditahan. Pengimbas baji biasanya menghantar tekan yang berasingan untuk setiap aksara.
input. Berlaku pada medan selepas aksara yang boleh dicetak mengubah nilainya. Ia peristiwa yang betul untuk diperhatikan jika teks diperlukan semasa ia membesar. Ia tidak berlaku untuk Enter atau Tab, kerana kekunci itu tidak memasukkan aksara ke dalam input teks.
change. Berlaku selepas nilai disahkan, biasanya apabila medan kehilangan fokus. Pengimbas yang meninggalkan fokus pada medan yang sama tidak menghasilkan change pada penghujung imbasan. Jangan gunakan change sebagai satu-satunya isyarat selesai.
event.key dan event.code. Catat kedua-duanya apabila aksara salah. Ketidakpadanan antara susun atur pengimbas dan susun atur sistem pengendalian mengubah event.key dan membiarkan event.code kelihatan seperti kekunci yang dimaksudkan oleh pengimbas. Digit daripada pad nombor menggunakan Numpad1 dan kod yang serupa. Sesetengah topeng input menganggap kod itu berbeza daripada Digit1. Susun Atur Papan Kekunci Pengimbas Kod Bar Salah menerangkan ketidakpadanan susun atur.
Fokus. Catat document.activeElement sejurus sebelum imbasan. Jika ia bukan medan kod bar, jejak yang selebihnya menerangkan kawalan yang salah. iframe mempunyai fokus sendiri. Imbasan ke dalam bingkai terbenam kelihatan kepada skrip di dalam bingkai itu.
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. Ambang jurang boleh menganggap penekan pantas, isian automatik atau emulator sebagai pengimbas. Pengimbas dengan lengah antara aksara, pautan Bluetooth atau muatan panjang boleh kelihatan seperti menaip. Gunakan nilai yang ditangkap dan akhiran. Gunakan pemasa sebagai petunjuk.
Penguji Peristiwa Papan Kekunci menyenaraikan setiap keydown dan keyup bersama key, code, pengubah dan cap masa. Gunakannya apabila rentetan yang telah dipasang menyembunyikan kekunci awalan atau kod pad nombor. Log itu ialah peristiwa pelayar. Ia bukan trafik USB mentah.
Masalah Lazim dalam Aplikasi Web
Imbasan masuk ke medan yang salah. Input baji mengikut fokus. Klik medan sasaran selepas setiap navigasi, dialog atau mesej pengesahan yang mengalih fokus. Modal tanpa medan teks boleh menelan imbasan sebagai kekunci pintasan.
Pengimbas berfungsi dalam editor teks tetapi tidak dalam pelayar. Peranti sedang menaip. Halaman tidak menerima kekunci itu. Semak fokus, input yang dilumpuhkan atau baca sahaja, dan pendengar keydown yang memanggil preventDefault() pada kekunci yang boleh dicetak. Pendengar yang hanya mengendalikan paste tidak pernah melihat input baji. Mulakan dengan Pengimbas Kod Bar Tidak Berfungsi jika tiada aplikasi menerima aksara.
Enter menghantar borang dua kali atau berpindah halaman. Pelayar menghantar borang, dan pendengar anda juga mengendalikan Enter. Panggil preventDefault() pada salah satu laluan itu dan proses nilai sekali. Borang berbilang medan boleh dihantar sebelum medan kemudian diisi apabila pengimbas menghantar Enter. Gunakan Tab untuk aliran kerja itu, atau halang penghantaran sehingga borang lengkap.
Tab mengubah fokus. Itu ialah kekunci Tab. Konfigurasikan Enter pada pengimbas, atau baca nilai dalam keydown dan benarkan perpindahan fokus. Lihat bahagian akhiran di atas.
Susun atur papan kekunci salah. Digit mungkin kekal selepas ketidakpadanan yang mengubah tanda baca. Imbas nilai yang diketahui yang mengandungi simbol yang anda simpan, pada susun atur yang sebenarnya digunakan oleh stesen kerja.
Imbasan yang sama mencipta dua rekod. Cari dua pendengar pada satu Enter sebelum mencari dua imbasan fizikal. Kemudian uji imbasan kedua yang disengajakan dan sahkan peraturan kuantiti atau pendua yang didokumenkan oleh aplikasi.
Nilai hilang atau terpotong. Atribut maxlength, topeng input, atau preventDefault() pada kekunci aksara boleh menggugurkan atau memotong muatan. Bandingkan bilangan aksara dalam penguji input dengan nilai dalam medan anda. Awalan juga boleh membuat muatan yang betul kelihatan terlalu panjang.
Kod QR tidak pernah muncul. Pengimbas mungkin 1D sahaja, atau simbologi QR mungkin dimatikan. Aplikasi tidak dapat membetulkannya. Sahkan perkakasan dengan Ujian Kod QR: Cara Menguji Pengimbas Kod QR, kemudian kembali ke ujian medan.
Senarai Semak Ujian Aplikasi Web
Gunakan senarai ini pada binaan yang hendak dikeluarkan, dalam setiap pelayar yang disokong. Semak profil baharu serta profil dengan sambungan pengurus kata laluan dan isian automatik, kerana sambungan itu mengalih fokus.
- Pengimbas disambungkan atau dipasangkan, dan hos menunjukkannya sedia.
- Pengimbas berada dalam mod baji papan kekunci, bukan siri atau mod SDK vendor.
- Medan kod bar difokus sejurus sebelum imbasan.
document.activeElementialah medan itu. - Kod bar yang diketahui tiba aksara demi aksara, termasuk panjang.
- Akhiran ENTER menghantar atau menerima nilai sekali dan tidak meninggalkan penamat dalam rentetan yang disimpan.
- Akhiran TAB mengalih fokus ke kawalan seterusnya yang dimaksudkan, dan nilai dibaca sebelum perpindahan.
- Konfigurasi tanpa akhiran membiarkan nilai tersedia sehingga aplikasi menyiapkannya.
- Penyerahan kosong ditolak atau diabaikan.
- Satu imbasan tidak mencipta dua rekod. Imbasan sebenar kedua mengikut peraturan pendua aplikasi.
- Tanda baca, simbol dan sebarang pemisah GS1 yang digunakan oleh format anda kekal selepas perjalanan pergi balik.
- Susun atur papan kekunci pengimbas dan susun atur sistem pengendalian menghasilkan aksara yang dicetak pada label.
- Selepas dicabut dan disambung semula, atau selepas pautan Bluetooth terputus, imbasan seterusnya masih sampai ke medan.
- Beberapa imbasan berturut-turut kekal sebagai nilai yang berasingan. Medan tidak menggabungkannya.
- Semakan yang sama lulus dalam pelayar yang disokong, dengan dan tanpa sambungan isian automatik yang biasa.
Untuk dialog, tertib tab merentas keseluruhan daftar keluar, dan aliran kuantiti POS, teruskan dengan Cara Menguji Input Pengimbas Kod Bar.
Matriks Kes Ujian
Lajur pengimbas ialah apa yang dilakukan oleh peranti dan pelayar. Lajur kelakuan dijangka ialah apa yang patut dilakukan oleh aplikasi sebagai respons. Peraturan perniagaan, seperti sama ada kod produk yang berulang menambah kuantiti, milik aplikasi. Nyatakan dalam ujian, jangan anggap satu peraturan untuk setiap produk.
| Senario | Kelakuan dijangka |
|---|---|
| Kod bar sah | Aplikasi menerima nilai dan menyimpan muatan tanpa penamat. |
| Input kosong | Aplikasi menolak atau mengabaikannya dan tidak mencipta rekod. |
| Akhiran ENTER | Aplikasi menghantar atau menerima nilai sekali. |
| Akhiran TAB | Fokus beralih ke kawalan seterusnya yang dimaksudkan, dan nilai dikekalkan. |
| Tiada akhiran | Input kekal tersedia sehingga aplikasi memprosesnya. |
| Imbasan berturutan yang pantas | Setiap nilai diproses secara berasingan dan tidak digabungkan dengan nilai sebelumnya. |
| Susun atur papan kekunci yang salah | Aksara yang tidak dijangka kelihatan dalam nilai yang ditangkap dan gagal pengesahan. |
| Imbasan pendua | Aplikasi mengikut peraturan penduanya sendiri, seperti menambah kuantiti atau menolak main semula. |
| Format kod bar tidak sah | Aplikasi menunjukkan ralat pengesahan untuk format itu dan tidak menyimpan nilai. |
| Fokus input hilang | Aplikasi tidak mereka-reka kod bar. Imbasan tiada atau jatuh pada kawalan yang difokus, dan halaman kekal dalam keadaan selamat. |
Jalankan baris sah, kosong, ENTER, TAB dan tiada akhiran dengan pengimbas fizikal, kemudian ulangi dengan emulator. Jalankan baris susun atur papan kekunci, QR dan sambung semula pada perkakasan. Baris itu bergantung pada peranti, label atau susun atur sistem pengendalian, yang tidak dihasilkan semula oleh ketukan yang disimulasikan.