Chuyển tới nội dung

Barcode Scanner Emulator

Cách kiểm thử máy quét mã vạch trong ứng dụng web

Nhiều máy quét mã vạch USB và Bluetooth gửi dữ liệu đã giải mã như đầu vào bàn phím, nên một trường đang được focus trong ứng dụng web có thể nhận lần quét mà không cần API trình duyệt riêng cho máy quét. Cổng nối tiếp và SDK của nhà cung cấp là những tích hợp riêng. Bạn có thể kiểm thử đường bàn phím bằng máy quét thật hoặc bằng tổ hợp phím mô phỏng.

Ứng dụng web thường thấy máy quét mã vạch như một bàn phím. Việc cần kiểm thử là control đang được focus có nhận đúng phần tải mà ứng dụng mong đợi hay không, và trang có xử lý ký tự kết thúc mà máy quét được cấu hình để gửi hay không. Ký tự kết thúc đó có thể là Enter, Tab, hoặc không có gì.

Dùng một phiên trình kiểm thử đầu vào mã vạch khi máy quét thật đã gắn. Dùng Barcode Scanner Emulator khi bạn cần cùng đường bàn phím trong lúc phát triển mà phần cứng không có trên bàn. Lượt kiểm tra rộng hơn về focus, bố cục và quy trình POS nằm trong Cách kiểm thử đầu vào máy quét mã vạch. Hướng dẫn này ở lại với ứng dụng trình duyệt: ghi nhận, hậu tố, kiểm tra hợp lệ, và những sự kiện bạn thực sự quan sát được.

Máy quét mã vạch giao tiếp với ứng dụng web như thế nào

Chế độ giao diện quyết định trang có thể nhận gì. Hãy xác nhận chế độ trước khi sửa mã form. Máy quét thường đổi chế độ bằng cách quét một mã vạch cấu hình trong sổ tay của nhà sản xuất.

Nêm bàn phím USB HID

Ở chế độ bàn phím USB HID, máy quét liệt kê như một bàn phím. Hệ điều hành nạp trình điều khiển bàn phím thông thường của nó. Sau khi máy quét giải mã một ký hiệu, nó gửi các ký tự như tổ hợp phím tới control đang có focus bàn phím. Trang lắng nghe những tổ hợp phím đó, hoặc đọc văn bản chúng chèn vào. Trang không mở kết nối tới thiết bị.

Đường đó là lý do một trường thanh toán, ô tìm kiếm, hoặc bất kỳ ô nhập văn bản nào khác có thể nhận lần quét bằng HTML thông thường. Hướng dẫn Giải thích HID keyboard wedge nói kỹ hơn về chuỗi tổ hợp phím, tiền tố và hậu tố.

Bluetooth HID

Máy quét Bluetooth được ghép đôi như bàn phím dùng cùng đường ứng dụng. Máy chủ coi nó là bàn phím HID, và trường đang focus nhận tổ hợp phím. Ghép đôi, pin và sóng vô tuyến là việc của thiết bị. Khi các ký tự tới trình duyệt, trang xử lý chúng giống cách xử lý đầu vào nêm USB.

Cổng nối tiếp và cổng COM ảo

Máy quét nối tiếp, gồm nhiều chế độ cổng COM ảo qua USB, gửi văn bản đã giải mã dưới dạng byte trên một cổng. Focus không chọn đích đến. Tiến trình mở cổng mới chọn. Một trường văn bản chỉ lắng nghe tổ hợp phím sẽ không thấy luồng đó.

Trình duyệt dựa trên Chromium có thể mở cổng nối tiếp qua Web Serial API sau khi người dùng chọn cổng và cấp quyền. Firefox và Safari không cung cấp API đó. Một lần kiểm thử nêm không tập cho tích hợp nối tiếp, và một lần kiểm thử nối tiếp không cho biết máy quét nêm sẽ gõ gì.

Giao diện riêng của nhà cung cấp

Một số thiết bị dùng SDK của nhà cung cấp, OPOS, JPOS, hoặc giao diện HID không phải bàn phím như USB HID POS. Những giao diện đó không gõ vào trường đang focus. Một trang web thông thường không tải được SDK gốc. Chromium có thể yêu cầu một số thiết bị HID không phải bàn phím qua WebHID sau một cử chỉ của người dùng. Thiết bị HID loại bàn phím vẫn bị chặn, nên máy quét nêm không phân biệt được với bàn phím. Hãy coi giao diện của nhà cung cấp là một tích hợp riêng và kiểm thử bằng phần mềm thực sự mở giao diện đó.

Trình duyệt nhìn thấy gì

Một lần quét nêm tới dưới dạng sự kiện keydown và keyup, và ký tự in được sẽ cập nhật trường đang focus. Trình duyệt không nhận tên thiết bị, số sê-ri USB, hay một cờ nói rằng đây là máy quét. Trình duyệt có WebHID vẫn từ chối giao diện bàn phím, nên script của trang cũng không đọc được báo cáo HID thô của máy quét nêm.

event.key là ký tự hoặc tên phím sau khi hệ điều hành áp bố cục bàn phím đang dùng. event.code đặt tên phím vật lý, chẳng hạn Digit1 hoặc Numpad1, và có thể giữ nguyên khi lệch bố cục làm đổi event.key. Không thuộc tính nào trong hai cái này nhận diện phần cứng.

Cách kiểm thử máy quét mã vạch thật trong trình duyệt

Chạy bước này trước khi gỡ lỗi mã ứng dụng. Nó cho thấy đúng chuỗi và ký tự kết thúc mà trình duyệt đã nhận.

  1. Nối máy quét và đợi đến khi nó báo đã có nguồn. Với Bluetooth, hoàn tất ghép đôi và xác nhận máy chủ đang dùng hồ sơ bàn phím.
  2. Xác nhận chế độ nhập. Nêm bàn phím, bàn phím USB HID, hoặc bàn phím Bluetooth HID có thể gõ vào một trường. Chế độ nối tiếp, SPP và SDK của nhà cung cấp thì không.
  3. Mở trình kiểm thử đầu vào mã vạch.
  4. Nhấp Bắt đầu kiểm thử, hoặc nhấp vùng quét. Vùng đó chuyển xanh khi sẵn sàng. Trang không tự lấy focus.
  5. Quét một mã vạch mà bạn đã biết phần tải. Bắt đầu bằng một giá trị số ngắn, rồi quét một giá trị có dấu câu mà ứng dụng lưu.
  6. Đọc giá trị đã ghi nhận và số ký tự. So cả hai với phần tải bạn mong đợi, kể cả mọi tiền tố mà máy quét chèn trước dữ liệu.
  7. Kiểm tra hậu tố. Trình kiểm thử báo ENTER, TAB hoặc Không có. Khi Tự động ghi nhận bật, kết quả xuất hiện sau Enter, Tab, hoặc một khoảng dừng ngắn khi các phím ngừng. Tắt Tự động ghi nhận khi bạn muốn bản ghi nhận được giữ đến lúc bạn nhấn Dừng.
  8. So kết quả đó với chuỗi mà ứng dụng phải lưu. Tiền tố, ký tự bị thay, hoặc ký tự kết thúc bị thiếu nên được sửa trong cấu hình máy quét, hoặc được xử lý có chủ đích trên trang. Đừng coi đó là lỗi giải mã cho đến khi so sánh này xong.

Trình kiểm thử ghi lại sự kiện bàn phím mà trình duyệt nhìn thấy. Nó không nhận diện thiết bị USB và không đọc cổng nối tiếp. Khi trình soạn thảo nhận được lần quét còn trình duyệt thì không, tiếp tục với Máy quét chạy trong Notepad nhưng không chạy trong POS.

Ghi nhận đầu vào máy quét mã vạch bằng JavaScript

Máy quét gõ vào phần tử đang có focus. Hãy cho trường một nhãn nhìn thấy được, để nó là ô nhập văn bản bình thường để người dùng bàn phím vẫn gõ được mã, và đọc giá trị khi quy trình nói rằng mục nhập đã xong. Trang bên dưới làm điều đó. Enter gửi form một lần. Tab hoàn tất một giá trị không rỗng rồi để trình duyệt chuyển focus. Một lần quét không có ký tự kết thúc nằm trong trường đến khi ai đó kích hoạt 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>

Lưu tệp đó và mở trong trình duyệt trên máy tính. Nhấp trường nếu focus đã chuyển đi. Máy quét nêm, hoặc trình giả lập ở mục sau, sẽ gõ vào #barcode.

Focus là bắt buộc. Nếu document.activeElement là body của tài liệu, một nút, hoặc một ô nhập khác, listener của trường này không thấy lần quét. Các ký tự rơi vào control đang focus, hoặc bị mất. Gọi field.focus() khi quy trình sẵn sàng nhận lần quét, kể cả sau khi một hộp thoại đóng.

Đầu vào rỗng bị bỏ qua. Form đứng yên, và văn bản trạng thái nói rằng không nhận được gì. Chỉ có khoảng trắng thì rỗng sau trim().

Ví dụ không thêm Enter hay Tab. Nếu máy quét không được cấu hình để gửi chúng, giá trị vẫn nằm trong trường và Look up là đường hoàn tất. autocomplete="off" giảm khả năng một giá trị đã lưu thay thế lần quét. Nhãn, nút và Shift+Tab vẫn dùng được, nên một người có thể nhập mã mà không cần máy quét.

Xử lý Enter ở một chỗ. Ví dụ này dùng sự kiện submit của form, sự kiện đó cũng bao gồm nút Look up và phím Enter. Một listener keydown thứ hai cho Enter sẽ ghi cùng một lần quét hai lần. Nếu ô nhập không nằm trong form, hãy lắng nghe Enter trên keydown và gọi preventDefault() để form tổ tiên không gửi thêm:

field.addEventListener('keydown', (event) => {
  if (event.key !== 'Enter') {
    return
  }

  event.preventDefault()
  const value = field.value.trim()
  if (!value) {
    return
  }

  console.log(value)
  field.value = ''
})

Xóa trường sau khi chấp nhận thành công để lần quét sau không nối vào phần tải trước. Sau Enter, ví dụ focus lại cùng trường vì quy trình đó chờ lần quét tiếp theo trong cùng một ô. Sau Tab, nó để focus yên để trình duyệt chuyển tới control kế tiếp.

Xử lý hậu tố ENTER và TAB

Hậu tố là một phím mà máy quét có thể gửi sau phần tải. Đó là thiết đặt của thiết bị. Enter phổ biến, và không bắt buộc. Hướng dẫn Hậu tố ENTER và TAB trên máy quét mã vạch mô tả cách phân biệt các ký tự kết thúc. Xác nhận thiết đặt trên máy quét bạn đang kiểm thử, rồi làm cho trang khớp quy trình đó.

ENTER

Enter bên trong một trường văn bản một dòng sẽ gửi form bao ngoài trên các trình duyệt hiện nay. Dùng điều đó khi một lần quét phải chốt giá trị, như ô tra cứu. preventDefault() trên sự kiện submit ngăn trình duyệt chuyển trang. Bỏ qua lệnh đó khi điều hướng cả trang chính là hành vi bạn muốn.

Nếu mã vạch hiện ra mà form không làm gì, máy quét có thể không gửi hậu tố. Máy quét mã vạch thiếu ENTER đi qua cấu hình đó. Một số thiết bị gửi NumPad Enter. event.key vẫn là "Enter". Kiểm tra event.key, đừng chỉ kiểm tra event.code === "Enter", nếu không máy quét đó sẽ trông như bị hỏng.

TAB

Tab chuyển focus tới control có thể focus kế tiếp. Cách đó hợp với một chuỗi như mã sản phẩm, rồi số lượng. Nó làm bất ngờ một form vốn chờ Enter để gửi.

Đọc giá trị trong keydown khi trường vẫn còn focus. Trình duyệt chuyển focus sau sự kiện đó. Giữ hành động mặc định khi control kế tiếp phải nhận focus. preventDefault() giữ focus tại chỗ, hữu ích khi giá trị không hợp lệ và bạn muốn người vận hành nhìn thấy. Bỏ qua Shift+Tab để người dùng bàn phím có thể đi lùi qua form. Hậu tố Tab của máy quét là Tab không có Shift.

Hậu tố Tab cũng có thể chuyển focus trước khi mã của bạn đọc trường, nếu listener nằm trên blur hoặc change và thứ khác xóa control. Hãy đọc giá trị từ target của sự kiện keydown.

Không có hậu tố

Khi không có hậu tố, phần tải nằm trong trường. Ứng dụng phải quyết định lúc nào lần quét kết thúc. Một nút rõ ràng, một lần Enter sau đó của người vận hành, hoặc chuyển sang bước khác là những điểm hoàn tất đáng tin. Một bộ đếm thời gian không hoạt động có thể coi khoảng dừng khi gõ là hết một lần quét. Bộ đếm đó là phỏng đoán. Máy quét chậm, độ trễ Bluetooth, hoặc người gõ nhanh có thể rơi về phía sai của ngưỡng. Hãy ưu tiên một hậu tố đã cấu hình khi quy trình cần tín hiệu kết thúc lần quét chắc chắn.

Khác biệt cấu hình

Máy quét cùng nhãn hiệu có thể xuất xưởng với hậu tố khác nhau, và một mã vạch cấu hình có thể đổi hậu tố mà không đổi JavaScript của bạn. Một số thiết bị gửi tiền tố, mã nhận dạng hệ ký hiệu như ]C1, hoặc CR và LF. Hãy kiểm thử ba thiết đặt ký tự kết thúc mà người dùng thực sự chọn được: Enter, Tab, và không có. Ghi lại thiết đặt mà máy quét đã triển khai đang dùng, và kiểm thử trang với thiết đặt đó.

Kiểm tra hợp lệ đầu vào máy quét mã vạch

Kiểm tra chuỗi mà trường đã nhận. Đừng giả định mọi mã vạch có cùng độ dài, tập ký tự, hoặc checksum. Phần tải Code 128 và QR thay đổi. EAN-13 là 13 chữ số. Ứng dụng lưu cả hai cần quy tắc cho cả hai.

Đầu vào rỗng. Từ chối hoặc bỏ qua. Một hậu tố không có phần tải, hoặc một lần nhấp Look up trên trường trống, không được tạo bản ghi.

Ký tự không mong đợi. So chuỗi đã nhận với một nhãn đã biết. Lệch bố cục thường hiện ra như một ký hiệu đổi, chẳng hạn chữ số hoặc dấu câu bị dịch, trong khi độ dài giữ nguyên. Ký tự điều khiển có thể đến từ tiền tố hoặc từ dấu phân cách nhóm GS1. Cho phép các ký tự mà định dạng của bạn định nghĩa. Ví dụ trên từ chối ký tự điều khiển ASCII để chúng vẫn hiện trong văn bản trạng thái. Bộ phân tích GS1 chờ dấu phân cách nhóm nên cho phép ký tự đó và từ chối phần còn lại.

Độ dài. Áp các độ dài mà ứng dụng chấp nhận. Một cận dưới và cận trên chung an toàn hơn một độ dài bắt buộc duy nhất khi form nhận nhiều hơn một hệ ký hiệu. maxlength trên ô nhập sẽ cắt im lặng một phần tải dài hơn, nên chỉ đặt khi mọi mã được chấp nhận đều vừa.

Tiền tố. Chỉ cắt tiền tố khi bạn đã cấu hình máy quét gửi đúng tiền tố đó và ứng dụng không lưu nó.

function withoutConfiguredPrefix(value, prefix) {
  if (prefix && value.startsWith(prefix)) {
    return value.slice(prefix.length)
  }
  return value
}

Mã nhận dạng hệ ký hiệu AIM là dữ liệu nếu máy quét được đặt để truyền nó. Hãy để nguyên cho đến khi bạn quyết định ứng dụng có lưu nó hay không.

Hậu tố. Giữ ký tự kết thúc ra khỏi giá trị được lưu. Enter và Tab là phím. Chúng không được chèn vào một ô nhập văn bản bình thường. Một phần tải nối tiếp vẫn có thể chứa byte CR hoặc LF. Hãy loại chúng ở biên nơi bạn phân tích luồng nối tiếp, và kiểm thử rằng bạn không loại chúng ở giữa một phần tải vốn chứa chúng một cách hợp lệ.

Gửi trùng. Một lần quét có thể được xử lý hai lần nếu cả keydown và submit chạy cho cùng một Enter. Dùng một đường hoàn tất duy nhất. Lần quét thứ hai của cùng một mã là câu hỏi khác. Form kho có thể tăng số lượng. Form vé có thể từ chối một mã đã đổi. Đặt quy tắc đó trong ứng dụng, và kiểm thử có chủ đích. Trình duyệt không phân biệt được lần bóp cò thứ hai với listener thứ hai.

Quy tắc ứng dụng. Checksum thuộc về những hệ ký hiệu cụ thể. EAN-13 dùng chữ số cuối làm chữ số kiểm tra. Hàm này chỉ chấp nhận định dạng đó:

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 và QR không dùng phép tính đó. Máy quét có thể đã kiểm tra hệ ký hiệu của nó và truyền dữ liệu mà người đọc được. Hãy kiểm tra các định dạng bạn lưu, và lặp lại kiểm tra trên máy chủ. Chuỗi được gửi lên là đầu vào người dùng bình thường. Trình duyệt không chứng minh được rằng một máy quét đã tạo ra nó.

Kiểm thử đầu vào máy quét mã vạch khi không có phần cứng

Barcode Scanner Emulator là ứng dụng máy tính cho Windows, macOS và Linux. Bạn nhập văn bản cần gửi, chọn độ trễ gõ, và chọn hậu tố là không có, ENTER, hoặc TAB. Một phím tắt toàn cục gõ văn bản đó vào ứng dụng đang focus. Nó tái hiện đường bàn phím mà máy quét nêm dùng. Nó không chiếu sáng nhãn, không đọc ký hiệu, và không giải mã hệ ký hiệu.

Dùng trang ví dụ ở trên, hoặc trang bạn đang xây:

  1. Mở trang trong trình duyệt trên máy tính và nhấp trường mã vạch.
  2. Trong trình giả lập, nhập một giá trị đã biết như 123456789012.
  3. Đặt hậu tố thành ENTER. Đặt độ trễ gõ nếu bạn muốn cụm phím giống một máy quét bạn đã đo.
  4. Nhấn phím tắt quét toàn cục của trình giả lập khi trường trên trình duyệt vẫn còn focus.
  5. Xác nhận văn bản trạng thái và việc giá trị được chấp nhận đúng một lần.
  6. Lặp lại với TAB. Focus phải chuyển, và giá trị phải được chấp nhận một lần.
  7. Lặp lại khi không có hậu tố. Văn bản phải nằm trong trường đến khi bạn kích hoạt Look up.
  8. Focus trình kiểm thử đầu vào mã vạch và gửi lại cùng giá trị. So chuỗi đã ghi nhận, tiền tố và hậu tố với những gì ứng dụng đã lưu.

Cài đặt và phím tắt đầu tiên nằm trong Bắt đầu. Sau khi đổi thiết đặt, hãy gửi một lần quét vào trình kiểm thử đầu vào trước khi tin kết quả trong ứng dụng.

Phần cứng vẫn cần cho phần quang học và phần riêng của thiết bị trong bài kiểm thử:

  • Máy quét đó có giải mã được ký hiệu in hoặc đang hiển thị hay không, gồm nhãn hỏng, kích thước, độ tương phản và khoảng cách.
  • Hỗ trợ hệ ký hiệu. Máy quét laser 1D không đọc được mã QR. Xem Kiểm thử mã QR: cách kiểm thử máy quét mã QR.
  • Liệt kê USB, ghép đôi Bluetooth, cùng cấu hình bố cục bàn phím và hậu tố của chính máy quét.
  • Tích hợp nối tiếp, HID POS và SDK của nhà cung cấp.

Trình giả lập là công cụ đúng cho logic ứng dụng dọc theo đường bàn phím. Nó là công cụ sai nếu muốn chứng minh một máy quét cụ thể đọc được một nhãn cụ thể.

Gỡ lỗi sự kiện bàn phím của máy quét mã vạch

Xem các sự kiện theo thứ tự này khi giá trị đã lưu bị sai.

keydown. Bắn cho mọi phím, gồm Enter và Tab, trước khi trình duyệt chèn một ký tự hoặc chuyển focus. Đọc ký tự kết thúc ở đây. event.repeat là true khi một phím được giữ. Máy quét nêm thường gửi một lần nhấn riêng cho mỗi ký tự.

input. Bắn trên trường sau khi một ký tự in được đổi giá trị của nó. Đây là sự kiện đúng để theo dõi nếu bạn cần văn bản khi nó đang dài ra. Nó không bắn cho Enter hoặc Tab, vì những phím đó không chèn ký tự vào ô nhập văn bản.

change. Bắn sau khi giá trị được chốt, thường là khi trường mất focus. Máy quét để focus ở cùng trường sẽ không tạo change ở cuối lần quét. Đừng dùng change làm tín hiệu hoàn tất duy nhất.

event.key và event.code. Ghi cả hai khi một ký tự bị sai. Lệch giữa bố cục máy quét và bố cục hệ điều hành đổi event.key và để event.code vẫn giống phím mà máy quét định nhấn. Chữ số từ bàn phím số dùng Numpad1 và các mã tương tự. Một số mặt nạ nhập xử lý chúng khác Digit1. Máy quét mã vạch sai bố cục bàn phím giải thích lệch bố cục.

Focus. Ghi document.activeElement ngay trước một lần quét. Nếu đó không phải trường mã vạch, phần còn lại của dấu vết đang giải thích sai control. iframe có focus riêng. Một lần quét vào khung nhúng chỉ hiện với script bên trong khung đó.

Thời gian. Máy quét thường xong một phần tải ngắn trong thời gian ngắn hơn nhiều so với một giây. Trình kiểm thử đầu vào so khoảng cách trung bình giữa các ký tự với ngưỡng 100 ms và gắn nhãn kết quả là thời gian, không phải nhận diện phần cứng. Một ngưỡng khoảng cách có thể coi người gõ nhanh, tự điền, hoặc trình giả lập là máy quét. Máy quét có độ trễ giữa ký tự, liên kết Bluetooth, hoặc phần tải dài có thể trông như đang gõ. Hãy dùng giá trị đã ghi nhận và hậu tố. Dùng thời gian như một manh mối.

Dùng trình kiểm thử sự kiện bàn phím để liệt kê mỗi keydown và keyup cùng key, code, phím bổ trợ và dấu thời gian. Dùng nó khi chuỗi đã ghép che một phím tiền tố hoặc một mã bàn phím số. Nhật ký là sự kiện trình duyệt. Đó không phải lưu lượng USB thô.

Vấn đề thường gặp trong ứng dụng web

Lần quét vào nhầm trường. Đầu vào nêm đi theo focus. Nhấp trường đích sau mỗi lần điều hướng, hộp thoại, hoặc thông báo kiểm tra hợp lệ làm chuyển focus. Một cửa sổ mô thức không có trường văn bản có thể nuốt lần quét như phím tắt.

Máy quét chạy trong trình soạn thảo mà không chạy trong trình duyệt. Thiết bị đang gõ. Trang không chấp nhận những phím đó. Kiểm tra focus, ô nhập bị tắt hoặc chỉ đọc, và listener keydown gọi preventDefault() trên phím in được. Listener chỉ xử lý paste không bao giờ thấy đầu vào nêm. Bắt đầu với Máy quét mã vạch không hoạt động nếu không ứng dụng nào nhận được ký tự.

Enter gửi form hai lần hoặc chuyển trang. Trình duyệt gửi form, và listener của bạn cũng xử lý Enter. Gọi preventDefault() trên một trong hai đường đó và xử lý giá trị một lần. Form nhiều trường có thể gửi trước khi các trường sau được điền khi máy quét gửi Enter. Dùng Tab cho quy trình đó, hoặc ngăn gửi cho đến khi form hoàn tất.

Tab đổi focus. Đó là phím Tab. Hoặc cấu hình Enter trên máy quét, hoặc đọc giá trị trong keydown và cho phép focus chuyển. Xem mục hậu tố ở trên.

Bố cục bàn phím sai. Chữ số có thể còn lại sau một lần lệch làm đổi dấu câu. Hãy quét một giá trị đã biết chứa các ký hiệu bạn lưu, trên bố cục mà máy trạm thực sự dùng.

Cùng một lần quét tạo hai bản ghi. Tìm hai listener trên một Enter trước khi tìm hai lần quét vật lý. Rồi kiểm thử một lần quét thứ hai có chủ đích và xác nhận quy tắc số lượng hoặc trùng lặp mà ứng dụng ghi lại.

Giá trị bị thiếu hoặc bị cắt. Thuộc tính maxlength, một mặt nạ nhập, hoặc preventDefault() trên phím ký tự có thể làm rơi hoặc cắt phần tải. So số ký tự trong trình kiểm thử đầu vào với giá trị trong trường của bạn. Tiền tố cũng có thể làm một phần tải đúng trông quá dài.

Mã QR không bao giờ xuất hiện. Máy quét có thể chỉ đọc 1D, hoặc hệ ký hiệu QR có thể bị tắt. Ứng dụng không sửa được điều đó. Xác nhận phần cứng với Kiểm thử mã QR: cách kiểm thử máy quét mã QR, rồi quay lại kiểm thử trường.

Danh sách kiểm tra ứng dụng web

Dùng danh sách này trên bản dựng bạn định phát hành, trong mỗi trình duyệt bạn hỗ trợ. Kiểm tra cả hồ sơ mới lẫn hồ sơ có tiện ích quản lý mật khẩu và tự điền, vì những tiện ích đó chuyển focus.

  • Máy quét đã nối hoặc đã ghép đôi, và máy chủ hiện nó sẵn sàng.
  • Máy quét ở chế độ nêm bàn phím, không phải nối tiếp hoặc chế độ SDK của nhà cung cấp.
  • Trường mã vạch được focus ngay trước lần quét. document.activeElement là trường đó.
  • Một mã vạch đã biết tới từng ký tự, kể cả độ dài.
  • Hậu tố ENTER gửi hoặc chấp nhận giá trị một lần và không để ký tự kết thúc trong chuỗi đã lưu.
  • Hậu tố TAB chuyển focus tới control bạn định tới, và giá trị được đọc trước khi chuyển.
  • Cấu hình không hậu tố để giá trị còn dùng được đến khi ứng dụng hoàn tất nó.
  • Một lần gửi rỗng bị từ chối hoặc bỏ qua.
  • Một lần quét không tạo hai bản ghi. Lần quét thật thứ hai tuân theo quy tắc trùng lặp của ứng dụng.
  • Dấu câu, ký hiệu, và mọi dấu phân cách GS1 mà định dạng của bạn dùng vẫn còn sau một vòng đi về.
  • Bố cục bàn phím của máy quét và bố cục hệ điều hành tạo ra các ký tự in trên nhãn.
  • Sau khi rút và cắm lại, hoặc sau khi liên kết Bluetooth rớt, lần quét kế tiếp vẫn tới trường.
  • Nhiều lần quét liên tiếp vẫn là các giá trị riêng. Trường không nối chúng lại.
  • Các kiểm tra đó cùng đạt trong các trình duyệt bạn hỗ trợ, có và không có tiện ích tự điền phổ biến.

Với hộp thoại, thứ tự tab của cả một lượt thanh toán, và luồng số lượng POS, tiếp tục với Cách kiểm thử đầu vào máy quét mã vạch.

Ma trận trường hợp kiểm thử

Cột máy quét là việc thiết bị và trình duyệt làm. Cột hành vi mong đợi là việc ứng dụng phải làm để đáp lại. Quy tắc nghiệp vụ, chẳng hạn mã sản phẩm lặp lại có tăng số lượng hay không, thuộc về ứng dụng. Hãy nêu chúng trong bài kiểm thử thay vì giả định một quy tắc cho mọi sản phẩm.

Tình huống Hành vi mong đợi
Mã vạch hợp lệ Ứng dụng chấp nhận giá trị và lưu phần tải mà không có ký tự kết thúc.
Đầu vào rỗng Ứng dụng từ chối hoặc bỏ qua và không tạo bản ghi.
Hậu tố ENTER Ứng dụng gửi hoặc chấp nhận giá trị một lần.
Hậu tố TAB Focus chuyển tới control kế tiếp đã định, và giá trị được giữ.
Không có hậu tố Đầu vào vẫn dùng được đến khi ứng dụng xử lý nó.
Quét liên tiếp nhanh Mỗi giá trị được xử lý riêng và không nối với giá trị trước.
Sai bố cục bàn phím Ký tự không mong đợi hiện trong giá trị đã ghi nhận và không qua kiểm tra hợp lệ.
Quét trùng Ứng dụng tuân theo quy tắc trùng lặp của chính nó, chẳng hạn tăng số lượng hoặc từ chối một lần phát lại.
Định dạng mã vạch không hợp lệ Ứng dụng hiện lỗi kiểm tra hợp lệ của định dạng đó và không lưu giá trị.
Mất focus nhập Ứng dụng không bịa ra một mã vạch. Lần quét vắng mặt hoặc rơi vào control đang focus, và trang ở trạng thái an toàn.

Chạy các hàng hợp lệ, rỗng, ENTER, TAB và không hậu tố bằng máy quét thật, rồi chạy lại bằng trình giả lập. Chạy các hàng bố cục bàn phím, QR và kết nối lại trên phần cứng. Những hàng đó phụ thuộc vào thiết bị, nhãn, hoặc bố cục hệ điều hành, mà tổ hợp phím mô phỏng không tái hiện được.