सामग्री पर जाएँ

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 पोर्ट

सीरियल स्कैनर, कई USB आभासी COM पोर्ट मोड सहित, डिकोड किया पाठ पोर्ट पर बाइट की तरह भेजता है। गंतव्य फ़ोकस नहीं चुनता। पोर्ट खोलने वाली प्रक्रिया चुनती है। केवल कीस्ट्रोक सुनने वाला पाठ फ़ील्ड वह धारा नहीं देखेगा।

Chromium-आधारित ब्राउज़र उपयोगकर्ता के पोर्ट चुनने और अनुमति देने के बाद Web Serial API से सीरियल पोर्ट खोल सकते हैं। Firefox और Safari वह API नहीं देते। वेज परीक्षण सीरियल एकीकरण नहीं चलाता, और सीरियल परीक्षण यह नहीं बताता कि वेज स्कैनर क्या टाइप करेगा।

वेंडर-विशेष इंटरफ़ेस

कुछ डिवाइस वेंडर SDK, OPOS, JPOS, या USB HID POS जैसे गैर-कीबोर्ड HID इंटरफ़ेस इस्तेमाल करते हैं। वे इंटरफ़ेस फ़ोकस वाले फ़ील्ड में टाइप नहीं करते। सामान्य वेब पेज नेटिव SDK लोड नहीं कर सकता। Chromium उपयोगकर्ता के इशारे के बाद WebHID से कुछ गैर-कीबोर्ड HID डिवाइस माँग सकता है। कीबोर्ड-श्रेणी HID डिवाइस अवरुद्ध रहते हैं, इसलिए वेज स्कैनर कीबोर्ड से अलग नहीं पहचाना जा सकता। वेंडर इंटरफ़ेस को अपना एकीकरण मानें और उसे उस सॉफ़्टवेयर से परखें जो सच में वह इंटरफ़ेस खोलता है।

ब्राउज़र क्या देख सकता है

वेज स्कैन keydown और keyup इवेंट की तरह आता है, और छापने योग्य अक्षर फ़ोकस वाले फ़ील्ड को बदलते हैं। ब्राउज़र को डिवाइस नाम, USB सीरियल नंबर, या यह बताने वाला झंडा नहीं मिलता कि यह स्कैनर है। WebHID लागू करने वाले ब्राउज़र भी कीबोर्ड इंटरफ़ेस ठुकराते हैं, इसलिए पेज स्क्रिप्ट वेज स्कैनर की कच्ची HID रिपोर्ट भी नहीं पढ़ सकती।

event.key वह अक्षर या कुंजी-नाम है जो ऑपरेटिंग सिस्टम सक्रिय कीबोर्ड लेआउट लगाने के बाद बताता है। event.code भौतिक कुंजी का नाम है, जैसे Digit1 या Numpad1, और लेआउट बेमेल event.key बदल दे तब भी वही रह सकता है। दोनों गुण हार्डवेयर नहीं पहचानते।

ब्राउज़र में भौतिक बारकोड स्कैनर कैसे परखें

ऐप्लिकेशन कोड डिबग करने से पहले यह चलाएँ। इससे वह सटीक स्ट्रिंग और समापक दिखता है जो ब्राउज़र को मिला।

  1. स्कैनर जोड़ें और तब तक रुकें जब तक वह बिजली दिखाए। Bluetooth के लिए पेयरिंग पूरी करें और पुष्टि करें कि होस्ट कीबोर्ड प्रोफ़ाइल इस्तेमाल कर रहा है।
  2. इनपुट मोड की पुष्टि करें। कीबोर्ड वेज, USB HID कीबोर्ड, या Bluetooth HID कीबोर्ड फ़ील्ड में टाइप कर सकते हैं। सीरियल, SPP और वेंडर-SDK मोड नहीं कर सकते।
  3. बारकोड इनपुट टेस्टर खोलें।
  4. परीक्षण शुरू करें पर क्लिक करें, या स्कैन क्षेत्र पर क्लिक करें। तैयार होने पर वह नीला हो जाता है। पेज अपने आप फ़ोकस नहीं लेता।
  5. ऐसा बारकोड स्कैन करें जिसका पेलोड आपको पहले से पता हो। छोटे अंकों से शुरू करें, फिर वह मान स्कैन करें जिसमें ऐप्लिकेशन द्वारा सहेजे जाने वाले विराम चिह्न हों।
  6. कैप्चर किया मान और अक्षर-संख्या पढ़ें। दोनों की तुलना अपेक्षित पेलोड से करें, जिसमें डेटा से पहले स्कैनर द्वारा डाला कोई उपसर्ग भी शामिल हो।
  7. प्रत्यय जाँचें। टेस्टर ENTER, TAB, या कोई नहीं बताता है। स्वतः कैप्चर चालू होने पर परिणाम Enter, Tab, या कुंजियाँ रुकने के बाद छोटे विराम पर दिखता है। जब कैप्चर तब तक रखना हो जब तक आप रोकें न दबाएँ, स्वतः कैप्चर बंद करें।
  8. उस परिणाम की तुलना उस स्ट्रिंग से करें जिसे ऐप्लिकेशन को सहेजना चाहिए। उपसर्ग, बदला अक्षर, या गायब समापक स्कैनर कॉन्फ़िगरेशन में ठीक करें, या पेज में जान-बूझकर संभालें। यह तुलना पूरी होने से पहले इसे डिकोड असफलता न मानें।

टेस्टर वे कीबोर्ड इवेंट दर्ज करता है जिन्हें ब्राउज़र देख सकता है। वह 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 दस्तावेज़ का body, कोई बटन, या दूसरा इनपुट है, तो इस फ़ील्ड के श्रोता स्कैन नहीं देखते। अक्षर फ़ोकस वाले नियंत्रण में पहुँचते हैं, या खो जाते हैं। जब वर्कफ़्लो स्कैन के लिए तैयार हो, संवाद बंद होने के बाद भी, field.focus() कॉल करें।

खाली इनपुट अनदेखा होता है। फ़ॉर्म अपनी जगह रहता है, और स्थिति पाठ कहता है कि कुछ नहीं मिला। केवल रिक्त स्थान trim() के बाद खाली है।

यह उदाहरण Enter या Tab नहीं जोड़ता। अगर स्कैनर उन्हें भेजने के लिए कॉन्फ़िगर नहीं है, मान फ़ील्ड में रहता है और Look up पूरा करने का पथ है। autocomplete="off" इस संभावना को घटाता है कि सहेजा मान स्कैन की जगह ले ले। लेबल, बटन और Shift+Tab उपलब्ध रहते हैं, इसलिए व्यक्ति स्कैनर के बिना कोड डाल सकता है।

Enter को एक जगह संभालें। यह उदाहरण फ़ॉर्म का submit इवेंट इस्तेमाल करता है, जो Look up बटन और कीबोर्ड Enter दोनों को कवर करता है। Enter के लिए दूसरा keydown श्रोता उसी स्कैन को दो बार दर्ज करेगा। अगर इनपुट फ़ॉर्म के अंदर नहीं है, keydown पर Enter सुनें और 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 घेरने वाले फ़ॉर्म को सबमिट करता है। जब एक स्कैन से मान तय होना चाहिए, जैसे लुकअप बॉक्स, तब इसका उपयोग करें। submit इवेंट पर preventDefault() ब्राउज़र को पेज छोड़ने से रोकता है। जब पूरा पेज नेविगेशन ही चाहा व्यवहार हो, इसे छोड़ दें।

अगर बारकोड दिखे और फ़ॉर्म कुछ न करे, स्कैनर शायद कोई प्रत्यय नहीं भेज रहा। बारकोड स्कैनर में ENTER नहीं है उस कॉन्फ़िगरेशन को क्रम से बताता है। कुछ डिवाइस NumPad Enter भेजते हैं। event.key तब भी "Enter" होता है। event.key जाँचें, केवल event.code === "Enter" न देखें, वरना वह स्कैनर टूटा लगेगा।

TAB

Tab फ़ोकस को अगले फ़ोकस-योग्य नियंत्रण पर ले जाता है। यह उत्पाद कोड, फिर मात्रा जैसे क्रम के लिए ठीक है। जो फ़ॉर्म Enter से सबमिट की उम्मीद करता हो, उसके लिए यह अप्रत्याशित है।

फ़ील्ड में अभी फ़ोकस हो तब keydown में मान पढ़ें। ब्राउज़र उस इवेंट के बाद फ़ोकस हिलाता है। जब अगले नियंत्रण को फ़ोकस मिलना चाहिए, डिफ़ॉल्ट क्रिया रहने दें। preventDefault() फ़ोकस को वहीं रखता है, जो तब उपयोगी है जब मान अमान्य हो और आप चाहते हैं कि ऑपरेटर उसे देखे। Shift+Tab को अनदेखा करें ताकि कीबोर्ड उपयोगकर्ता फ़ॉर्म में पीछे जा सके। स्कैनर का Tab प्रत्यय बिना Shift वाला Tab है।

अगर श्रोता blur या change पर है और कुछ और नियंत्रण खाली कर देता है, Tab प्रत्यय आपके कोड के फ़ील्ड पढ़ने से पहले फ़ोकस हिला सकता है। मान keydown इवेंट के target से पढ़ें।

कोई प्रत्यय नहीं

बिना प्रत्यय के पेलोड फ़ील्ड में बैठा रहता है। ऐप्लिकेशन को तय करना होता है कि स्कैन कब खत्म हुआ। स्पष्ट बटन, ऑपरेटर का बाद का 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 बाइट हो सकते हैं। उन्हें उस सीमा पर हटाएँ जहाँ आप सीरियल धारा पार्स करते हैं, और परखें कि आप उन्हें ऐसे पेलोड के बीच से नहीं हटा रहे जिसमें वे वैध रूप से हों।

दोहरी प्रस्तुति। एक स्कैन दो बार संभाला जा सकता है अगर एक ही Enter के लिए keydown और submit दोनों चलें। एक ही समाप्ति पथ रखें। उसी कोड का दूसरा स्कैन अलग प्रश्न है। गोदाम फ़ॉर्म मात्रा बढ़ा सकता है। टिकट फ़ॉर्म पहले भुनाए कोड को अस्वीकार कर सकता है। वह नियम ऐप्लिकेशन में रखें, और जान-बूझकर परखें। ब्राउज़र दूसरी ट्रिगर खींच को दूसरे श्रोता से अलग नहीं बता सकता।

ऐप्लिकेशन नियम। चेकसम विशेष सिम्बोलॉजी के होते हैं। 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 चुनते हैं। वैश्विक शॉर्टकट उस पाठ को फ़ोकस वाले ऐप्लिकेशन में टाइप करता है। यह उस कीबोर्ड पथ को दोहराता है जिसे वेज स्कैनर इस्तेमाल करता है। यह लेबल नहीं रोशन करता, प्रतीक नहीं पढ़ता, और सिम्बोलॉजी डिकोड नहीं करता।

ऊपर का उदाहरण पेज, या जो पेज आप बना रहे हैं, इस्तेमाल करें:

  1. पेज को डेस्कटॉप ब्राउज़र में खोलें और बारकोड फ़ील्ड पर क्लिक करें।
  2. एमुलेटर में ज्ञात मान डालें, जैसे 123456789012।
  3. प्रत्यय ENTER पर सेट करें। अगर यह तेज़ क्रम उस स्कैनर जैसा होना चाहिए जिसे आप पहले माप चुके हैं, तो टाइपिंग देरी सेट करें।
  4. जब ब्राउज़र फ़ील्ड पर अभी फ़ोकस हो, एमुलेटर का वैश्विक स्कैन शॉर्टकट दबाएँ।
  5. स्थिति पाठ की पुष्टि करें और यह कि मान एक बार स्वीकार हुआ।
  6. TAB के साथ दोहराएँ। फ़ोकस हिलना चाहिए, और मान एक बार स्वीकार होना चाहिए।
  7. बिना प्रत्यय के दोहराएँ। Look up सक्रिय करने तक पाठ फ़ील्ड में रहना चाहिए।
  8. बारकोड इनपुट टेस्टर पर फ़ोकस करें और वही मान फिर भेजें। कैप्चर की स्ट्रिंग, उपसर्ग और प्रत्यय की तुलना ऐप्लिकेशन द्वारा सहेजे मान से करें।

स्थापना और पहला शॉर्टकट शुरुआत में है। सेटिंग बदलने के बाद, ऐप्लिकेशन के परिणाम पर भरोसा करने से पहले इनपुट टेस्टर में एक स्कैन भेजें।

परीक्षण के प्रकाशीय और डिवाइस-विशेष हिस्सों के लिए हार्डवेयर अभी भी चाहिए:

  • क्या वह स्कैनर छपे या दिखाए प्रतीक को डिकोड कर सकता है, जिसमें क्षतिग्रस्त लेबल, आकार, कंट्रास्ट और दूरी शामिल हैं।
  • सिम्बोलॉजी समर्थन। 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 ट्रैफ़िक नहीं है।

वेब ऐप्लिकेशन में आम समस्याएँ

स्कैन गलत फ़ील्ड में जाता है। वेज इनपुट फ़ोकस का अनुसरण करता है। हर नेविगेशन, संवाद, या सत्यापन संदेश के बाद लक्ष्य फ़ील्ड पर क्लिक करें जो फ़ोकस हिलाता हो। बिना पाठ फ़ील्ड वाला मोडल स्कैन को शॉर्टकट कुंजियों की तरह निगल सकता है।

स्कैनर पाठ संपादक में चलता है और ब्राउज़र में नहीं। डिवाइस टाइप कर रहा है। पेज उन कुंजियों को स्वीकार नहीं कर रहा। फ़ोकस, अक्षम या केवल-पढ़ने योग्य इनपुट, और छापने योग्य कुंजियों पर preventDefault() कॉल करने वाले keydown श्रोता की जाँच करें। केवल 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 और फिर-जोड़ने वाली पंक्तियाँ हार्डवेयर पर चलाएँ। वे पंक्तियाँ डिवाइस, लेबल, या ऑपरेटिंग-सिस्टम लेआउट पर निर्भर हैं, जिन्हें नकली कीस्ट्रोक दोहराते नहीं।