Barcode Scanner Emulator
איך לבדוק סורקי ברקוד ביישומי אינטרנט
סורקי USB ו-Bluetooth רבים שולחים נתונים מפוענחים כקלט מקלדת, כך ששדה ממוקד ביישום אינטרנט יכול לקבל סריקה בלי API ייעודי לסורק בדפדפן. יציאות טוריות ו-SDK של יצרן הם חיבורים נפרדים. אפשר לבדוק את נתיב המקלדת עם סורק פיזי או עם הקשות מדומות.
יישום אינטרנט רואה בדרך כלל סורק ברקוד כמקלדת. הבדיקה היא אם הפקד הממוקד מקבל את המטען שהיישום מצפה לו, ואם העמוד מטפל במסיים שהסורק מוגדר לשלוח. המסיים הזה יכול להיות Enter, Tab, או בלי מסיים.
השתמשו במפגש של בודק קלט ברקוד כשסורק פיזי מחובר. השתמשו ב-Barcode Scanner Emulator כשצריך את אותו נתיב מקלדת בזמן פיתוח והחומרה לא על השולחן. מעבר רחב יותר על מיקוד, פריסה ותהליכי POS נמצא באיך לבדוק קלט של סורק ברקוד. המדריך הזה נשאר ביישום הדפדפן: לכידה, סיומות, אימות, והאירועים שאפשר באמת לראות.
איך סורקי ברקוד מתקשרים עם יישומי אינטרנט
מצב הממשק קובע מה העמוד יכול לקבל. אשרו אותו לפני שמשנים קוד טופס. סורק יכול לעתים קרובות להחליף מצבים בסריקת ברקוד הגדרה ממדריך היצרן.
טריז מקלדת USB HID
במצב מקלדת USB HID הסורק מופיע כמקלדת. מערכת ההפעלה טוענת את מנהל ההתקן הרגיל של המקלדת. אחרי שהסורק מפענח סמל, הוא שולח את התווים כהקשות לפקד שיש לו מיקוד מקלדת. העמוד מאזין להקשות האלה, או קורא את הטקסט שהן מכניסות. הוא לא פותח חיבור למכשיר.
זה הנתיב שבגללו שדה קופה, תיבת חיפוש או כל קלט טקסט אחר יכול לקבל סריקה עם HTML רגיל. המדריך טריז מקלדת HID מוסבר מכסה את רצף ההקשות, הקידומות והסיומות בפירוט רב יותר.
Bluetooth HID
סורק Bluetooth שמשויך כמקלדת משתמש באותו נתיב יישום. המארח מתייחס אליו כמקלדת HID, והשדה הממוקד מקבל הקשות. שיוך, סוללה והרדיו הם ענייני המכשיר. ברגע שהתווים מגיעים לדפדפן, העמוד מטפל בהם באותו אופן שבו הוא מטפל בקלט טריז USB.
יציאה טורית ויציאת COM וירטואלית
סורק טורי, כולל מצבי יציאת COM וירטואלית רבים ב-USB, שולח את הטקסט המפוענח כבתים על יציאה. המיקוד לא בוחר את היעד. התהליך שפותח את היציאה בוחר. שדה טקסט שמאזין רק להקשות לא יראה את הזרם הזה.
דפדפנים מבוססי Chromium יכולים לפתוח יציאה טורית דרך Web Serial API אחרי שהמשתמש בוחר את היציאה ונותן הרשאה. Firefox ו-Safari לא מספקים את ה-API הזה. בדיקת טריז לא מתרגלת חיבור טורי, ובדיקה טורית לא אומרת מה סורק טריז יקליד.
ממשקים ייחודיים ליצרן
חלק מהמכשירים משתמשים ב-SDK של יצרן, ב-OPOS, ב-JPOS או בממשק HID שאינו מקלדת כמו USB HID POS. הממשקים האלה לא מקלידים לשדה הממוקד. עמוד אינטרנט רגיל לא יכול לטעון SDK מקורי. Chromium יכול לבקש חלק ממכשירי HID שאינם מקלדת דרך WebHID אחרי מחווה של המשתמש. מכשירי HID ממחלקת מקלדת נשארים חסומים, ולכן סורק טריז נשאר בלתי ניתן להבחנה ממקלדת. התייחסו לממשק יצרן כחיבור נפרד ובדקו אותו בתוכנה שבאמת פותחת את הממשק.
מה הדפדפן יכול לראות
סריקת טריז מגיעה כאירועי keydown ו-keyup, ותווים ברי הדפסה מעדכנים את השדה הממוקד. הדפדפן לא מקבל שם מכשיר, מספר סידורי של USB, או דגל שאומר שהמקור הוא סורק. דפדפנים שמממשים WebHID עדיין מסרבים לממשקי מקלדת, ולכן סקריפט העמוד לא יכול לקרוא גם את דוחות HID הגולמיים של סורק טריז.
event.key הוא התו או שם המקש אחרי שמערכת ההפעלה מפעילה את פריסת המקלדת הפעילה. event.code נותן שם למקש הפיזי, כמו Digit1 או Numpad1, ויכול להישאר זהה כשאי-התאמת פריסה משנה את event.key. אף אחת מהתכונות לא מזהה את החומרה.
איך לבדוק סורק ברקוד פיזי בדפדפן
הריצו את זה לפני שמנפים באגים בקוד היישום. זה מראה את המחרוזת ואת המסיים המדויקים שהדפדפן קיבל.
- חברו את הסורק וחכו עד שהוא מראה שיש לו חשמל. ב-Bluetooth סיימו שיוך ואשרו שהמארח משתמש בפרופיל מקלדת.
- אשרו את מצב הקלט. טריז מקלדת, מקלדת USB HID או מקלדת Bluetooth HID יכולים להקליד לשדה. מצבי טורי, SPP ו-SDK של יצרן לא.
- פתחו את בודק קלט ברקוד.
- לחצו על התחילו בדיקה, או לחצו על אזור הסריקה. הוא נצבע בכחול כשהוא מוכן. העמוד לא לוקח מיקוד בעצמו.
- סרקו ברקוד שהמטען שלו כבר ידוע. התחילו בערך מספרי קצר, ואז סרקו ערך שכולל את סימני הפיסוק שהיישום שומר.
- קראו את הערך שנלכד ואת מספר התווים. השוו את שניהם למטען שאתם מצפים לו, כולל כל קידומת שהסורק מכניס לפני הנתונים.
- בדקו את הסיומת. הבודק מדווח ENTER, TAB או ללא. כשלכידה אוטומטית פועלת, התוצאה מופיעה אחרי Enter, Tab, או הפסקה קצרה ברגע שהמקשים נעצרים. כבו את לכידה אוטומטית כשרוצים שהלכידה תישאר עד שלוחצים עצרו.
- השוו את התוצאה למחרוזת שהיישום צריך לשמור. קידומת, תו שהוחלף, או מסיים חסר צריכים תיקון בהגדרת הסורק או טיפול מכוון בעמוד. אל תתייחסו לזה ככישלון פענוח לפני שההשוואה הזו נעשית.
הבודק רושם אירועי מקלדת שהדפדפן יכול לראות. הוא לא יכול לזהות את התקן ה-USB או לקרוא יציאה טורית. כשעורך טקסט מקבל את הסריקה והדפדפן לא, המשיכו עם הסורק עובד ב-Notepad אבל לא ב-POS.
לכידת קלט של סורק ברקוד עם JavaScript
סורק מקליד לאלמנט שיש לו מיקוד. תנו לשדה תווית גלויה, השאירו אותו כקלט טקסט רגיל כדי שמשתמשי מקלדת יוכלו להקליד קוד, וקראו את הערך כשהתהליך אומר שהקלט הושלם. העמוד למטה עושה את זה. Enter שולח את הטופס פעם אחת. Tab משלים ערך לא ריק ואז נותן לדפדפן להעביר מיקוד. סריקה בלי מסיים נשארת בשדה עד שמישהו מפעיל את 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>
שמרו את הקובץ ופתחו אותו בדפדפן שולחני. לחצו על השדה אם המיקוד זז. סורק טריז, או האמולטור בסעיף הבא, מקליד אז אל #barcode.
מיקוד נדרש. אם document.activeElement הוא גוף המסמך, לחצן, או קלט אחר, המאזינים של השדה הזה לא רואים את הסריקה. התווים נוחתים בפקד הממוקד, או שהם אובדים. קראו ל-field.focus() כשהתהליך מוכן לסריקה, כולל אחרי שתיבת דו-שיח נסגרת.
קלט ריק מתעלמים ממנו. הטופס נשאר במקום, וטקסט המצב אומר שלא התקבל דבר. רווח לבדו ריק אחרי trim().
הדוגמה לא מוסיפה Enter או Tab. אם הסורק לא מוגדר לשלוח אותם, הערך נשאר בשדה ו-Look up הוא נתיב ההשלמה. autocomplete="off" מקטין את הסיכוי שערך שמור יחליף את הסריקה. התווית, הלחצן ו-Shift+Tab נשארים זמינים, כך שאדם יכול להזין קוד בלי סורק.
טפלו ב-Enter במקום אחד. הדוגמה הזו משתמשת באירוע submit של הטופס, שמכסה גם את לחצן Look up וגם Enter מהמקלדת. מאזין keydown שני ל-Enter ירשום את אותה סריקה פעמיים. אם הקלט לא בתוך טופס, האזינו ל-Enter ב-keydown וקראו ל-preventDefault() כדי שטופס אב לא יישלח גם הוא:
field.addEventListener('keydown', (event) => {
if (event.key !== 'Enter') {
return
}
event.preventDefault()
const value = field.value.trim()
if (!value) {
return
}
console.log(value)
field.value = ''
})
נקו את השדה אחרי קבלה מוצלחת כדי שהסריקה הבאה לא תתווסף למטען הקודם. אחרי Enter הדוגמה ממקדת שוב את אותו שדה כי התהליך הזה מצפה לסריקה נוספת באותה תיבה. אחרי Tab היא משאירה את המיקוד כדי שהדפדפן יוכל לעבור לפקד הבא.
טיפול בסיומות ENTER ו-TAB
סיומת היא מקש שהסורק עשוי לשלוח אחרי המטען. זו הגדרת מכשיר. Enter נפוץ, והוא אופציונלי. המדריך סיומות ENTER מול TAB בסורקי ברקוד מתאר איך להבדיל בין המסיימים. אשרו את ההגדרה בסורק שאתם בודקים, ואז התאימו את העמוד לתהליך הזה.
ENTER
Enter בתוך שדה טקסט של שורה אחת שולח את הטופס העוטף בדפדפנים עדכניים. השתמשו בזה כשסריקה אחת צריכה לקבע את הערך, כמו בתיבת חיפוש. preventDefault() על אירוע submit עוצר את הדפדפן מלנווט החוצה. השמיטו אותו כשניווט עמוד מלא הוא ההתנהגות שרוצים.
אם הברקוד מופיע והטופס לא עושה דבר, ייתכן שהסורק לא שולח סיומת. לסורק הברקוד חסר ENTER עובר על ההגדרה הזו. חלק מהמכשירים שולחים NumPad Enter. event.key עדיין "Enter". בדקו את event.key, לא רק את event.code === "Enter", אחרת הסורק הזה ייראה שבור.
TAB
Tab מעביר מיקוד לפקד הבא שאפשר למקד. זה מתאים לרצף כמו קוד מוצר ואז כמות. זה מפתיע טופס שציפה ש-Enter ישלח אותו.
קראו את הערך ב-keydown בזמן שלשדה עדיין יש מיקוד. הדפדפן מעביר מיקוד אחרי האירוע הזה. השאירו את פעולת ברירת המחדל כשהפקד הבא צריך לקבל מיקוד. preventDefault() שומר את המיקוד במקום, וזה שימושי כשהערך לא תקין ורוצים שהמפעיל יראה אותו. התעלמו מ-Shift+Tab כדי שמשתמש מקלדת יוכל לנוע אחורה בטופס. סיומת Tab של סורק היא Tab בלי Shift.
סיומת Tab יכולה גם להעביר מיקוד לפני שהקוד קורא את השדה, אם המאזין על blur או change ומשהו אחר מנקה את הפקד. קראו את הערך מיעד אירוע keydown.
בלי סיומת
בלי סיומת, המטען יושב בשדה. היישום צריך להחליט מתי הסריקה הסתיימה. לחצן מפורש, Enter מאוחר יותר מהמפעיל, או מעבר לשלב אחר הם נקודות השלמה אמינות. טיימר חוסר פעילות יכול להתייחס להפסקה בהקלדה כסוף סריקה. הטיימר הזה הוא היוריסטיקה. סורק איטי, השהיית Bluetooth, או אדם שמקליד מהר יכולים ליפול בצד הלא נכון של הסף. העדיפו סיומת מוגדרת כשהתהליך צריך אות חד-משמעי לסוף סריקה.
הבדלי הגדרה
סורקים מאותו מותג יכולים להגיע עם סיומות שונות, וברקוד הגדרה יכול לשנות את הסיומת בלי שום שינוי ב-JavaScript. חלק מהמכשירים שולחים קידומת, מזהה סימבולוגיה כמו ]C1, או CR ו-LF. בדקו את שלוש הגדרות המסיים שהמשתמשים יכולים באמת לבחור: Enter, Tab, ובלי סיומת. רשמו באיזו משתמשים הסורקים הפרוסים, ובדקו את העמוד מול ההגדרה הזו.
אימות קלט של סורק ברקוד
אמתו את המחרוזת שהשדה קיבל. אל תניחו שלכל ברקוד אותו אורך, אותה ערכת תווים, או אותה ספרת ביקורת. מטענים של Code 128 ושל QR משתנים. EAN-13 הוא 13 ספרות. יישום ששומר את שניהם צריך כללים לשניהם.
קלט ריק. דחו או התעלמו ממנו. סיומת בלי מטען, או לחיצה על Look up בשדה ריק, לא צריכות ליצור רשומה.
תווים לא צפויים. השוו את המחרוזת שהתקבלה לתווית ידועה. אי-התאמת פריסה מופיעה לעתים קרובות כסמל שהשתנה, כמו ספרה מוזזת או פיסוק, בזמן שהאורך נשאר זהה. תווי בקרה יכולים להגיע מקידומת או ממפריד קבוצה של GS1. אפשרו את התווים שהתבנית שלכם מגדירה. הדוגמה למעלה דוחה תווי בקרה של ASCII כדי שיישארו גלויים בטקסט המצב. מנתח GS1 שמצפה למפריד קבוצה צריך לאפשר את התו הזה ולדחות את השאר.
אורך. אכפו את האורכים שהיישום מקבל. מינימום ומקסימום כלליים בטוחים יותר מאורך נדרש אחד כשהטופס מקבל יותר מסימבולוגיה אחת. maxlength על הקלט יקצר בשקט מטען ארוך יותר, אז הגדירו אותו רק כשכל קוד שמתקבל נכנס.
קידומת. הסירו קידומת רק כשהגדרתם את הסורק לשלוח בדיוק את הקידומת הזו והיישום לא שומר אותה.
function withoutConfiguredPrefix(value, prefix) {
if (prefix && value.startsWith(prefix)) {
return value.slice(prefix.length)
}
return value
}
מזהה סימבולוגיה של AIM הוא נתון אם הסורק מוגדר לשדר אותו. השאירו אותו במקום עד שהחלטתם אם היישום שומר אותו.
סיומת. השאירו את המסיים מחוץ לערך השמור. Enter ו-Tab הם מקשים. הם לא מוכנסים לקלט טקסט רגיל. מטען טורי עדיין יכול לכלול בתים של CR או LF. הסירו אותם בגבול שבו מנתחים את הזרם הטורי, ובדקו שאתם לא מסירים אותם מאמצע מטען שמכיל אותם באופן לגיטימי.
שליחות כפולות. סריקה אחת יכולה להיות מטופלת פעמיים אם גם keydown וגם submit רצים לאותו Enter. השתמשו בנתיב השלמה אחד. סריקה שנייה של אותו קוד היא שאלה אחרת. טופס מחסן עשוי להגדיל כמות. טופס כרטיס עשוי לדחות קוד שכבר מומש. שימו את הכלל הזה ביישום, ובדקו אותו בכוונה. הדפדפן לא יכול להבחין בין לחיצת הדק שנייה למאזין שני.
כללי יישום. ספרות ביקורת שייכות לסימבולוגיות מסוימות. EAN-13 משתמש בספרה האחרונה כספרת ביקורת. הפונקציה הזו מקבלת רק את התבנית הזו:
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 ו-QR לא משתמשים בחישוב הזה. הסורק אולי כבר בדק את הסימבולוגיה שלו ושידר את הנתונים הקריאים לאדם. אמתו את התבניות שאתם שומרים, וחזרו על הבדיקה בשרת. המחרוזת שנשלחת היא קלט משתמש רגיל. הדפדפן לא יכול להוכיח שסורק יצר אותה.
בדיקת קלט של סורק ברקוד בלי חומרה פיזית
Barcode Scanner Emulator הוא יישום שולחני ל-Windows, ל-macOS ול-Linux. מזינים את הטקסט לשליחה, בוחרים השהיית הקלדה, ובוחרים סיומת של ללא, ENTER או TAB. קיצור גלובלי מקליד את הטקסט הזה ליישום הממוקד. הוא משחזר את נתיב המקלדת שסורק טריז משתמש בו. הוא לא מאיר תווית, לא קורא סמל, ולא מפענח סימבולוגיה.
השתמשו בעמוד הדוגמה למעלה, או בעמוד שאתם בונים:
- פתחו את העמוד בדפדפן שולחני ולחצו על שדה הברקוד.
- באמולטור הזינו ערך ידוע כמו
123456789012. - הגדירו את הסיומת ל-ENTER. הגדירו את השהיית ההקלדה אם רוצים שהפרץ ידמה לסורק שכבר מדדתם.
- לחצו על קיצור הסריקה הגלובלי של האמולטור בזמן שלשדה בדפדפן עדיין יש מיקוד.
- אשרו את טקסט המצב ושהערך התקבל פעם אחת.
- חזרו עם TAB. המיקוד צריך לזוז, והערך צריך להתקבל פעם אחת.
- חזרו בלי סיומת. הטקסט צריך להישאר בשדה עד שמפעילים את Look up.
- מקדו את בודק קלט ברקוד ושלחו שוב את אותו ערך. השוו את המחרוזת שנלכדה, את הקידומת ואת הסיומת למה שהיישום שמר.
ההתקנה והקיצור הראשון מכוסים בתחילת העבודה. אחרי שינוי הגדרות, שלחו סריקה אחת אל בודק הקלט לפני שסומכים על התוצאה ביישום.
עדיין נדרשת חומרה לחלקים האופטיים והייחודיים למכשיר בבדיקה:
- אם הסורק הזה יכול לפענח את הסמל המודפס או המוצג, כולל תוויות פגומות, גודל, ניגודיות ומרחק.
- תמיכה בסימבולוגיה. סורק לייזר 1D לא יכול לקרוא קוד QR. ראו בדיקת קוד QR: איך לבדוק סורקי QR.
- מניית USB, שיוך Bluetooth, והגדרת פריסת המקלדת והסיומת של הסורק עצמו.
- חיבורי טורי, HID POS ו-SDK של יצרן.
האמולטור הוא הכלי הנכון ללוגיקת היישום לאורך נתיב המקלדת. הוא הכלי הלא נכון להוכחה שסורק מסוים קורא תווית מסוימת.
ניפוי אירועי מקלדת של סורק ברקוד
צפו באירועים בסדר הזה כשהערך השמור שגוי.
keydown. נורה לכל מקש, כולל Enter ו-Tab, לפני שהדפדפן מכניס תו או מעביר מיקוד. קראו את המסיים כאן. event.repeat הוא true כשמקש מוחזק. סורק טריז שולח בדרך כלל לחיצה נפרדת לכל תו.
input. נורה על השדה אחרי שתו בר הדפסה משנה את ערכו. זה האירוע הנכון לצפייה אם צריך את הטקסט בזמן שהוא גדל. הוא לא נורה ל-Enter או ל-Tab, כי המקשים האלה לא מכניסים תו לקלט טקסט.
change. נורה אחרי שהערך מתקבע, בדרך כלל כשהשדה מאבד מיקוד. סורק שמשאיר מיקוד באותו שדה לא ייצר change בסוף הסריקה. אל תשתמשו ב-change כאות ההשלמה היחיד.
event.key ו-event.code. רשמו את שניהם כשתו שגוי. אי-התאמה בין פריסת הסורק לפריסת מערכת ההפעלה משנה את event.key ומשאירה את event.code נראה כמו המקש שהסורק התכוון אליו. ספרות מלוח המקשים המספרי משתמשות ב-Numpad1 ובקודים דומים. חלק ממסכות הקלט מתייחסות אליהן אחרת מ-Digit1. פריסת מקלדת שגויה בסורק ברקוד מסביר את אי-התאמת הפריסה.
מיקוד. רשמו את document.activeElement מיד לפני סריקה. אם זה לא שדה הברקוד, שאר המעקב מסביר את הפקד הלא נכון. ל-iframe יש מיקוד משלו. סריקה לתוך מסגרת מוטמעת גלויה לסקריפט בתוך המסגרת.
תזמון. סורקים מסיימים לעתים קרובות מטען קצר בהרבה פחות משנייה. בודק הקלט משווה את הרווח הממוצע בין תווים לסף של 100 ms ומתייג את התוצאה כתזמון, לא כזיהוי חומרה. סף רווח יכול להתייחס למקליד מהיר, למילוי אוטומטי או לאמולטור כסורק. סורק עם השהיה בין תווים, קישור Bluetooth, או מטען ארוך יכול להיראות כמו הקלדה. השתמשו בערך שנלכד ובסיומת. השתמשו בתזמון כרמז.
בודק אירועי מקלדת מפרט כל keydown ו-keyup עם key, code, מקשי שינוי וחותמות זמן. השתמשו בו כשהמחרוזת המורכבת מסתירה מקש קידומת או קוד לוח מספרים. היומן הוא אירועי דפדפן. הוא לא תעבורת USB גולמית.
בעיות נפוצות ביישומי אינטרנט
הסריקה הולכת לשדה הלא נכון. קלט טריז עוקב אחרי מיקוד. לחצו על שדה היעד אחרי כל ניווט, דו-שיח, או הודעת אימות שמעבירים מיקוד. חלון בלי שדה טקסט יכול לבלוע את הסריקה כמקשי קיצור.
הסורק עובד בעורך טקסט ולא בדפדפן. המכשיר מקליד. העמוד לא מקבל את המקשים האלה. בדקו מיקוד, קלט מושבת או לקריאה בלבד, ומאזין keydown שקורא ל-preventDefault() על מקשים ברי הדפסה. מאזין שמטפל רק ב-paste לא רואה אף פעם קלט טריז. התחילו בסורק הברקוד לא עובד אם שום יישום לא מקבל תווים.
Enter שולח את הטופס פעמיים או מנווט החוצה. הדפדפן שולח את הטופס, והמאזין שלכם גם מטפל ב-Enter. קראו ל-preventDefault() על אחד מהנתיבים האלה ועבדו את הערך פעם אחת. טופס רב-שדות יכול להישלח לפני ששדות מאוחרים מתמלאים כשהסורק שולח Enter. השתמשו ב-Tab לתהליך הזה, או מנעו את השליחה עד שהטופס שלם.
Tab משנה מיקוד. זה מקש Tab. או הגדירו Enter בסורק, או קראו את הערך ב-keydown ואפשרו את העברת המיקוד. ראו את סעיף הסיומת למעלה.
פריסת המקלדת שגויה. ספרות עשויות לשרוד אי-התאמה שמשנה פיסוק. סרקו ערך ידוע שמכיל את הסמלים שאתם שומרים, על הפריסה שתחנת העבודה באמת משתמשת בה.
אותה סריקה יוצרת שתי רשומות. חפשו שני מאזינים על Enter אחד לפני שאתם מחפשים שתי סריקות פיזיות. אחר כך בדקו סריקה שנייה מכוונת ואשרו את כלל הכמות או הכפילות שהיישום מתעד.
הערך חסר או קטוע. מאפיין maxlength, מסכת קלט, או preventDefault() על מקשי תווים יכולים להשמיט או לחתוך את המטען. השוו את מספר התווים בבודק הקלט לערך בשדה שלכם. קידומת יכולה גם לגרום למטען נכון להיראות ארוך מדי.
קודי QR לא מופיעים אף פעם. הסורק עשוי להיות 1D בלבד, או שסימבולוגיית QR מושבתת. היישום לא יכול לתקן את זה. אשרו את החומרה עם בדיקת קוד QR: איך לבדוק סורקי QR, ואז חזרו לבדיקת השדה.
רשימת בדיקה ליישום אינטרנט
השתמשו בזה על המבנה שמתכוונים לשחרר, בכל דפדפן שאתם תומכים בו. בדקו גם פרופיל חדש וגם פרופיל עם הרחבות של מנהל סיסמאות ומילוי אוטומטי, כי ההרחבות האלה מעבירות מיקוד.
- הסורק מחובר או משויך, והמארח מראה שהוא מוכן.
- הסורק במצב טריז מקלדת, לא במצב טורי או במצב SDK של יצרן.
- שדה הברקוד ממוקד מיד לפני הסריקה.
document.activeElementהוא השדה הזה. - ברקוד ידוע מגיע תו אחר תו, כולל האורך.
- סיומת ENTER שולחת או מקבלת את הערך פעם אחת ולא משאירה את המסיים במחרוזת השמורה.
- סיומת TAB מעבירה מיקוד לפקד המיועד, והערך נקרא לפני המעבר.
- הגדרה בלי סיומת משאירה את הערך זמין עד שהיישום משלים אותו.
- שליחה ריקה נדחית או שמתעלמים ממנה.
- סריקה אחת לא יוצרת שתי רשומות. סריקה אמיתית שנייה עוקבת אחרי כלל הכפילות של היישום.
- פיסוק, סמלים וכל מפריד GS1 שהתבניות שלכם משתמשות בו שורדים את המסלול הלוך ושוב.
- פריסת המקלדת של הסורק ופריסת מערכת ההפעלה מייצרות את התווים המודפסים על התווית.
- אחרי ניתוק וחיבור מחדש, או אחרי שקישור Bluetooth נופל, הסריקה הבאה עדיין מגיעה לשדה.
- כמה סריקות ברצף נשארות ערכים נפרדים. השדה לא משרשר אותן.
- אותן בדיקות עוברות בדפדפנים שאתם תומכים בהם, עם הרחבות מילוי אוטומטי נפוצות ובלעדיהן.
לתיבות דו-שיח, סדר טאב לאורך קופה שלמה, וזרימות כמות ב-POS, המשיכו עם איך לבדוק קלט של סורק ברקוד.
מטריצת מקרי בדיקה
עמודת הסורק היא מה שהמכשיר והדפדפן עושים. עמודת ההתנהגות הצפויה היא מה שהיישום צריך לעשות בתגובה. כללים עסקיים, כמו אם קוד מוצר חוזר מגדיל כמות, שייכים ליישום. ציינו אותם בבדיקה במקום להניח כלל אחד לכל מוצר.
| תרחיש | התנהגות צפויה |
|---|---|
| ברקוד תקין | היישום מקבל את הערך ושומר את המטען בלי המסיים. |
| קלט ריק | היישום דוחה או מתעלם ממנו ולא יוצר רשומה. |
| סיומת ENTER | היישום שולח או מקבל את הערך פעם אחת. |
| סיומת TAB | המיקוד עובר לפקד הבא המיועד, והערך נשמר. |
| בלי סיומת | הקלט נשאר זמין עד שהיישום מעבד אותו. |
| סריקות רצופות מהירות | כל ערך מעובד בנפרד ולא מחובר לקודם. |
| פריסת מקלדת שגויה | תווים לא צפויים גלויים בערך שנלכד והאימות נכשל. |
| סריקה כפולה | היישום עוקב אחרי כלל הכפילות שלו, כמו הגדלת כמות או דחיית חזרה. |
| תבנית ברקוד לא תקינה | היישום מציג את שגיאת האימות של התבנית הזו ולא שומר את הערך. |
| אובדן מיקוד הקלט | היישום לא ממציא ברקוד. הסריקה נעדרת או נוחתת בפקד הממוקד, והעמוד נשאר במצב בטוח. |
הריצו את שורות התקין, הריק, ENTER, TAB ובלי סיומת עם הסורק הפיזי ושוב עם האמולטור. הריצו את שורות פריסת המקלדת, QR והחיבור מחדש על החומרה. השורות האלה תלויות במכשיר, בתווית או בפריסת מערכת ההפעלה, והקשות מדומות לא משחזרות אותן.