Barcode Scanner Emulator
كيفية اختبار ماسحات الباركود في تطبيقات الويب
ترسل كثير من ماسحات USB وBluetooth البيانات المفكوك ترميزها كإدخال لوحة مفاتيح، فيستطيع حقل مركّز في تطبيق ويب استلام المسح دون واجهة برمجية خاصة بالماسح في المتصفح. المنافذ التسلسلية وحزم 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 تلك الواجهة. اختبار الإسفين لا يمرّن تكاملًا تسلسليًا، والاختبار التسلسلي لا يخبرك بما سيكتبه ماسح الإسفين.
الواجهات الخاصة بالبائع
تستخدم بعض الأجهزة 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 مباشرة قبل المسح. إذا لم يكن حقل الباركود، فبقية الأثر تفسر عنصر التحكم الخطأ. للإطارات المضمّنة تركيزها الخاص. المسح داخل إطار مضمّن ظاهر للسكربت داخل ذلك الإطار.
التوقيت. تنهي الماسحات غالبًا حمولة قصيرة في أقل بكثير من ثانية. يقارن فاحص الإدخال متوسط الفجوة بين الأحرف بعتبة 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 وإعادة التوصيل على العتاد. تعتمد تلك الصفوف على الجهاز أو الملصق أو تخطيط نظام التشغيل، وهو ما لا تعيد ضغطات المفاتيح المحاكاة إنتاجه.