কন্টেন্টে যান

Barcode Scanner Emulator

ওয়েব অ্যাপ্লিকেশনে QR কোড স্ক্যানার ইনপুট কীভাবে পরীক্ষা করবেন

অনেক বাহ্যিক QR-সক্ষম স্ক্যানার কীবোর্ড-ওয়েজ মোড ব্যবহার করে এবং ডিকোড করা QR টেক্সট ফোকাস থাকা ফিল্ডে টাইপ করে। একটি জানা পেলোড স্ক্যান করে পৃষ্ঠা যে মান পেয়েছে তার সঙ্গে তুলনা করে সেই পথ পরীক্ষা করুন। প্রতিটি QR স্ক্যানার কীবোর্ডের মতো টাইপ করে না। সিরিয়াল ডিভাইস ও ক্যামেরা ডিকোডার আলাদা ইন্টিগ্রেশন, এবং ব্রাউজারের কীবোর্ড ইভেন্ট ভৌত স্ক্যানার শনাক্ত করে না।

একটি QR কোড ডেটা রাখে। স্ক্যানার, বা একটি ক্যামেরা ডিকোডার, সেই ডেটাকে টেক্সট করে। ওয়েব অ্যাপ্লিকেশনকে তারপর সেই টেক্সট পেতে হয়, স্ক্যান কখন শেষ তা ঠিক করতে হয়, এবং তা যাচাই করতে হয়। এই গাইড সেই অ্যাপ্লিকেশন পরীক্ষা। লেবেল তৈরি, কনট্রাস্ট যাচাই, এবং একটি ডিভাইস QR Code ডিকোড করতে পারে কি না, তা QR কোড পরীক্ষা: QR কোড স্ক্যানার কীভাবে পরীক্ষা করবেন-এ আছে। EAN চেক ডিজিটসহ সাধারণ বারকোড ফর্ম ওয়েব অ্যাপ্লিকেশনে বারকোড স্ক্যানার কীভাবে পরীক্ষা করবেন-এ আছে।

60 সেকেন্ডে QR স্ক্যানার ইনপুট পরীক্ষা

এমন একটি পেলোড ব্যবহার করুন যা আপনি বেছেছেন, যাতে ভুল অক্ষর স্পষ্ট হয়। এই ধাপগুলো QR-INPUT-TEST-12345 ব্যবহার করে।

  1. QR কোড জেনারেটর খুলুন এবং QR-INPUT-TEST-12345-এর জন্য একটি QR কোড তৈরি করুন। জেনারেটর ব্রাউজারে চলে। এটি স্ক্যানারের সঙ্গে যোগাযোগ করে না।
  2. কীবোর্ড-ওয়েজ মোডে সেট একটি QR-সক্ষম স্ক্যানার সংযোগ করুন। শুধু 1D স্ক্যানার এই প্রতীক ডিকোড করতে পারে না।
  3. বারকোড ইনপুট টেস্টার খুলুন।
  4. পরীক্ষা শুরু ক্লিক করুন, বা স্ক্যান এলাকায় ক্লিক করুন, যাতে ফিল্ডে ফোকাস থাকে। টেস্টার নিজে থেকে ফোকাস নেয় না, এবং স্ক্যানার খোলে না।
  5. QR কোড স্ক্যান করুন।
  6. ক্যাপচার করা টেক্সট ও অক্ষরের সংখ্যা পড়ুন।
  7. সেই টেক্সট QR-INPUT-TEST-12345-এর সঙ্গে তুলনা করুন। মিলের মধ্যে বড়-ছোট হাতের অক্ষর, হাইফেন ও দৈর্ঘ্য আছে।
  8. সাফিক্স পড়ুন। স্ক্যানার সেই কীগুলোর একটি পাঠালে টেস্টার 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 ইমেজার। ডিসপ্লের উজ্জ্বলতা বাড়ান, কোডের আকার বাড়ান, এবং কোয়ায়েট জোন টেক্সট ও বর্ডার থেকে খালি রাখুন। ঝলক, অনুজ্জ্বল ফোন স্ক্রিন, এবং কাজের দূরত্বের জন্য খুব ঘন কোড অপটিক্যাল সমস্যা। স্ক্রিন পড়া ব্যর্থ থাকলে একই পেলোড ছাপুন। যেকোনো স্ক্যান টেক্সট তৈরি করলে অ্যাপ্লিকেশন পরীক্ষা তবু জানা স্ট্রিং ব্যবহার করে।