Barcode Scanner Emulator
วิธีทดสอบเครื่องสแกนบาร์โค้ดในเว็บแอปพลิเคชัน
เครื่องสแกนบาร์โค้ด USB และ Bluetooth จำนวนมากส่งข้อมูลที่ถอดรหัสแล้วเป็นการกดแป้น ดังนั้นช่องที่มีโฟกัสในเว็บแอปพลิเคชันจึงรับการสแกนได้โดยไม่ต้องมี API ของเบราว์เซอร์เฉพาะเครื่องสแกน พอร์ตอนุกรมและ SDK ของผู้ผลิตเป็นการเชื่อมต่อคนละแบบ คุณทดสอบเส้นทางแป้นพิมพ์ได้ด้วยเครื่องสแกนจริง หรือด้วยการกดแป้นจำลอง
เว็บแอปพลิเคชันมักเห็นเครื่องสแกนบาร์โค้ดเป็นแป้นพิมพ์ สิ่งที่ต้องทดสอบคือตัวควบคุมที่มีโฟกัสได้รับเพย์โหลดที่แอปพลิเคชันคาดไว้หรือไม่ และหน้าเว็บจัดการตัวปิดท้ายที่เครื่องสแกนตั้งค่าให้ส่งหรือไม่ ตัวปิดท้ายนั้นอาจเป็น Enter, Tab หรือไม่มีอะไรเลย
ใช้เซสชัน ตัวทดสอบอินพุตบาร์โค้ด เมื่อต่อเครื่องสแกนจริงอยู่ ใช้ Barcode Scanner Emulator เมื่อต้องการเส้นทางแป้นพิมพ์เดียวกันระหว่างพัฒนา และฮาร์ดแวร์ไม่อยู่บนโต๊ะ การตรวจที่กว้างกว่าเรื่องโฟกัส ผังแป้นพิมพ์ และเวิร์กโฟลว์ POS อยู่ใน วิธีทดสอบอินพุตจากเครื่องสแกนบาร์โค้ด คู่มือนี้อยู่ที่แอปพลิเคชันบนเบราว์เซอร์: การจับค่า ส่วนต่อท้าย การตรวจสอบ และเหตุการณ์ที่สังเกตได้จริง
เครื่องสแกนบาร์โค้ดสื่อสารกับเว็บแอปพลิเคชันอย่างไร
โหมดอินเทอร์เฟซเป็นตัวกำหนดว่าหน้าเว็บรับอะไรได้ ยืนยันโหมดก่อนแก้โค้ดของฟอร์ม เครื่องสแกนมักสลับโหมดได้ด้วยการสแกนบาร์โค้ดตั้งค่าจากคู่มือของผู้ผลิต
แป้นพิมพ์ลิ่ม USB HID
ในโหมดแป้นพิมพ์ USB HID เครื่องสแกนแจ้งตัวเองเป็นแป้นพิมพ์ ระบบปฏิบัติการโหลดไดรเวอร์แป้นพิมพ์ปกติ หลังจากเครื่องสแกนถอดรหัสสัญลักษณ์แล้ว จะส่งอักขระเป็นการกดแป้นไปยังตัวควบคุมที่มีโฟกัสแป้นพิมพ์ หน้าเว็บฟังการกดแป้นเหล่านั้น หรืออ่านข้อความที่ถูกแทรก หน้าเว็บไม่เปิดการเชื่อมต่อไปยังอุปกรณ์
เส้นทางนี้เป็นเหตุให้ช่องคิดเงิน ช่องค้นหา หรือช่องข้อความอื่นรับการสแกนด้วย HTML ธรรมดาได้ รายละเอียดลำดับการกดแป้น คำนำหน้า และส่วนต่อท้ายอยู่ใน คำอธิบาย HID keyboard wedge
Bluetooth HID
เครื่องสแกน Bluetooth ที่จับคู่เป็นแป้นพิมพ์ใช้เส้นทางแอปพลิเคชันเดียวกัน โฮสต์ถือว่าเป็นแป้นพิมพ์ HID และช่องที่มีโฟกัสได้รับการกดแป้น การจับคู่ แบตเตอรี่ และวิทยุเป็นเรื่องของอุปกรณ์ เมื่ออักขระถึงเบราว์เซอร์แล้ว หน้าเว็บจัดการเหมือนอินพุตแบบลิ่ม USB
พอร์ตอนุกรมและพอร์ต COM เสมือน
เครื่องสแกนอนุกรม รวมถึงโหมดพอร์ต COM เสมือนผ่าน USB จำนวนมาก ส่งข้อความที่ถอดรหัสแล้วเป็นไบต์บนพอร์ต โฟกัสไม่ได้เลือกปลายทาง กระบวนการที่เปิดพอร์ตเป็นผู้เลือก ช่องข้อความที่ฟังแต่การกดแป้นจะไม่เห็นกระแสข้อมูลนั้น
เบราว์เซอร์ที่อิง Chromium เปิดพอร์ตอนุกรมผ่าน Web Serial API ได้ หลังจากผู้ใช้เลือกพอร์ตและให้สิทธิ์ Firefox และ Safari ไม่มี API นี้ การทดสอบแบบลิ่มไม่ได้ลองการเชื่อมต่ออนุกรม และการทดสอบอนุกรมก็ไม่ได้บอกว่าเครื่องสแกนแบบลิ่มจะพิมพ์อะไร
อินเทอร์เฟซเฉพาะผู้ผลิต
อุปกรณ์บางรุ่นใช้ SDK ของผู้ผลิต, OPOS, JPOS หรืออินเทอร์เฟซ HID ที่ไม่ใช่แป้นพิมพ์ เช่น USB HID POS อินเทอร์เฟซเหล่านี้ไม่พิมพ์ลงในช่องที่มีโฟกัส หน้าเว็บปกติโหลด SDK แบบเนทีฟไม่ได้ Chromium ขออุปกรณ์ HID ที่ไม่ใช่แป้นพิมพ์บางชนิดผ่าน WebHID ได้หลังท่าทางของผู้ใช้ อุปกรณ์ 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 เป็น body ของเอกสาร ปุ่ม หรือช่องอื่น ตัวฟังของช่องนี้จะไม่เห็นการสแกน อักขระจะลงในตัวควบคุมที่มีโฟกัส หรือหายไป เรียก field.focus() เมื่อเวิร์กโฟลว์พร้อมรับการสแกน รวมถึงหลังจากกล่องโต้ตอบปิด
อินพุตว่างจะถูกข้าม ฟอร์มอยู่กับที่ และข้อความสถานะบอกว่าไม่ได้รับอะไร ช่องว่างล้วนว่างหลัง trim()
ตัวอย่างนี้ไม่เติม Enter หรือ Tab ถ้าเครื่องสแกนไม่ได้ตั้งให้ส่งสองอย่างนั้น ค่าจะค้างในช่อง และ Look up คือเส้นทางทำให้เสร็จ autocomplete="off" ลดโอกาสที่ค่าที่บันทึกไว้จะแทนที่การสแกน ป้าย ปุ่ม และ Shift+Tab ยังใช้ได้ ดังนั้นคนจึงป้อนรหัสได้โดยไม่มีเครื่องสแกน
จัดการ Enter ที่จุดเดียว ตัวอย่างนี้ใช้เหตุการณ์ submit ของฟอร์ม ซึ่งครอบคลุมปุ่ม Look up และ Enter จากแป้นพิมพ์ด้วย ตัวฟัง keydown ตัวที่สองสำหรับ Enter จะบันทึกการสแกนเดียวกันสองครั้ง ถ้าช่องไม่อยู่ในฟอร์ม ให้ฟัง Enter ที่ keydown และเรียก 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 ในช่องข้อความบรรทัดเดียวจะส่งฟอร์มที่ล้อมอยู่บนเบราว์เซอร์ปัจจุบัน ใช้เมื่อการสแกนครั้งเดียวควรยืนยันค่า เช่น ช่องค้นหา preventDefault() ที่เหตุการณ์ submit หยุดไม่ให้เบราว์เซอร์ออกจากหน้า ละไว้เมื่อการนำทางทั้งหน้าคือพฤติกรรมที่ต้องการ
ถ้าบาร์โค้ดปรากฏแต่ฟอร์มไม่ทำอะไร เครื่องสแกนอาจไม่ได้ส่งส่วนต่อท้าย เครื่องสแกนบาร์โค้ดไม่มี ENTER อธิบายการตั้งค่านั้นเป็นขั้น อุปกรณ์บางรุ่นส่ง NumPad Enter event.key ยังคงเป็น "Enter" ตรวจ event.key อย่าดูเพียง event.code === "Enter" มิฉะนั้นเครื่องสแกนนั้นจะดูเหมือนเสีย
TAB
Tab ย้ายโฟกัสไปตัวควบคุมถัดไปที่โฟกัสได้ เหมาะกับลำดับเช่นรหัสสินค้า แล้วจำนวน ทำให้ฟอร์มที่คาดว่า Enter จะส่งนั้นประหลาดใจ
อ่านค่าใน keydown ขณะช่องยังมีโฟกัส เบราว์เซอร์ย้ายโฟกัสหลังเหตุการณ์นั้น ปล่อยการกระทำเริ่มต้นไว้เมื่อตัวควบคุมถัดไปควรได้โฟกัส preventDefault() คงโฟกัสไว้ที่เดิม ซึ่งมีประโยชน์เมื่อค่าไม่ถูกต้องและต้องการให้ผู้ปฏิบัติงานเห็น ข้าม Shift+Tab เพื่อให้ผู้ใช้แป้นพิมพ์ถอยกลับในฟอร์มได้ ส่วนต่อท้าย Tab ของเครื่องสแกนคือ Tab ที่ไม่มี Shift
ส่วนต่อท้าย Tab ยังย้ายโฟกัสก่อนที่โค้ดจะอ่านช่องได้ ถ้าตัวฟังอยู่ที่ blur หรือ change และสิ่งอื่นล้างตัวควบคุม อ่านค่าจาก target ของเหตุการณ์ 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 ตัดที่ขอบเขตตอนแยกกระแสอนุกรม และทดสอบว่าคุณไม่ได้ตัดออกจากกลางเพย์โหลดที่มีอักขระนั้นอย่างถูกต้อง
การส่งซ้ำ การสแกนครั้งเดียวอาจถูกจัดการสองครั้งถ้าทั้ง keydown และ submit ทำงานกับ Enter เดียวกัน ใช้เส้นทางทำให้เสร็จเส้นทางเดียว การสแกนรหัสเดิมอีกครั้งเป็นคนละเรื่อง ฟอร์มคลังสินค้าอาจเพิ่มจำนวน ฟอร์มตั๋วอาจปฏิเสธรหัสที่แลกไปแล้ว ใส่กฎนั้นในแอปพลิเคชัน และทดสอบอย่างตั้งใจ เบราว์เซอร์แยกการเหนี่ยวไกครั้งที่สองออกจากตัวฟังตัวที่สองไม่ได้
กฎของแอปพลิเคชัน เช็กซัมเป็นของซิมโบโลยีเฉพาะ 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 เป็น 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 ดิบ
ปัญหาที่พบบ่อยในเว็บแอปพลิเคชัน
การสแกนไปตกช่องผิด อินพุตแบบลิ่มตามโฟกัส คลิกช่องเป้าหมายหลังทุกการนำทาง กล่องโต้ตอบ หรือข้อความตรวจสอบที่ย้ายโฟกัส โมดัลที่ไม่มีช่องข้อความอาจกลืนการสแกนเป็นแป้นลัด
เครื่องสแกนใช้ได้ในตัวแก้ไขข้อความแต่ใช้ไม่ได้ในเบราว์เซอร์ อุปกรณ์กำลังพิมพ์ หน้าเว็บไม่รับแป้นเหล่านั้น ตรวจโฟกัส ช่องที่ปิดใช้งานหรืออ่านอย่างเดียว และตัวฟัง keydown ที่เรียก preventDefault() บนแป้นที่พิมพ์ได้ ตัวฟังที่จัดการแต่ 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 และการเชื่อมต่อใหม่บนฮาร์ดแวร์ แถวเหล่านั้นขึ้นกับอุปกรณ์ ฉลาก หรือผังของระบบปฏิบัติการ ซึ่งการกดแป้นจำลองไม่ได้สร้างขึ้นมาใหม่