Gumagana ang scanner sa Notepad pero hindi sa POS

Problema

Ang pag-scan sa isang plain text editor ay nagbubunga ng tamang halaga sa bawat pagkakataon, ngunit ang pag-scan sa iyong POS system, web app, o internal tool ay walang nagagawa, bahagyang input, o maling kilos.

Mga posibleng sanhi

• Walang keyboard focus ang target na field sa oras ng scan, o ang focus ay nasa elementong hindi input
• Ang isang handler ng keydown ay tumatawag ng preventDefault() sa paraang humaharang sa pagpasok ng karakter
• Umaasa ang app sa mga event na paste o input na hindi natural na nati-trigger ng mga keystroke ng scanner sa paraang inaasahan mo
• Tinatanggihan ng input mask o validation regex ang isang wastong karakter sa na-scan na payload
• Ang hulaping ENTER/TAB ay nagti-trigger ng hindi sinasadyang aksyon (maagang pagsusumite ng form, pagsasara ng modal, pag-navigate palayo)
• Mas mabilis ang scan kaysa sa kayang irehistro ng debounced o throttled na input handler ang bawat keystroke

Workflow ng pagsusuri

1. Buksan ang Tester ng keyboard event sa parehong browser at i-scan ang barcode. Kung tama ang pag-log ng bawat karakter dito, maayos na natatanggap ng browser at OS ang mga event, kaya nasa paghawak ng event ng iyong app ang bug.
2. Suriin kung naka-focus ang iyong input field bago mismo mangyari ang scan sa totoong workflow (hindi lang kapag mano-mano mo itong kiniklik para sa pagsubok).
3. Buksan ang console ng DevTools ng iyong browser at hanapin ang mga JavaScript error na itinapon habang nag-i-scan — ang error na itinapon sa gitna ng handler ay maaaring tahimik na magpahinto sa pagproseso ng susunod na mga keystroke.
4. Pansamantalang alisin ang anumang input mask, validation, o debounce logic at subukan muli upang ihiwalay kung aling layer ang nagbabagsak ng input.
5. Suriin kung nakikinig ang iyong app sa keypress (deprecated at hindi maaasahan para sa ilang key) sa halip na keydown/keyup.

Paano ayusin

• Tiyakin na programmatically na naka-focus ang target na field tuwing inaasahan ng workflow ang isang scan (halimbawa, kaagad pagkatapos magdagdag ng line item)
• Palitan ang mga listener ng keypress ng keydown/keyup, dahil deprecated ang keypress at hindi pare-pareho ang paghawak nito sa ilang key
• Suriin ang anumang tawag sa preventDefault() sa mga keyboard handler upang matiyak na hindi hinaharangan ng mga ito ang lehitimong character key
• Luwagan ang mga input mask at validation upang tanggapin ang buong hanay ng karakter na kayang likhain ng iyong mga barcode symbology, pagkatapos ay i-validate ang binuong halaga sa halip na ang indibidwal na keystroke
• Itugma ang suffix ng scanner sa inaasahan ng iyong form (tingnan ang Mga hulaping ENTER laban sa TAB)

Mga kaugnay na tool

Tester ng keyboard event · Tester ng barcode input