Barcode Scanner Emulator
वेब ऐप्लिकेशन में QR कोड स्कैनर इनपुट कैसे परखें
कई बाहरी QR-सक्षम स्कैनर कीबोर्ड-वेज मोड इस्तेमाल करते हैं और डिकोड किया QR पाठ फ़ोकस वाले फ़ील्ड में टाइप करते हैं। ज्ञात पेलोड स्कैन करके और पेज को मिले मान से तुलना करके उस पथ को परखें। हर QR स्कैनर कीबोर्ड की तरह टाइप नहीं करता। सीरियल डिवाइस और कैमरा डिकोडर अलग एकीकरण हैं, और ब्राउज़र के कीबोर्ड इवेंट भौतिक स्कैनर की पहचान नहीं करते।
QR कोड डेटा रखता है। स्कैनर, या कैमरा डिकोडर, उस डेटा को पाठ बनाता है। वेब ऐप्लिकेशन को फिर वह पाठ पाना होता है, तय करना होता है कि स्कैन कब खत्म हुआ, और उसे सत्यापित करना होता है। यह गाइड वही ऐप्लिकेशन परीक्षण है। लेबल बनाना, कंट्रास्ट जाँचना, और यह पुष्टि करना कि कोई डिवाइस QR Code डिकोड कर सकता है, QR कोड परीक्षण: QR कोड स्कैनर कैसे परखें में है। EAN जाँच अंकों सहित सामान्य बारकोड फ़ॉर्म वेब ऐप्लिकेशन में बारकोड स्कैनर कैसे परखें में हैं।
60 सेकंड में QR स्कैनर इनपुट परखें
ऐसा पेलोड इस्तेमाल करें जिसे आपने चुना हो, ताकि गलत अक्षर साफ़ दिखे। यह क्रम QR-INPUT-TEST-12345 इस्तेमाल करता है।
- QR कोड जनरेटर खोलें और
QR-INPUT-TEST-12345के लिए QR कोड बनाएँ। जनरेटर ब्राउज़र में चलता है। वह स्कैनर से संपर्क नहीं करता। - कीबोर्ड-वेज मोड पर सेट QR-सक्षम स्कैनर जोड़ें। केवल 1D स्कैनर यह प्रतीक डिकोड नहीं कर सकता।
- बारकोड इनपुट टेस्टर खोलें।
- परीक्षण शुरू करें पर क्लिक करें, या स्कैन क्षेत्र पर क्लिक करें, ताकि फ़ील्ड को फ़ोकस मिले। टेस्टर अपने आप फ़ोकस नहीं लेता, और स्कैनर नहीं खोलता।
- QR कोड स्कैन करें।
- कैप्चर किया पाठ और अक्षर-संख्या पढ़ें।
- उस पाठ की तुलना
QR-INPUT-TEST-12345से करें। मिलान में अक्षरों का केस, हाइफ़न और लंबाई शामिल हैं। - प्रत्यय पढ़ें। स्कैनर उन कुंजियों में से एक भेजे तो टेस्टर ENTER, TAB, या कोई नहीं बताता है।
टेस्टर वे कीबोर्ड इवेंट दर्ज करता है जिन्हें ब्राउज़र देख सकता है। वह USB डिवाइस नहीं पहचानता, सीरियल पोर्ट नहीं पढ़ता, और QR छवि डिकोड नहीं करता।
QR स्कैनर के इनपुट मोड
वही छपा QR कोड तीन अलग एकीकरण से आ सकता है। एक मोड का परीक्षण बाकी मोड नहीं चलाता।
कीबोर्ड-वेज QR स्कैनर
USB HID कीबोर्ड मोड में, या Bluetooth HID कीबोर्ड मोड में, ऑपरेटिंग सिस्टम स्कैनर को कीबोर्ड मानता है। डिकोड के बाद स्कैनर पेलोड उस नियंत्रण में टाइप करता है जिसके पास फ़ोकस है। सामान्य <input> या <textarea> उसे पा सकता है। पेज डिवाइस नहीं खोलता। HID कीबोर्ड वेज की व्याख्या कीस्ट्रोक क्रम, उपसर्ग और प्रत्यय बताती है।
फ़ोकस गंतव्य तय करता है। अगर फ़ोकस वाला तत्व दस्तावेज़ का body, कोई बटन, या दूसरा फ़्रेम है, तो इस फ़ील्ड के श्रोता स्कैन नहीं देखते।
सीरियल QR स्कैनर
USB सीरियल या आभासी COM पोर्ट वाला स्कैनर डिकोड किया पाठ बाइट की तरह उस प्रक्रिया को भेजता है जिसने पोर्ट खोला। फ़ोकस उस प्रक्रिया को नहीं चुनता। केवल कीस्ट्रोक सुनने वाला फ़ील्ड खाली रहता है, जबकि उस पोर्ट का टर्मिनल पेलोड दिखाता है।
Chromium-आधारित ब्राउज़र सुरक्षित संदर्भ में, उपयोगकर्ता के इशारे के बाद, उपयोगकर्ता द्वारा चुना पोर्ट Web Serial API से खोल सकते हैं। Firefox और Safari वह API नहीं देते। वेज स्कैनर सीरियल पोर्ट के रूप में नहीं दिखता। पोर्ट के नाम, baud और फ़्रेमिंग डिवाइस और ड्राइवर पर निर्भर करते हैं। USB HID बनाम सीरियल बारकोड स्कैनर दोनों इंटरफ़ेस की तुलना करता है। बारकोड इनपुट टेस्टर COM पोर्ट नहीं पढ़ सकता।
कैमरा-आधारित QR स्कैनिंग
कैमरा एकीकरण छवि लेता है और सॉफ़्टवेयर में QR कोड डिकोड करता है। पेज कैमरा API और डिकोडर इस्तेमाल करता है। उसे पेलोड के लिए keydown इवेंट नहीं मिलते। फ़ोन-कैमरा ऐप, पेज के अंदर कैमरा बटन, और फ़ील्ड में टाइप करने वाला हार्डवेयर इमेजर तीन अलग उत्पाद हैं। वेज परीक्षण पास होने का यह मतलब नहीं कि कैमरा बटन काम करता है, और सफल कैमरा डिकोड का यह मतलब नहीं कि वेज स्कैनर वही स्ट्रिंग टाइप करेगा।
JavaScript से QR स्कैनर इनपुट कैप्चर करें
नीचे का पेज एक फ़ोकस वाला फ़ील्ड पढ़ता है। Enter फ़ॉर्म सबमिट करता है, और Accept बटन वही सबमिट हैंडलर इस्तेमाल करता है, इसलिए एक स्कैन एक बार संसाधित होता है। ENTER प्रत्यय के बिना पाठ फ़ील्ड में तब तक रहता है जब तक कोई Accept सक्रिय न करे। कैप्चर किया पेलोड textContent से लिखा जाता है, इसलिए < जैसे अक्षर पाठ की तरह दिखते रहते हैं।
उदाहरण तीन ऐप्लिकेशन प्रारूप स्वीकार करता है: QR-INPUT-TEST-12345 जैसा टिकट आईडी, http या https URL, या JSON ऑब्जेक्ट। यह स्कैन किया पाठ दर्ज करता है। QR कोड में मिले URL पर नहीं जाता। जो स्कैनर 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 इवेंट में संभालें। Enter के लिए दूसरा keydown श्रोता उसी स्कैन को दो बार दर्ज कर देता है। 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 वर्तमान ब्राउज़र में एक-पंक्ति पाठ फ़ील्ड का फ़ॉर्म सबमिट करता है। जब एक स्कैन को मान कमिट करना चाहिए, इसका उपयोग करें। पेज अपनी जगह रहना चाहिए तो submit पर preventDefault() कॉल करें।
TAB फ़ोकस अगले नियंत्रण पर ले जाता है। फ़ील्ड के पास अभी फ़ोकस हो तब keydown में मान पढ़ें। अगला फ़ील्ड फ़ोकस पाना चाहिए तो डिफ़ॉल्ट क्रिया रहने दें। Shift+Tab अनदेखा करें ताकि कीबोर्ड उपयोगकर्ता पीछे जा सके।
कोई प्रत्यय नहीं पेलोड को फ़ील्ड में छोड़ता है। उदाहरण में Accept बटन समाप्ति पथ है। निष्क्रियता टाइमर अनुमान लगा सकता है कि विराम का मतलब स्कैन खत्म हुआ। वह टाइमर अनुमान है: धीमा Bluetooth बर्स्ट और तेज़ टाइपिस्ट दोनों वही अंतर पार कर सकते हैं। जब वर्कफ़्लो को सख्त अंत चाहिए, कॉन्फ़िगर किया प्रत्यय बेहतर है।
CR और LF बाइट हैं। कीबोर्ड Enter event.key === "Enter" है। ये आपस में बदले नहीं जा सकते। जो श्रोता केवल इनपुट मान से \r हटाता है, वह वेज Enter नहीं देखेगा, क्योंकि वह अक्षर कभी डाला ही नहीं गया। जो श्रोता केवल event.key देखता है, वह सीरियल बफ़र को 0x0D पर नहीं काटेगा। कुछ डिवाइस NumPad 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 अपडेट आते हैं, फिर Enter या Tab का अंतिम keydown जब वह प्रत्यय कॉन्फ़िगर हो। change तब चलता है जब फ़ील्ड कमिट करता है, आमतौर पर blur पर। जो स्कैन फ़ोकस उसी फ़ील्ड में छोड़ता है, अंत में 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 | सटीक मान मिला |
| URL QR | पूरा URL कैप्चर हुआ, और पेज उस पर नहीं जाता |
| अंकीय QR | अंक सुरक्षित रहे |
| विशेष अक्षर | सही अक्षर मिले |
| JSON पेलोड | डेटा कैप्चर और सत्यापित हुआ |
| ENTER प्रत्यय | संसाधन एक बार होता है |
| TAB प्रत्यय | फ़ोकस व्यवहार संभला गया |
| कोई प्रत्यय नहीं | ऐप्लिकेशन वैकल्पिक समाप्ति तंत्र इस्तेमाल करता है |
| दोहरा स्कैन | ऐप्लिकेशन दोहराव-संभाल नियम लागू करता है |
| अमान्य पेलोड | सत्यापन त्रुटि दिखाई |
| गायब फ़ोकस | ऐप्लिकेशन अनुपस्थित इनपुट को सुरक्षित संभालता है |
| लंबा पेलोड | अनचाहा कटान नहीं |
अगर उत्पाद को नई पंक्ति सहेजनी हो तो ऐसा पेलोड भी स्कैन करें जिसमें नई पंक्ति हो। दर्ज करें कि फ़ील्ड को हर पंक्ति मिली या नहीं।
समस्या निवारण
इनपुट टेस्टर में ज्ञात पेलोड से शुरू करें। अगर टेस्टर का मान पहले से गलत है, पेज पहली गलती नहीं है। अगर टेस्टर का मान सही है और ऐप्लिकेशन गलत है, गलती फ़ोकस, सत्यापन, या इवेंट हैंडलिंग में है। बारकोड स्कैनर काम नहीं कर रहा व्यापक डिवाइस चेकलिस्ट है। बारकोड स्कैनर इनपुट कैसे परखें इस फ़ॉर्म से आगे फ़ोकस, लेआउट और POS वर्कफ़्लो कवर करता है।
स्कैनर बीप करता है लेकिन इनपुट नहीं दिखता
बीप का आमतौर पर मतलब है कि स्कैनर ने प्रतीक डिकोड किया। इसका मतलब नहीं कि पेज को पाठ मिला। कीबोर्ड-वेज मोड की पुष्टि करें। सीरियल और कैमरा मोड फ़ील्ड में टाइप नहीं करेंगे। फ़ील्ड पर क्लिक करें ताकि document.activeElement वह इनपुट हो, फिर स्कैन करें। अक्षम, केवल-पढ़ने योग्य, या छिपा फ़ील्ड कुंजियाँ अनदेखा कर सकता है।
QR स्कैनर Notepad में चलता है, ब्राउज़र में नहीं
डिवाइस टाइप कर रहा है। पेज उन कुंजियों को स्वीकार नहीं कर रहा। फ़ोकस, छापने योग्य कुंजियों पर preventDefault() कॉल करने वाला keydown श्रोता, और केवल paste संभालने वाला श्रोता जाँचें। वेज इनपुट पेस्ट इवेंट नहीं चलाता। टेस्टर परिणाम की तुलना ऐप्लिकेशन फ़ील्ड से करें।
स्कैनर बारकोड पढ़ता है, QR कोड नहीं
डिवाइस केवल 1D हो सकता है, या 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 इमेजर है। डिस्प्ले की चमक बढ़ाएँ, कोड का आकार बढ़ाएँ, और शांत क्षेत्र को पाठ और बॉर्डर से साफ़ रखें। चमक, धुंधली फ़ोन स्क्रीन, और कार्य दूरी के लिए बहुत घना कोड ऑप्टिकल समस्याएँ हैं। अगर स्क्रीन पढ़ना असफल रहता है तो वही पेलोड छापें। कोई भी स्कैन पाठ बना दे तो ऐप्लिकेशन परीक्षण फिर भी ज्ञात स्ट्रिंग इस्तेमाल करता है।