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 বদলালেও এটি একই থাকতে পারে। কোনো প্রপার্টিই হার্ডওয়্যার শনাক্ত করে না।
ব্রাউজারে আসল বারকোড স্ক্যানার কীভাবে পরীক্ষা করবেন
অ্যাপ্লিকেশনের কোড ডিবাগ করার আগে এটি চালান। এতে ব্রাউজার যে সঠিক স্ট্রিং ও টার্মিনেটর পেয়েছে তা দেখা যায়।
- স্ক্যানার সংযোগ করুন এবং বিদ্যুৎ আছে দেখানো পর্যন্ত অপেক্ষা করুন। 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-ও ধরে। 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 ইভেন্টের টার্গেট থেকে মান পড়ুন।
সাফিক্স নেই
সাফিক্স না থাকলে পেলোড ফিল্ডে বসে থাকে। স্ক্যান কখন শেষ অ্যাপ্লিকেশনকে ঠিক করতে হয়। একটি স্পষ্ট বাটন, অপারেটরের পরের 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 সাফিক্স বেছে নেন। একটি গ্লোবাল শর্টকাট সেই টেক্সট ফোকাস থাকা অ্যাপ্লিকেশনে টাইপ করে। এটি ওয়েজ স্ক্যানার যে কীবোর্ড পথ ব্যবহার করে তা পুনরায় তৈরি করে। এটি লেবেল আলোকিত করে না, প্রতীক পড়ে না, বা সিম্বোলজি ডিকোড করে না।
উপরের উদাহরণ পৃষ্ঠা, বা আপনি যে পৃষ্ঠা বানাচ্ছেন, ব্যবহার করুন:
- একটি ডেস্কটপ ব্রাউজারে পৃষ্ঠা খুলুন এবং বারকোড ফিল্ডে ক্লিক করুন।
- এমুলেটরে
123456789012-এর মতো একটি জানা মান লিখুন। - সাফিক্স ENTER সেট করুন। বিস্ফোরণটি আপনি আগে মেপেছেন এমন স্ক্যানারের মতো চাইলে টাইপিং বিলম্ব সেট করুন।
- ব্রাউজার ফিল্ডে এখনও ফোকাস থাকাকালীন এমুলেটরের গ্লোবাল স্ক্যান শর্টকাট চাপুন।
- স্ট্যাটাস টেক্সট নিশ্চিত করুন এবং মান একবার নেওয়া হয়েছে।
- TAB দিয়ে আবার করুন। ফোকাস সরবে, এবং মান একবার নেওয়া হবে।
- সাফিক্স ছাড়া আবার করুন। আপনি Look up না চালানো পর্যন্ত টেক্সট ফিল্ডে থাকবে।
- বারকোড ইনপুট টেস্টার ফোকাস করুন এবং একই মান আবার পাঠান। ক্যাপচার করা স্ট্রিং, প্রিফিক্স ও সাফিক্স অ্যাপ্লিকেশন যা রেখেছে তার সঙ্গে তুলনা করুন।
ইনস্টলেশন ও প্রথম শর্টকাট শুরু করা-তে আছে। একটি সেটিং বদলের পর, অ্যাপ্লিকেশনের ফলাফল বিশ্বাস করার আগে ইনপুট টেস্টারে একটি স্ক্যান পাঠান।
পরীক্ষার আলোক ও ডিভাইস-নির্দিষ্ট অংশের জন্য হার্ডওয়্যার এখনও দরকার:
- সেই স্ক্যানার ছাপানো বা দেখানো প্রতীক ডিকোড করতে পারে কি না, ক্ষতিগ্রস্ত লেবেল, আকার, কনট্রাস্ট ও দূরত্বসহ।
- সিম্বোলজি সমর্থন। একটি 1D লেজার স্ক্যানার QR কোড পড়তে পারে না। দেখুন QR কোড পরীক্ষা: QR কোড স্ক্যানার কীভাবে পরীক্ষা করবেন।
- USB এনুমারেশন, Bluetooth পেয়ার করা, এবং স্ক্যানারের নিজের কীবোর্ড লেআউট ও সাফিক্স কনফিগারেশন।
- সিরিয়াল, HID POS, ও ভেন্ডর SDK ইন্টিগ্রেশন।
এমুলেটর কীবোর্ড পথ ধরে অ্যাপ্লিকেশন লজিকের জন্য সঠিক টুল। একটি নির্দিষ্ট স্ক্যানার একটি নির্দিষ্ট লেবেল পড়ে তা প্রমাণের জন্য এটি ভুল টুল।
বারকোড স্ক্যানারের কীবোর্ড ইভেন্ট ডিবাগ করা
রাখা মান ভুল হলে এই ক্রমে ইভেন্ট দেখুন।
keydown। ব্রাউজার অক্ষর ঢোকানোর বা ফোকাস সরানোর আগে প্রতিটি কী-এর জন্য, Enter ও Tabসহ, ফায়ার করে। টার্মিনেটর এখানে পড়ুন। একটি কী চেপে ধরা থাকলে event.repeat সত্য। একটি ওয়েজ স্ক্যানার সাধারণত প্রতিটি অক্ষরের জন্য আলাদা চাপ পাঠায়।
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, ও আবার সংযোগের সারি হার্ডওয়্যারে চালান। সেই সারি ডিভাইস, লেবেল, বা অপারেটিং সিস্টেম লেআউটের উপর নির্ভর করে, যা অনুকৃত কীস্ট্রোক পুনরায় তৈরি করে না।