Barcode Scanner Emulator
كيفية اختبار إدخال ماسح رمز QR في تطبيقات الويب
تستخدم كثير من الماسحات الخارجية القادرة على QR وضع إسفين لوحة المفاتيح، وتكتب نص QR المفكوك ترميزه في الحقل المركّز. اختبر هذا المسار بمسح حمولة معروفة ومقارنتها بالقيمة التي استلمتها الصفحة. ليس كل ماسح QR يكتب كلوحة مفاتيح. الأجهزة التسلسلية ومفككات الكاميرا تكاملات مختلفة، وأحداث لوحة مفاتيح المتصفح لا تعرّف الماسح الفيزيائي.
يخزّن رمز QR بيانات. يحوّل الماسح، أو مفكك الكاميرا، تلك البيانات إلى نص. على تطبيق الويب بعد ذلك أن يستلم هذا النص، وأن يقرر متى اكتمل المسح، وأن يتحقق منه. هذا الدليل هو اختبار التطبيق ذاك. توليد الملصقات وفحص التباين والتأكد من أن جهازًا يستطيع فك ترميز QR Code مغطاة في اختبار رمز QR: كيف تختبر ماسحات رمز QR. نماذج الباركود العامة، بما فيها أرقام تحقق EAN، مغطاة في كيفية اختبار ماسحات الباركود في تطبيقات الويب.
اختبر إدخال ماسح QR في 60 ثانية
استخدم حمولة اخترتها أنت، حتى يكون الحرف الخاطئ واضحًا. يستخدم هذا المسار QR-INPUT-TEST-12345.
- افتح مولّد رمز QR وولّد رمز QR لـ
QR-INPUT-TEST-12345. يعمل المولّد في المتصفح. لا يتصل بالماسح. - وصّل ماسحًا قادرًا على QR ومضبوطًا على وضع إسفين لوحة المفاتيح. لا يستطيع ماسح أحادي البعد فقط فك ترميز هذا الرمز.
- افتح فاحص إدخال الباركود.
- انقر بدء الاختبار، أو انقر منطقة المسح، حتى يحصل الحقل على التركيز. لا يأخذ الفاحص التركيز من تلقاء نفسه، ولا يفتح الماسح.
- امسح رمز QR.
- اقرأ النص الملتقط وعدد الأحرف.
- قارن ذلك النص بـ
QR-INPUT-TEST-12345. يشمل التطابق حالة الأحرف والواصلات والطول. - اقرأ اللاحقة. يبلغ الفاحص عن ENTER أو TAB أو لا شيء عندما يرسل الماسح أحد تلك المفاتيح.
يسجّل الفاحص أحداث لوحة المفاتيح التي يستطيع المتصفح رؤيتها. لا يتعرّف على جهاز USB، ولا يقرأ منفذًا تسلسليًا، ولا يفك ترميز صورة QR.
أوضاع إدخال ماسح QR
يمكن أن يصل رمز QR المطبوع نفسه عبر ثلاثة تكاملات مختلفة. اختبار وضع واحد لا يمرّن الأوضاع الأخرى.
ماسحات QR بإسفين لوحة المفاتيح
في وضع لوحة مفاتيح USB HID، أو وضع لوحة مفاتيح Bluetooth HID، يعامل نظام التشغيل الماسح كلوحة مفاتيح. بعد فك الترميز يكتب الماسح الحمولة في عنصر التحكم الذي يملك التركيز. يستطيع <input> أو <textarea> عادي استلامها. لا تفتح الصفحة الجهاز. يصف شرح إسفين لوحة مفاتيح HID تسلسل الضغطات والبادئات واللاحقات.
التركيز هو الذي يقرر الوجهة. إذا كان العنصر المركّز جسم المستند أو زرًا أو إطارًا آخر، فمستمعو هذا الحقل لا يرون المسح.
ماسحات QR التسلسلية
يرسل ماسح USB التسلسلي أو منفذ COM الافتراضي النص المفكوك ترميزه كبايتات إلى العملية التي فتحت المنفذ. لا يختار التركيز تلك العملية. يبقى حقل يستمع فقط إلى ضغطات المفاتيح فارغًا بينما تُظهر طرفية على ذلك المنفذ الحمولة.
تستطيع المتصفحات المبنية على Chromium فتح منفذ يختاره المستخدم عبر Web Serial API، في سياق آمن، بعد إيماءة من المستخدم. لا يوفّر Firefox وSafari تلك الواجهة. لا يظهر ماسح الإسفين كمنفذ تسلسلي. تعتمد أسماء المنافذ ومعدل البود والتأطير على الجهاز والمشغّل. تقارن ماسحات الباركود USB HID مقابل التسلسلي الواجهتين. لا يستطيع فاحص إدخال الباركود قراءة منفذ COM.
المسح بكاميرا QR
يلتقط تكامل الكاميرا صورة ويفك ترميز رمز QR في البرنامج. تستخدم الصفحة واجهة كاميرا ومفككًا. لا تستلم أحداث keydown للحمولة. تطبيقات كاميرا الهاتف وأزرار الكاميرا داخل الصفحة ومصوّر عتادي يكتب في حقل هي ثلاثة منتجات مختلفة. اجتياز اختبار الإسفين لا يعني أن زر الكاميرا يعمل، وفك الترميز الناجح بالكاميرا لا يعني أن ماسح الإسفين سيكتب السلسلة نفسها.
التقاط إدخال ماسح QR باستخدام JavaScript
تقرأ الصفحة أدناه حقلًا واحدًا مركّزًا. يرسل Enter النموذج، ويستخدم زر Accept معالج الإرسال نفسه، فيُعالَج المسح الواحد مرة واحدة. بلا لاحقة ENTER يبقى النص في الحقل إلى أن يفعّل أحدهم Accept. تُكتب الحمولة الملتقطة بـ textContent، فتبقى أحرف مثل < ظاهرة كنص.
يقبل المثال ثلاثة تنسيقات للتطبيق: معرّف تذكرة مثل QR-INPUT-TEST-12345، أو عنوان URL بنظام http أو https، أو كائن JSON. يسجّل النص الممسوح. لا ينتقل إلى عنوان URL موجود في رمز QR. ماسح لا يرسل Enter يظل يعمل عبر الزر. ينتقل Tab عبر التسمية والحقل والزر كالمعتاد، لأن السكربت لا يحبسه.
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>QR input example</title>
</head>
<body>
<form id="qr-form">
<label for="qr">QR payload</label>
<input id="qr" name="qr" type="text" autocomplete="off" spellcheck="false">
<button type="submit">Accept</button>
</form>
<p id="status" role="status"></p>
<pre id="captured"></pre>
<script>
const form = document.querySelector('#qr-form')
const field = document.querySelector('#qr')
const status = document.querySelector('#status')
const captured = document.querySelector('#captured')
if (
!(form instanceof HTMLFormElement) ||
!(field instanceof HTMLInputElement) ||
!(status instanceof HTMLElement) ||
!(captured instanceof HTMLElement)
) {
throw new Error('QR form markup is missing.')
}
const accepted = new Set()
function classify(raw) {
if (/[\u0000-\u001F\u007F]/.test(raw)) {
return { status: 'invalid', message: 'Control character in the QR payload.' }
}
const value = raw.trim()
if (!value) {
return { status: 'empty' }
}
if (value.length > 2048) {
return { status: 'invalid', message: 'QR payload is longer than this form accepts.' }
}
if (/^QR-[A-Z0-9-]{1,64}$/.test(value)) {
return { status: 'ok', value }
}
if (value.startsWith('{')) {
try {
const data = JSON.parse(value)
if (!data || typeof data !== 'object' || Array.isArray(data)) {
return { status: 'invalid', message: 'QR JSON must be an object.' }
}
return { status: 'ok', value }
} catch {
return { status: 'invalid', message: 'QR text is not valid JSON.' }
}
}
if (value.startsWith('http://') || value.startsWith('https://')) {
try {
const url = new URL(value)
if (url.protocol !== 'http:' && url.protocol !== 'https:') {
return { status: 'invalid', message: 'Only http and https URLs are accepted.' }
}
return { status: 'ok', value }
} catch {
return { status: 'invalid', message: 'The QR text is not a valid URL.' }
}
}
return { status: 'invalid', message: 'Unexpected QR payload.' }
}
form.addEventListener('submit', (event) => {
event.preventDefault()
const outcome = classify(field.value)
if (outcome.status === 'empty') {
status.textContent = 'No QR payload received.'
field.focus()
return
}
if (outcome.status === 'invalid') {
status.textContent = outcome.message
captured.textContent = ''
field.focus()
return
}
if (accepted.has(outcome.value)) {
status.textContent = 'Already accepted ' + outcome.value
field.value = ''
field.focus()
return
}
accepted.add(outcome.value)
captured.textContent = outcome.value
status.textContent = 'Accepted ' + outcome.value
field.value = ''
field.focus()
})
</script>
</body>
</html>
احفظ الملف وافتحه في متصفح سطح مكتب. انقر الحقل قبل المسح. يقلل autocomplete="off" احتمال أن تحل قيمة محفوظة محل المسح. تبقى التسمية والزر متاحين، فيستطيع شخص كتابة حمولة بلا ماسح.
عالج Enter في حدث submit للنموذج فقط. مستمع keydown ثانٍ لـ Enter يسجّل المسح نفسه مرتين. يُبقي preventDefault() المتصفح في هذه الصفحة. امسح الحقل بعد القرار حتى لا يُلحَق المسح التالي بالنص السابق.
قد تحتوي حمولة QR على فاصل سطر. غالبًا ما يكتب ماسح الإسفين ذلك الفاصل كـ Enter. في إدخال من سطر واحد يمكن أن يُرسل النموذج عند السطر الأول ويسقط الباقي. استخدم textarea، أو قارئًا تسلسليًا يحتفظ بالبايتات، عندما يجب أن يقبل التطبيق نصًا متعدد الأسطر. أكّد ذلك السلوك برمز QR تتضمن حمولته سطرًا جديدًا.
التعامل مع حمولات QR
لا يعد رمز QR بتنسيق تطبيق. يمكن أن تحمل الترميزات نفسها أيًا مما يلي:
- نصًا عاديًا، مثل
QR-INPUT-TEST-12345. - عنوان URL.
- معرّفًا اختاره التطبيق.
- حمولة منظَّمة مثل رقم تذكرة مع رمز موقع.
- نص JSON، عندما عرّف التطبيق ذلك الترميز.
يرسل الماسح الأحرف المفكوك ترميزها. لا يتحقق من أنها تطابق قاعدة تذكرة أو كتالوج منتجات أو مخطط JSON. تحقق من السلسلة في الصفحة، وتحقق منها مرة أخرى على الخادم. القيمة المرسلة إدخال مستخدم عادي. لا يستطيع المتصفح إثبات أن ماسحًا أنتجها.
التحقق من إدخال QR
لا تفترض أن حمولة QR رقمية. لا تنطبق قواعد EAN-13. عامل النص كغير موثوق: اعرضه كنص، ولا تسنده إلى location أو innerHTML أو عنوان URL لسكربت.
قيم فارغة. لا ينبغي أن ينشئ Enter وحده، أو Accept على حقل فارغ، سجلًا. يرفض trim() أيضًا حمولة ليست إلا مسافات.
أحرف غير متوقعة. قارن السلسلة المستلمة بمحتوى QR المعروف. يغيّر اختلاف تخطيط لوحة المفاتيح علامات الترقيم غالبًا بينما يبقى الطول كما هو. ارفض الأحرف التي لا يسمح بها التنسيق، وأظهر السبب في نص الحالة.
طول الحمولة. افرض الحد الأقصى الذي يخزّنه تطبيقك. maxlength على الإدخال يقطع مسحًا أطول بلا خطأ. ضعه فقط عندما تتسع كل حمولة مقبولة، وقارن عدد أحرف الفاحص بالحقل عندما تبدو القيمة قصيرة.
بادئات مطلوبة. فحص البادئة يخص التطبيق. تقبل قاعدة التذكرة هذه QR- بالإضافة إلى أحرف كبيرة وأرقام وواصلات:
function isTicketId(value) {
return /^QR-[A-Z0-9-]{1,64}$/.test(value)
}
انزع بادئة الماسح فقط عندما يكون ذلك الماسح مضبوطًا لإرسال بادئة واحدة بعينها والتطبيق لا يخزّنها. معرّف ترميز AIM بيانات إلى أن تقرر خلاف ذلك.
تنسيقات خاصة بالتطبيق. أبقِ القاعدة بجانب التنسيق. نموذج تذكرة وقائمة عناوين URL مسموحة وكائن JSON تحتاج فحوصات مختلفة. نمط رقمي واحد سيرفض نص QR صالحًا.
عمليات مسح مكررة. يمكن أن يصيب مسح فيزيائي واحد مستمعَين. استخدم مسار إكمال واحدًا، كما يفعل المثال. سحبة زناد ثانية حدث منفصل. يرفض المثال حمولة قبلها من قبل. قد يزيد نموذج مستودع الكمية بدل ذلك. اختبر القاعدة التي يوثّقها تطبيقك.
JSON مشوّه. يرمي JSON.parse عند نص غير مكتمل. افحص الشكل بعد تحليل ناجح. قد تكون مصفوفة أو رقم مجرد JSON صالحًا ويظلان النوع الخطأ:
function readJsonObject(value) {
try {
const data = JSON.parse(value)
if (!data || typeof data !== 'object' || Array.isArray(data)) {
return { ok: false, message: 'QR JSON must be an object.' }
}
return { ok: true, data }
} catch {
return { ok: false, message: 'QR text is not valid JSON.' }
}
}
عناوين URL غير متوقعة. حلّل عنوان URL لترى إن كان قابلًا للاستخدام، ثم أبقِ السلسلة الممسوحة إذا وجب أن يطابق الاختبار حمولة QR تمامًا. يستطيع URL.href إضافة شرطة مائلة أو تغيير الترميز. اقبل فقط الأنظمة التي يقصدها التطبيق. لا تفتح عنوان URL أثرًا جانبيًا للمسح:
function readWebUrl(value) {
let url
try {
url = new URL(value)
} catch {
return { ok: false, message: 'The QR text is not a valid URL.' }
}
if (url.protocol !== 'http:' && url.protocol !== 'https:') {
return { ok: false, message: 'Only http and https URLs are accepted.' }
}
return { ok: true, value }
}
أحرف التحكم. ارفض أحرف تحكم ASCII في حمولة لوحة المفاتيح حتى تبقى بادئة مخفية ظاهرة في نص الحالة. CR وLF أحرف تحكم. على ماسح إسفين، Enter وTab مفتاحان. ليسا حرفين داخل إدخال نص عادي. قد تحتوي حمولة تسلسلية مع ذلك على بايتات 0x0D أو 0x0A. انزعها عند حد تأطير التسلسل، ولا تزل CR ينتمي إلى وسط حمولة متعددة الأسطر.
لاحقات ENTER وTAB
اللاحقة إعداد اختياري للماسح. ليست جزءًا من رمز QR. تبيّن لاحقات ENTER وTAB في ماسحات الباركود كيف تميّز المفاتيح. اقرأ اللاحقة في فاحص الإدخال، ثم اجعل الصفحة تطابق الماسحات التي تنشرها.
ENTER يرسل نموذج حقل نص من سطر واحد في المتصفحات الحالية. استخدم ذلك عندما ينبغي لمسح واحد أن يثبّت القيمة. استدعِ preventDefault() على submit عندما ينبغي أن تبقى الصفحة في مكانها.
TAB ينقل التركيز إلى عنصر التحكم التالي. اقرأ القيمة في keydown بينما لا يزال الحقل يملك التركيز. اترك الإجراء المبدئي عندما ينبغي أن يستلم الحقل التالي التركيز. تجاهل Shift+Tab حتى يستطيع مستخدم لوحة المفاتيح الرجوع إلى الخلف.
بلا لاحقة يترك الحمولة في الحقل. زر Accept في المثال هو مسار الإكمال. يستطيع مؤقّت خمول أن يخمّن أن وقفة تعني انتهاء المسح. ذلك المؤقّت حدس: دفعة Bluetooth بطيئة وكاتب سريع يمكن أن يتجاوزا الفجوة نفسها. فضّل لاحقة مضبوطة عندما يحتاج سير العمل إلى نهاية قاطعة.
CR وLF بايتات. Enter في لوحة المفاتيح هو event.key === "Enter". ليسا قابلين للتبادل. مستمع يكتفي بنزع \r من قيمة الإدخال لن يرى Enter الإسفين، لأن الحرف لم يُدرج قط. مستمع يكتفي بمراقبة event.key لن يقسم مخزنًا تسلسليًا عند 0x0D. ترسل بعض الأجهزة Enter لوحة الأرقام. يبقى event.key هو "Enter". افحص event.key، لا event.code === "Enter" وحده.
يمكن أن تتغير اللاحقة عندما يمسح أحدهم باركود إعداد من دليل الجهاز. أعد اختبار Enter وTab وغياب اللاحقة بعد أي تغيير في الإعداد. لا تخترع باركود برمجة. استخدم دليل ذلك الطراز.
تنقيح أحداث لوحة المفاتيح
عندما يكون النص المخزّن خاطئًا، افحص الأحداث بهذا الترتيب.
keydown. يُطلق لكل مفتاح، بما في ذلك Enter وTab، قبل أن يدرج المتصفح حرفًا أو ينقل التركيز. اقرأ المنهي هنا.
input. يُطلق بعد أن يغيّر حرف قابل للطباعة الحقل. لا يُطلق لـ Enter أو Tab على إدخال نص.
event.key. الحرف أو اسم المفتاح بعد أن يطبّق نظام التشغيل تخطيط لوحة المفاتيح.
event.code. المفتاح الفيزيائي، مثل Digit1 أو Numpad1. يمكن أن يبقى كما هو عندما يغيّر اختلاف التخطيط event.key.
التركيز. سجّل document.activeElement قبل المسح. إذا لم يكن حقل QR، فبقية الأثر تصف عنصر التحكم الخطأ. لـ iframe تركيزه الخاص.
الترتيب. في مسح إسفين إلى حقل نص، تتبع أحداث keydown القابلة للطباعة تحديثات input، ثم keydown أخير لـ Enter أو Tab عندما تكون تلك اللاحقة مضبوطة. يُطلق change عندما يثبّت الحقل القيمة، عادة عند فقدان التركيز. مسح يترك التركيز في الحقل نفسه لا ينتج change في النهاية. لا تستخدم change إشارة الإكمال الوحيدة.
التوقيت. تنهي الماسحات غالبًا حمولة قصيرة في أقل بكثير من ثانية. يقارن فاحص الإدخال متوسط الفجوة بين الأحرف بعتبة 100 ms ويسمّي النتيجة توقيتًا، لا تعرّفًا على العتاد. يمكن لكاتب سريع أو تعبئة تلقائية أو المحاكي أن يقع على جانب الماسح من تلك العتبة. يمكن لمسح Bluetooth متأخر أن يبدو ككتابة. أكّد الحمولة واللاحقة. عامل التوقيت كقرينة.
يسرد فاحص أحداث لوحة المفاتيح كل keydown وkeyup مع key وcode والمعدّلات والطوابع الزمنية. السجل أحداث متصفح. ليس حركة USB خام.
الاختبار بلا ماسح QR فيزيائي
يمكن اختبار منطق التطبيق قبل أن يكون الماسح على المكتب.
- اكتب
QR-INPUT-TEST-12345في الحقل وفعّل Accept. يفحص ذلك التحقق والعرض. لا يفحص فك الترميز ولا اللاحقات. - قد الحقل نفسه من أداة أتمتة للمتصفح، كما يفعل القسم التالي.
- استخدم Barcode Scanner Emulator عندما تحتاج كتابة بأسلوب الماسح. يرسل تطبيق سطح المكتب قيمة تدخلها، مع تأخير كتابة ولاحقة بلا منهي أو ENTER أو TAB، إلى التطبيق المركّز. يعيد مسار لوحة المفاتيح. لا يصوّر صورة QR ولا يفك ترميز رمز ولا ينشئ منفذ COM افتراضيًا.
ما زال العتاد مطلوبًا للسلوك البصري وسلوك الجهاز: هل يستطيع ذلك الماسح قراءة الرمز المعروض أو المطبوع، وهل ترميز QR مفعّل، وتخطيط لوحة المفاتيح، وإعداد اللاحقة، وأوضاع التسلسل أو SDK البائع. المحاكي هو الفحص المناسب لمسار لوحة المفاتيح. وهو الفحص غير المناسب لإثبات أن جهازًا يقرأ رمز QR بعينه.
أتمتة اختبارات إدخال QR
تقود اختبارات Playwright التالية صفحة المثال. تكتب في الحقل بالطريقة التي يكتب بها ماسح الإسفين، ثم تؤكد سلوك التطبيق. لا تفتح أجهزة USB. @playwright/test اعتماد للقارئ. هذا الموقع لا يتطلبه.
احفظ مثال HTML باسم qr-form.html بجانب هذا الاختبار.
import { readFileSync } from 'node:fs'
import { expect, test } from '@playwright/test'
const html = readFileSync(new URL('./qr-form.html', import.meta.url), 'utf8')
async function openForm(page) {
await page.setContent(html)
}
test('accepts a known QR payload once', async ({ page }) => {
await openForm(page)
const field = page.getByLabel('QR payload')
await field.pressSequentially('QR-INPUT-TEST-12345')
await field.press('Enter')
await expect(page.getByRole('status')).toHaveText('Accepted QR-INPUT-TEST-12345')
await expect(page.locator('#captured')).toHaveText('QR-INPUT-TEST-12345')
})
test('rejects an unexpected payload', async ({ page }) => {
await openForm(page)
const field = page.getByLabel('QR payload')
await field.pressSequentially('not-a-ticket')
await field.press('Enter')
await expect(page.getByRole('status')).toHaveText('Unexpected QR payload.')
await expect(page.locator('#captured')).toBeEmpty()
})
test('commits on ENTER and rejects a duplicate scan', async ({ page }) => {
await openForm(page)
const field = page.getByLabel('QR payload')
await field.pressSequentially('QR-INPUT-TEST-12345')
await field.press('Enter')
await field.pressSequentially('QR-INPUT-TEST-12345')
await field.press('Enter')
await expect(page.getByRole('status')).toHaveText('Already accepted QR-INPUT-TEST-12345')
await expect(page.locator('#captured')).toHaveText('QR-INPUT-TEST-12345')
})
test('does not capture keys while the field is unfocused', async ({ page }) => {
await openForm(page)
await page.getByRole('button', { name: 'Accept' }).focus()
await page.keyboard.type('QR-INPUT-TEST-12345')
await expect(page.getByLabel('QR payload')).toHaveValue('')
await expect(page.locator('#captured')).toBeEmpty()
await expect(page.getByRole('status')).toHaveText('')
})
test('shows unexpected characters as text', async ({ page }) => {
await openForm(page)
const payload = '<img src=x onerror=alert(1)>'
const field = page.getByLabel('QR payload')
await field.fill(payload)
await page.getByRole('button', { name: 'Accept' }).click()
await expect(page.getByRole('status')).toHaveText('Unexpected QR payload.')
await expect(page.locator('#captured img')).toHaveCount(0)
await expect(page.locator('img')).toHaveCount(0)
})
يدرج pressSequentially الأحرف في الحقل المركّز. ليس أداة USB. يستخدم اختبار الأحرف غير المتوقعة fill لأن الهدف رسالة التحقق وغياب عنصر محقون. وسّع الملف بحالة URL وحالة JSON عندما تكون تلك التنسيقات في الإصدار الذي تشحنه. ينبغي لتأكيد URL أن يقارن النص الملتقط بسلسلة QR الأصلية.
مصفوفة اختبار ماسح QR
شغّل هذه على التطبيق قيد الاختبار. تغطي صفحة العينة أعلاه صفوف التذكرة وURL وJSON والتكرار والفارغ والأحرف غير المتوقعة. تطبيق رقمي فقط أو متعدد الأسطر يحتاج نتيجته المتوقعة الخاصة.
| السيناريو | النتيجة المتوقعة |
|---|---|
| QR بنص عادي | استلام القيمة المطابقة |
| QR بعنوان URL | التقاط عنوان URL كاملًا، وعدم انتقال الصفحة إليه |
| QR رقمي | الحفاظ على الأرقام |
| أحرف خاصة | استلام الأحرف الصحيحة |
| حمولة JSON | التقاط البيانات والتحقق منها |
| لاحقة ENTER | حدوث المعالجة مرة واحدة |
| لاحقة TAB | معالجة سلوك التركيز |
| بلا لاحقة | يستخدم التطبيق آلية إكمال بديلة |
| مسح مكرر | يطبّق التطبيق قواعد معالجة التكرار |
| حمولة غير صالحة | عرض خطأ التحقق |
| تركيز مفقود | يعالج التطبيق الإدخال الغائب بأمان |
| حمولة طويلة | لا اقتطاع غير مقصود |
امسح أيضًا حمولة تحتوي سطرًا جديدًا إذا كان يجب أن يخزّن المنتج واحدًا. سجّل ما إذا كان الحقل قد استلم كل سطر.
استكشاف الأخطاء
ابدأ بحمولة معروفة في فاحص الإدخال. إذا كانت قيمة الفاحص خاطئة أصلًا، فالصفحة ليست العطل الأول. إذا كانت قيمة الفاحص صحيحة والتطبيق خاطئًا، فالعطل في التركيز أو التحقق أو معالجة الأحداث. ماسح الباركود لا يعمل قائمة فحص أوسع للجهاز. يغطي كيفية اختبار إدخال ماسح الباركود التركيز والتخطيط وسير عمل POS خارج هذا النموذج.
يصدر الماسح صوتًا ولا يظهر إدخال
يعني الصفير عادة أن الماسح فك ترميز رمز. لا يعني أن الصفحة استلمت النص. أكّد وضع إسفين لوحة المفاتيح. وضعا التسلسل والكاميرا لن يكتبا في الحقل. انقر الحقل حتى يكون document.activeElement ذلك الإدخال، ثم امسح مرة أخرى. يمكن لحقل معطّل أو للقراءة فقط أو مخفي أن يتجاهل المفاتيح.
يعمل ماسح QR في Notepad ولا يعمل في المتصفح
الجهاز يكتب. الصفحة لا تقبل تلك المفاتيح. تحقق من التركيز، ومن مستمع keydown يستدعي preventDefault() على المفاتيح القابلة للطباعة، ومن مستمع يعالج paste فقط. لا يطلق إدخال الإسفين حدث لصق. قارن نتيجة الفاحص بحقل التطبيق.
يقرأ الماسح الباركود ولا يقرأ رموز QR
قد يكون الجهاز أحادي البعد فقط، أو قد يكون ترميز QR معطّلًا. لا تستطيع الصفحة إصلاح ذلك. أكّد دعم 2D وفعّل QR Code من دليل الجهاز، باستخدام الفحوصات في اختبار رمز QR: كيف تختبر ماسحات رمز QR. مسح Code 128 الناجح يثبت مسار لوحة المفاتيح فقط.
أحرف غير صحيحة
امسح QR-INPUT-TEST-12345 أولًا. إذا طابق ولم تطابق حمولة URL أو JSON، فالتخطيط يغيّر علامات ترقيم مثل : أو / أو { أو ". قارن event.key بـ event.code في فاحص أحداث لوحة المفاتيح، وانظر تخطيط لوحة مفاتيح خاطئ في ماسح الباركود. طابق تخطيط لوحة مفاتيح الماسح مع نظام التشغيل.
يرسل ENTER النموذج مرتين
يرسل المتصفح النموذج، ويعالج مستمع keydown أيضًا Enter. أبقِ مسار إكمال واحدًا واستدعِ preventDefault() هناك. مسح فيزيائي ثانٍ عطل مختلف. يقول نص الحالة في المثال إن الحمولة قُبلت من قبل. إذا أنشأ المسح الأول نفسه سجلين، فابحث عن مستمعين قبل تغيير الماسح.
إدخال QR مقتطع
قارن عدد الأحرف في فاحص الإدخال بالقيمة في الحقل. يمكن لسمة maxlength أو قناع إدخال أو preventDefault() على مفاتيح الأحرف أن تقطع السلسلة. يمكن لسطر جديد داخل حمولة QR أن يرسل إدخالًا من سطر واحد مبكرًا. تحد بعض الماسحات أيضًا عدد الأحرف التي تكتبها. ارفع ذلك الحد من دليل الجهاز عندما يُظهر الفاحص، لا التطبيق وحده، قيمة قصيرة. يغطي ماسح الباركود يفتقد ENTER الحالة المرتبطة التي تصل فيها الحمولة ولا يثبّت النموذج أبدًا.
لا يستطيع الماسح قراءة رمز QR على الشاشة
أكّد أن الماسح مصوّر 2D. ارفع سطوع الشاشة، وزِد حجم الرمز، وأبقِ منطقة الهدوء خالية من النص والحدود. الوهج وشاشة هاتف خافتة ورمز أكثف من أن يُقرأ من مسافة العمل مشكلات بصرية. اطبع الحمولة نفسها إذا استمر فشل القراءة من الشاشة. يظل اختبار التطبيق يستخدم السلسلة المعروفة ما إن ينتج أي مسح نصًا.