ข้ามไปยังเนื้อหา

Barcode Scanner Emulator

วิธีทดสอบอินพุตเครื่องสแกนรหัส QR ในเว็บแอปพลิเคชัน

เครื่องสแกนภายนอกที่อ่าน QR ได้จำนวนมากใช้โหมดลิ่มแป้นพิมพ์ และพิมพ์ข้อความ QR ที่ถอดรหัสแล้วลงในช่องที่มีโฟกัส ทดสอบเส้นทางนั้นโดยสแกนเพย์โหลดที่รู้จัก แล้วเทียบกับค่าที่หน้าเว็บได้รับ ไม่ใช่เครื่องสแกน QR ทุกเครื่องที่จะพิมพ์เหมือนแป้นพิมพ์ อุปกรณ์อนุกรมและตัวถอดรหัสจากกล้องเป็นการเชื่อมต่อคนละแบบ และเหตุการณ์แป้นพิมพ์ของเบราว์เซอร์ไม่ระบุตัวเครื่องสแกนจริง

รหัส QR เก็บข้อมูล เครื่องสแกน หรือตัวถอดรหัสจากกล้อง เปลี่ยนข้อมูลนั้นเป็นข้อความ จากนั้นเว็บแอปพลิเคชันต้องรับข้อความนั้น ตัดสินว่าการสแกนจบเมื่อใด และตรวจสอบค่า คู่มือนี้คือการทดสอบแอปพลิเคชันนั้น การสร้างฉลาก การตรวจความเปรียบต่าง และการยืนยันว่าอุปกรณ์ถอดรหัส QR Code ได้ อยู่ใน การทดสอบรหัส QR: วิธีทดสอบเครื่องสแกน QR ฟอร์มบาร์โค้ดทั่วไป รวมหลักตรวจสอบ EAN อยู่ใน วิธีทดสอบเครื่องสแกนบาร์โค้ดในเว็บแอปพลิเคชัน

ทดสอบอินพุตเครื่องสแกน QR ใน 60 วินาที

ใช้เพย์โหลดที่คุณเลือกเอง เพื่อให้อักขระที่ผิดเห็นได้ชัด ขั้นตอนนี้ใช้ QR-INPUT-TEST-12345

  1. เปิด ตัวสร้างรหัส QR แล้วสร้างรหัส QR สำหรับ QR-INPUT-TEST-12345 ตัวสร้างทำงานในเบราว์เซอร์ ไม่ได้ติดต่อเครื่องสแกน
  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 keyboard wedge อธิบายลำดับการกดแป้น คำนำหน้า และส่วนต่อท้าย

โฟกัสเป็นตัวกำหนดปลายทาง ถ้าองค์ประกอบที่มีโฟกัสเป็น body ของเอกสาร ปุ่ม หรือเฟรมอื่น ตัวฟังของช่องนี้จะไม่เห็นการสแกน

เครื่องสแกนอนุกรมสำหรับ QR

เครื่องสแกนพอร์ตอนุกรม USB หรือพอร์ต COM เสมือนส่งข้อความที่ถอดรหัสแล้วเป็นไบต์ไปยังกระบวนการที่เปิดพอร์ต โฟกัสไม่ได้เลือกกระบวนการนั้น ช่องที่ฟังแต่การกดแป้นจะว่าง ขณะที่เทอร์มินัลบนพอร์ตนั้นแสดงเพย์โหลด

เบราว์เซอร์ที่อิง Chromium เปิดพอร์ตที่ผู้ใช้เลือกด้วย Web Serial API ได้ ในบริบทที่ปลอดภัย หลังจากท่าทางของผู้ใช้ Firefox และ Safari ไม่มี API นี้ เครื่องสแกนแบบลิ่มไม่ปรากฏเป็นพอร์ตอนุกรม ชื่อพอร์ต baud และการจัดเฟรมขึ้นกับอุปกรณ์และไดรเวอร์ เครื่องสแกนบาร์โค้ด USB HID กับแบบอนุกรม เทียบอินเทอร์เฟซทั้งสอง ตัวทดสอบอินพุตบาร์โค้ดอ่านพอร์ต COM ไม่ได้

การสแกน QR ด้วยกล้อง

การเชื่อมต่อกล้องจับภาพแล้วถอดรหัสรหัส QR ในซอฟต์แวร์ หน้าเว็บใช้ API ของกล้องและตัวถอดรหัส ไม่ได้รับเหตุการณ์ keydown ของเพย์โหลด แอปกล้องโทรศัพท์ ปุ่มกล้องในหน้า และหัวอ่านภาพฮาร์ดแวร์ที่พิมพ์ลงช่อง เป็นคนละผลิตภัณฑ์ การผ่านการทดสอบแบบลิ่มไม่ได้แปลว่าปุ่มกล้องทำงาน และการถอดรหัสด้วยกล้องสำเร็จไม่ได้แปลว่าเครื่องสแกนแบบลิ่มจะพิมพ์สตริงเดียวกัน

จับอินพุตเครื่องสแกน QR ด้วย JavaScript

หน้าด้านล่างอ่านช่องที่มีโฟกัสหนึ่งช่อง Enter ส่งฟอร์ม และปุ่ม Accept ใช้ตัวจัดการ submit เดียวกัน ดังนั้นการสแกนหนึ่งครั้งถูกประมวลครั้งเดียว ถ้าไม่มีส่วนต่อท้าย ENTER ข้อความจะค้างในช่องจนกว่าจะมีคนกด Accept เพย์โหลดที่จับได้ถูกเขียนด้วย textContent ดังนั้นอักขระอย่าง < ยังเห็นเป็นข้อความ

ตัวอย่างรับสามรูปแบบของแอปพลิเคชัน: รหัสตั๋วเช่น QR-INPUT-TEST-12345, URL แบบ http หรือ https, หรืออ็อบเจกต์ JSON มันบันทึกข้อความที่สแกน ไม่นำทางไปยัง URL ที่พบในรหัส QR เครื่องสแกนที่ไม่ส่ง 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 ของฟอร์มเท่านั้น ตัวฟัง keydown ตัวที่สองสำหรับ Enter จะบันทึกการสแกนเดียวกันสองครั้ง 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 ส่งฟอร์มของช่องข้อความบรรทัดเดียวในเบราว์เซอร์ปัจจุบัน ใช้เมื่อการสแกนหนึ่งครั้งควรยืนยันค่า เรียก preventDefault() ที่ submit เมื่อหน้าเว็บควรอยู่ที่เดิม

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 แล้วตามด้วย keydown สุดท้ายของ Enter หรือ Tab เมื่อตั้งส่วนต่อท้ายนั้น 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 ข้อความธรรมดา ได้รับค่าตรงทุกตัว
QR แบบ URL จับ URL ได้ครบ และหน้าเว็บไม่นำทางไปที่นั่น
QR ตัวเลข ตัวเลขคงอยู่
อักขระพิเศษ ได้รับอักขระที่ถูกต้อง
เพย์โหลด JSON จับข้อมูลและตรวจสอบแล้ว
ส่วนต่อท้าย ENTER ประมวลผลครั้งเดียว
ส่วนต่อท้าย TAB จัดการพฤติกรรมโฟกัสแล้ว
ไม่มีส่วนต่อท้าย แอปพลิเคชันใช้วิธีทำให้เสร็จแบบอื่น
การสแกนซ้ำ แอปพลิเคชันใช้กฎจัดการรายการซ้ำ
เพย์โหลดไม่ถูกต้อง แสดงข้อผิดพลาดการตรวจสอบ
ไม่มีโฟกัส แอปพลิเคชันจัดการอินพุตที่ไม่มีอย่างปลอดภัย
เพย์โหลดยาว ไม่ถูกตัดโดยไม่ตั้งใจ

สแกนเพย์โหลดที่มีการขึ้นบรรทัดใหม่ด้วย ถ้าผลิตภัณฑ์ต้องเก็บอักขระนั้น บันทึกว่าช่องได้รับทุกบรรทัดหรือไม่

การแก้ปัญหา

เริ่มจากเพย์โหลดที่รู้จักในตัวทดสอบอินพุต ถ้าค่าของตัวทดสอบผิดอยู่แล้ว หน้าเว็บไม่ใช่ความผิดแรก ถ้าค่าของตัวทดสอบถูกแต่แอปพลิเคชันผิด ความผิดอยู่ที่โฟกัส การตรวจสอบ หรือการจัดการเหตุการณ์ เครื่องสแกนบาร์โค้ดไม่ทำงาน เป็นรายการตรวจอุปกรณ์ที่กว้างกว่า วิธีทดสอบอินพุตจากเครื่องสแกนบาร์โค้ด ครอบคลุมโฟกัส ผังแป้นพิมพ์ และเวิร์กโฟลว์ POS นอกฟอร์มนี้

เครื่องสแกนมีเสียงบี๊บแต่ไม่มีอินพุต

เสียงบี๊บมักแปลว่าเครื่องสแกนถอดรหัสสัญลักษณ์ได้ ไม่ได้แปลว่าหน้าเว็บได้รับข้อความ ยืนยันโหมดลิ่มแป้นพิมพ์ โหมดอนุกรมและกล้องจะไม่พิมพ์ลงช่อง คลิกช่องเพื่อให้ document.activeElement เป็นอินพุตนั้น แล้วสแกนอีกครั้ง ช่องที่ปิดใช้งาน อ่านอย่างเดียว หรือซ่อนอยู่ อาจไม่สนใจแป้น

เครื่องสแกน QR ใช้ได้ใน Notepad แต่ใช้ไม่ได้ในเบราว์เซอร์

อุปกรณ์กำลังพิมพ์ หน้าเว็บไม่รับแป้นเหล่านั้น ตรวจโฟกัส ตัวฟัง keydown ที่เรียก preventDefault() บนแป้นที่พิมพ์ได้ และตัวฟังที่จัดการแต่ paste อินพุตแบบลิ่มไม่ทำให้เกิดเหตุการณ์ 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 เพิ่มความสว่างของจอ เพิ่มขนาดรหัส และรักษาโซนเงียบให้พ้นข้อความและขอบ แสงสะท้อน หน้าจอโทรศัพท์ที่มืด และรหัสที่หนาแน่นเกินระยะทำงาน เป็นปัญหาเชิงแสง พิมพ์เพย์โหลดเดียวกันถ้าการอ่านจากหน้าจอยังล้มเหลว การทดสอบแอปพลิเคชันยังใช้สตริงที่รู้จัก เมื่อการสแกนใด ๆ สร้างข้อความได้