Barcode Scanner Emulator
Cách kiểm thử đầu vào máy quét mã QR trong ứng dụng web
Nhiều máy quét bên ngoài đọc được QR dùng chế độ nêm bàn phím và gõ văn bản QR đã giải mã vào trường đang focus. Hãy kiểm thử đường đó bằng cách quét một phần tải đã biết và so với giá trị trang nhận được. Không phải máy quét QR nào cũng gõ như bàn phím. Thiết bị nối tiếp và bộ giải mã camera là những tích hợp khác, và sự kiện bàn phím của trình duyệt không nhận diện máy quét vật lý.
Mã QR lưu dữ liệu. Máy quét, hoặc một bộ giải mã camera, biến dữ liệu đó thành văn bản. Ứng dụng web sau đó phải nhận văn bản, quyết định khi nào lần quét kết thúc, và kiểm tra hợp lệ. Hướng dẫn này là bài kiểm thử ứng dụng đó. Việc tạo nhãn, kiểm tra độ tương phản, và xác nhận thiết bị giải mã được QR Code nằm trong Kiểm thử mã QR: cách kiểm thử máy quét mã QR. Biểu mẫu mã vạch nói chung, kể cả chữ số kiểm tra EAN, nằm trong Cách kiểm thử máy quét mã vạch trong ứng dụng web.
Kiểm thử đầu vào máy quét QR trong 60 giây
Dùng một phần tải do bạn chọn, để một ký tự sai hiện rõ. Các bước này dùng QR-INPUT-TEST-12345.
- Mở trình tạo mã QR và tạo mã QR cho
QR-INPUT-TEST-12345. Trình tạo chạy trong trình duyệt. Nó không liên hệ với máy quét. - Nối một máy quét đọc được QR đang đặt ở chế độ nêm bàn phím. Máy quét chỉ đọc 1D không giải mã được ký hiệu này.
- Mở trình kiểm thử đầu vào mã vạch.
- Nhấp Bắt đầu kiểm thử, hoặc nhấp vùng quét, để trường có focus. Trình kiểm thử không tự lấy focus, và không mở máy quét.
- Quét mã QR.
- Đọc văn bản đã ghi nhận và số ký tự.
- So văn bản đó với
QR-INPUT-TEST-12345. Sự khớp gồm cả hoa thường, dấu gạch nối và độ dài. - Đọc hậu tố. Trình kiểm thử báo ENTER, TAB hoặc Không có khi máy quét gửi một trong các phím đó.
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, không đọc cổng nối tiếp, và không giải mã ảnh QR.
Chế độ đầu vào của máy quét QR
Cùng một mã QR đã in có thể đến qua ba tích hợp khác nhau. Kiểm thử một chế độ không tập cho các chế độ còn lại.
Máy quét QR nêm bàn phím
Ở chế độ bàn phím USB HID, hoặc chế độ bàn phím Bluetooth HID, hệ điều hành coi máy quét là bàn phím. Sau khi giải mã, máy quét gõ phần tải vào control đang có focus. Một <input> hoặc <textarea> bình thường có thể nhận nó. Trang không mở thiết bị. Hướng dẫn Giải thích HID keyboard wedge mô tả chuỗi tổ hợp phím, tiền tố và hậu tố.
Focus quyết định đích đến. Nếu phần tử đang focus là body của tài liệu, một nút, hoặc một khung khác, listener của trường này không thấy lần quét.
Máy quét QR nối tiếp
Máy quét cổng nối tiếp USB hoặc cổng COM ảo gửi văn bản đã giải mã dưới dạng byte tới tiến trình đã mở cổng. Focus không chọn tiến trình đó. Trường chỉ lắng nghe tổ hợp phím vẫn trống trong khi một terminal trên cổng đó hiện phần tải.
Trình duyệt dựa trên Chromium có thể mở cổng do người dùng chọn bằng Web Serial API, trong ngữ cảnh bảo mật, sau một cử chỉ của người dùng. Firefox và Safari không cung cấp API đó. Máy quét nêm không hiện như một cổng nối tiếp. Tên cổng, baud và khung phụ thuộc thiết bị cùng trình điều khiển. Máy quét mã vạch USB HID và nối tiếp so hai giao diện. Trình kiểm thử đầu vào mã vạch không đọc được cổng COM.
Quét QR bằng camera
Một tích hợp camera chụp ảnh và giải mã mã QR trong phần mềm. Trang dùng API camera và một bộ giải mã. Nó không nhận sự kiện keydown cho phần tải. Ứng dụng camera điện thoại, nút camera trong trang, và bộ chụp ảnh phần cứng gõ vào một trường là ba sản phẩm khác nhau. Vượt qua bài kiểm thử nêm không có nghĩa nút camera hoạt động, và một lần giải mã camera thành công không có nghĩa máy quét nêm sẽ gõ cùng chuỗi.
Ghi nhận đầu vào máy quét QR bằng JavaScript
Trang bên dưới đọc một trường đang focus. Enter gửi form, và nút Accept dùng cùng trình xử lý submit, nên một lần quét được xử lý một lần. Không có hậu tố ENTER thì văn bản nằm trong trường đến khi ai đó kích hoạt Accept. Phần tải đã ghi nhận được ghi bằng textContent, nên ký tự như < vẫn hiện là văn bản.
Ví dụ chấp nhận ba định dạng ứng dụng: mã vé như QR-INPUT-TEST-12345, một URL http hoặc https, hoặc một đối tượng JSON. Nó ghi lại văn bản đã quét. Nó không điều hướng tới URL tìm thấy trong mã QR. Máy quét không gửi Enter vẫn dùng được qua nút. Tab đi qua nhãn, trường và nút như thường, vì script không giữ nó lại.
<!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>
Lưu tệp và mở trong trình duyệt máy tính. Nhấp trường trước khi quét. autocomplete="off" giảm khả năng một giá trị đã lưu thay thế lần quét. Nhãn và nút vẫn còn, nên một người có thể gõ phần tải mà không cần máy quét.
Chỉ xử lý Enter trong sự kiện submit của form. Một listener keydown thứ hai cho Enter ghi cùng lần quét hai lần. preventDefault() giữ trình duyệt ở trang này. Xóa trường sau một quyết định để lần quét sau không nối vào văn bản trước.
Phần tải QR có thể chứa ngắt dòng. Máy quét nêm thường gõ ngắt đó như Enter. Trong ô nhập một dòng, form có thể gửi ở dòng đầu và bỏ phần còn lại. Dùng textarea, hoặc bộ đọc nối tiếp giữ các byte, khi ứng dụng phải nhận văn bản nhiều dòng. Xác nhận hành vi đó bằng mã QR có phần tải chứa ký tự xuống dòng.
Xử lý phần tải QR
Một ký hiệu QR không hứa một định dạng ứng dụng. Cùng hệ ký hiệu có thể mang bất kỳ nội dung nào sau đây:
- Văn bản thuần, chẳng hạn
QR-INPUT-TEST-12345. - Một URL.
- Một mã định danh do ứng dụng chọn.
- Một phần tải có cấu trúc, chẳng hạn số vé cộng mã địa điểm.
- Văn bản JSON, khi ứng dụng đã định nghĩa cách mã hóa đó.
Máy quét truyền các ký tự đã giải mã. Nó không kiểm tra chúng có khớp quy tắc vé, danh mục sản phẩm, hay lược đồ JSON hay không. Kiểm tra hợp lệ chuỗi trên trang, và kiểm tra lại trên máy chủ. Giá trị được gửi là đầu vào người dùng thông thường. Trình duyệt không chứng minh được máy quét đã tạo ra nó.
Kiểm tra hợp lệ đầu vào QR
Đừng giả định phần tải QR là số. Quy tắc EAN-13 không áp dụng. Hãy coi văn bản là không đáng tin: hiển thị nó như văn bản, và đừng gán nó cho location, innerHTML, hoặc một URL script.
Giá trị rỗng. Một Enter trần, hoặc Accept trên trường trống, không được tạo bản ghi. trim() cũng từ chối phần tải chỉ gồm khoảng trắng.
Ký tự không mong đợi. So chuỗi đã nhận với nội dung QR đã biết. Lệch bố cục bàn phím thường đổi dấu câu trong khi độ dài giữ nguyên. Từ chối ký tự mà định dạng không cho phép, và nêu lý do trong văn bản trạng thái.
Độ dài phần tải. Áp mức tối đa mà ứng dụng lưu. maxlength trên ô nhập cắt im lặng một lần quét dài hơn, không báo lỗi. Chỉ đặt khi mọi phần tải được chấp nhận đều vừa, và so số ký tự của trình kiểm thử với trường khi một giá trị trông ngắn.
Tiền tố bắt buộc. Việc kiểm tra tiền tố thuộc về ứng dụng. Quy tắc vé này chấp nhận QR- cùng chữ hoa, chữ số và dấu gạch nối:
function isTicketId(value) {
return /^QR-[A-Z0-9-]{1,64}$/.test(value)
}
Chỉ cắt tiền tố máy quét khi máy quét đó được cấu hình gửi đúng một tiền tố và ứng dụng không lưu nó. Mã nhận dạng hệ ký hiệu AIM là dữ liệu cho đến khi bạn quyết định khác.
Định dạng riêng của ứng dụng. Giữ quy tắc cạnh định dạng. Form vé, danh sách URL được phép, và đối tượng JSON cần các kiểm tra khác nhau. Một mẫu chỉ gồm số sẽ từ chối văn bản QR hợp lệ.
Lần quét trùng. Một lần quét vật lý có thể chạm hai listener. Dùng một đường hoàn tất duy nhất, như ví dụ làm. Lần bóp cò thứ hai là sự kiện riêng. Ví dụ từ chối phần tải nó đã chấp nhận. Form kho có thể tăng số lượng. Hãy kiểm thử quy tắc mà ứng dụng ghi lại.
JSON sai dạng. JSON.parse ném lỗi trên văn bản chưa đủ. Kiểm tra hình dạng sau khi phân tích thành công. Một mảng hoặc một số trần có thể là JSON hợp lệ mà vẫn sai kiểu:
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 không mong đợi. Phân tích URL để xem nó dùng được không, rồi giữ chuỗi đã quét nếu bài kiểm thử phải khớp phần tải QR đúng từng ký tự. URL.href có thể thêm dấu gạch chéo hoặc đổi cách mã hóa. Chỉ chấp nhận những scheme mà ứng dụng định dùng. Đừng mở URL như một tác dụng phụ của lần quét:
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 }
}
Ký tự điều khiển. Từ chối ký tự điều khiển ASCII trong phần tải bàn phím để tiền tố ẩn vẫn hiện trong văn bản trạng thái. CR và LF là ký tự điều khiển. Trên máy quét nêm, Enter và Tab là phím. Chúng không phải ký tự bên trong ô nhập văn bản bình thường. Phần tải nối tiếp vẫn có thể chứa byte 0x0D hoặc 0x0A. Hãy loại chúng ở biên khung nối tiếp, và đừng xóa CR nằm giữa một phần tải nhiều dòng.
Hậu tố ENTER và TAB
Hậu tố là cấu hình tùy chọn của máy quét. Nó không thuộc ký hiệu QR. Hậu tố ENTER và TAB trên máy quét mã vạch cho thấy cách phân biệt các phím. Đọc hậu tố trong trình kiểm thử đầu vào, rồi làm cho trang khớp những máy quét bạn triển khai.
ENTER gửi form của trường văn bản một dòng trên trình duyệt hiện nay. Dùng khi một lần quét phải chốt giá trị. Gọi preventDefault() trên submit khi trang phải ở lại.
TAB chuyển focus sang control kế tiếp. Đọc giá trị trong keydown khi trường vẫn còn focus. Để hành động mặc định nếu trường kế tiếp phải nhận focus. Bỏ qua Shift+Tab để người dùng bàn phím đi lùi được.
Không có hậu tố để phần tải trong trường. Nút Accept trong ví dụ là đường hoàn tất. Một bộ đếm không hoạt động có thể đoán rằng khoảng dừng nghĩa là lần quét đã hết. Bộ đếm đó là một phỏng đoán: một đợt Bluetooth chậm và người gõ nhanh đều có thể vượt cùng một khoảng. Hãy ưu tiên hậu tố đã cấu hình khi quy trình cần một điểm kết rõ.
CR và LF là byte. Enter của bàn phím là event.key === "Enter". Hai thứ đó không thay nhau được. Listener chỉ gỡ \r khỏi giá trị ô nhập sẽ không thấy Enter của nêm, vì ký tự chưa từng được chèn. Listener chỉ theo dõi event.key sẽ không tách bộ đệm nối tiếp tại 0x0D. Một số thiết bị gửi NumPad Enter. event.key vẫn là "Enter". Hãy kiểm tra event.key, không chỉ event.code === "Enter".
Hậu tố có thể đổi khi ai đó quét một mã vạch cấu hình trong sổ tay thiết bị. Kiểm thử lại Enter, Tab và không có hậu tố sau mọi thay đổi cấu hình. Đừng tự nghĩ ra mã vạch lập trình. Dùng sổ tay của đúng kiểu máy.
Gỡ lỗi sự kiện bàn phím
Khi văn bản đã lưu bị sai, hãy xem các sự kiện theo thứ tự này.
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.
input. Bắn sau khi một ký tự in được đổi trường. Nó không bắn cho Enter hoặc Tab trên ô nhập văn bản.
event.key. Ký tự hoặc tên phím sau khi hệ điều hành áp bố cục bàn phím.
event.code. Phím vật lý, chẳng hạn Digit1 hoặc Numpad1. Nó có thể giữ nguyên khi lệch bố cục làm đổi event.key.
Focus. Ghi document.activeElement trước lần quét. Nếu đó không phải trường QR, phần còn lại của dấu vết đang mô tả sai control. iframe có focus riêng.
Thứ tự. Với lần quét nêm vào trường văn bản, các sự kiện keydown in được được theo sau bởi cập nhật input, rồi một keydown cuối cho Enter hoặc Tab khi hậu tố đó được cấu hình. change bắn khi trường chốt giá trị, thường là lúc blur. Lần quét để focus ở cùng trường không tạo change ở cuối. Đừng dùng change làm tín hiệu hoàn tất duy nhất.
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. Người gõ nhanh, tự điền, hoặc trình giả lập có thể rơi về phía máy quét của ngưỡng đó. Một lần quét Bluetooth bị trễ có thể trông như đang gõ. Hãy khẳng định phần tải và hậu tố. Coi thời gian là 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. Nhật ký là sự kiện trình duyệt. Đó không phải lưu lượng USB thô.
Kiểm thử khi không có máy quét QR vật lý
Logic ứng dụng có thể được kiểm thử trước khi máy quét có trên bàn.
- Gõ
QR-INPUT-TEST-12345vào trường và kích hoạt Accept. Việc đó kiểm tra hợp lệ và cách hiển thị. Nó không kiểm tra giải mã hay hậu tố. - Điều khiển cùng trường từ một công cụ tự động hóa trình duyệt, như mục sau làm.
- Dùng Barcode Scanner Emulator khi bạn cần kiểu gõ của máy quét. Ứng dụng máy tính gửi một giá trị bạn nhập, với độ trễ gõ và hậu tố là không có, ENTER, hoặc TAB, vào ứng dụng đang focus. Nó tái hiện đường bàn phím. Nó không chụp ảnh QR, không giải mã ký hiệu, và không tạo cổng COM ảo.
Phần cứng vẫn cần cho hành vi quang học và của thiết bị: máy quét đó có đọc được mã đang hiển thị hoặc đã in hay không, hệ ký hiệu QR có bật hay không, bố cục bàn phím, cấu hình hậu tố, và các chế độ nối tiếp hoặc SDK của nhà cung cấp. Trình giả lập là bài kiểm tra đúng cho đường bàn phím. Đó là bài kiểm tra sai nếu muốn chứng minh một thiết bị đọc được một mã QR cụ thể.
Tự động hóa kiểm thử đầu vào QR
Các bài kiểm thử Playwright sau điều khiển trang ví dụ. Chúng gõ vào trường theo cách máy quét nêm sẽ gõ, rồi khẳng định hành vi ứng dụng. Chúng không mở thiết bị USB. @playwright/test là phụ thuộc của người chạy bài kiểm thử. Trang này không yêu cầu nó.
Lưu ví dụ HTML thành qr-form.html cạnh bài kiểm thử này.
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 chèn ký tự vào trường đang focus. Nó không phải thiết bị USB. Bài kiểm thử ký tự không mong đợi dùng fill vì mục tiêu là thông báo kiểm tra hợp lệ và việc không có phần tử bị chèn. Hãy mở rộng tệp bằng một ca URL và một ca JSON khi những định dạng đó có trong bản bạn phát hành. Một khẳng định URL phải so văn bản đã ghi nhận với chuỗi QR gốc.
Ma trận kiểm thử máy quét QR
Chạy các mục này với ứng dụng đang được kiểm thử. Trang mẫu ở trên phủ các hàng vé, URL, JSON, trùng, rỗng và ký tự không mong đợi. Ứng dụng chỉ nhận số hoặc nhiều dòng cần kết quả mong đợi riêng.
| Tình huống | Kết quả mong đợi |
|---|---|
| QR văn bản thuần | Nhận đúng giá trị |
| QR dạng URL | URL đầy đủ được ghi nhận, và trang không điều hướng tới đó |
| QR số | Các chữ số được giữ nguyên |
| Ký tự đặc biệt | Nhận đúng ký tự |
| Phần tải JSON | Dữ liệu được ghi nhận và kiểm tra hợp lệ |
| Hậu tố ENTER | Việc xử lý xảy ra một lần |
| Hậu tố TAB | Hành vi focus được xử lý |
| Không có hậu tố | Ứng dụng dùng một cơ chế hoàn tất khác |
| Lần quét trùng | Ứng dụng áp quy tắc xử lý trùng |
| Phần tải không hợp lệ | Hiện lỗi kiểm tra hợp lệ |
| Thiếu focus | Ứng dụng xử lý an toàn khi không có đầu vào |
| Phần tải dài | Không bị cắt ngoài ý muốn |
Cũng quét một phần tải có ký tự xuống dòng nếu sản phẩm phải lưu ký tự đó. Ghi lại trường có nhận đủ mọi dòng hay không.
Khắc phục sự cố
Bắt đầu bằng một phần tải đã biết trong trình kiểm thử đầu vào. Nếu giá trị của trình kiểm thử đã sai, trang không phải lỗi đầu tiên. Nếu giá trị của trình kiểm thử đúng mà ứng dụng sai, lỗi nằm ở focus, kiểm tra hợp lệ, hoặc xử lý sự kiện. Máy quét mã vạch không hoạt động là danh sách kiểm tra thiết bị rộng hơn. Cách kiểm thử đầu vào máy quét mã vạch nói về focus, bố cục và quy trình POS ngoài form này.
Máy quét kêu bíp nhưng không có đầu vào
Tiếng bíp thường có nghĩa máy quét đã giải mã một ký hiệu. Điều đó không có nghĩa trang đã nhận văn bản. Xác nhận chế độ nêm bàn phím. Chế độ nối tiếp và camera sẽ không gõ vào trường. Nhấp trường để document.activeElement là ô nhập đó, rồi quét lại. Trường bị tắt, chỉ đọc, hoặc ẩn có thể bỏ qua các phím.
Máy quét QR chạy trong Notepad nhưng 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, listener keydown gọi preventDefault() trên phím in được, và listener chỉ xử lý paste. Đầu vào nêm không kích hoạt sự kiện paste. So kết quả trình kiểm thử với trường của ứng dụng.
Máy quét đọc mã vạch nhưng không đọc mã QR
Thiết bị có thể chỉ đọc 1D, hoặc hệ ký hiệu QR có thể đang tắt. Trang không sửa được điều đó. Xác nhận hỗ trợ 2D và bật QR Code từ sổ tay thiết bị, bằng các bước trong Kiểm thử mã QR: cách kiểm thử máy quét mã QR. Một lần quét Code 128 thành công chỉ chứng minh đường bàn phím.
Ký tự không đúng
Hãy quét QR-INPUT-TEST-12345 trước. Nếu chuỗi đó khớp mà phần tải URL hoặc JSON thì không, bố cục đang đổi dấu câu như :, /, {, hoặc ". So event.key với event.code trong trình kiểm thử sự kiện bàn phím, và xem Máy quét mã vạch sai bố cục bàn phím. Khớp bố cục bàn phím của máy quét với hệ điều hành.
ENTER gửi form hai lần
Trình duyệt gửi form, và một listener keydown cũng xử lý Enter. Giữ một đường hoàn tất và gọi preventDefault() ở đó. Lần quét vật lý thứ hai là một lỗi khác. Văn bản trạng thái trong ví dụ nói phần tải đã được chấp nhận. Nếu chính lần quét đầu tạo hai bản ghi, hãy tìm hai listener trước khi đổi máy quét.
Đầu vào QR bị cắt
So số ký tự trong trình kiểm thử đầu vào với giá trị trong trường. Thuộc tính maxlength, một mặt nạ nhập, hoặc preventDefault() trên phím ký tự có thể cắt chuỗi. Một ký tự xuống dòng bên trong phần tải QR có thể gửi sớm ô nhập một dòng. Một số máy quét cũng giới hạn số ký tự chúng gõ. Hãy nâng giới hạn đó từ sổ tay thiết bị khi trình kiểm thử, không chỉ ứng dụng, hiện một giá trị ngắn. Máy quét mã vạch thiếu ENTER nói về trường hợp liên quan, khi phần tải tới mà form không bao giờ chốt.
Máy quét không đọc được mã QR trên màn hình
Xác nhận máy quét là bộ chụp ảnh 2D. Tăng độ sáng màn hình, tăng kích thước mã, và giữ vùng yên không dính chữ hay viền. Loá, màn hình điện thoại tối, và mã quá dày so với khoảng cách làm việc là vấn đề quang học. Hãy in cùng phần tải nếu việc đọc trên màn hình vẫn thất bại. Bài kiểm thử ứng dụng vẫn dùng chuỗi đã biết một khi bất kỳ lần quét nào tạo ra văn bản.