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 장치를 식별하거나 시리얼 포트를 읽을 수는 없습니다. 텍스트 편집기가 스캔을 받고 브라우저는 받지 못하면 메모장에서는 되지만 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도 포함합니다. 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 이벤트의 target에서 읽습니다.
접미사 없음
접미사가 없으면 페이로드는 필드에 머뭅니다. 스캔이 끝났는지는 애플리케이션이 정해야 합니다. 명시적 버튼, 조작자의 나중 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는 true입니다. 웨지 스캐너는 보통 각 문자에 대해 별도의 누름을 보냅니다.
input. 인쇄 가능한 문자가 값을 바꾼 뒤 필드에서 발생합니다. 늘어나는 텍스트가 필요하면 볼 이벤트입니다. Enter나 Tab에서는 발생하지 않습니다. 그 키는 텍스트 입력에 문자를 넣지 않기 때문입니다.
change. 값이 확정된 뒤, 대개 필드가 포커스를 잃을 때 발생합니다. 같은 필드에 포커스를 남겨 두는 스캐너는 스캔 끝에 change를 만들지 않습니다. change만 완료 신호로 쓰지 마십시오.
event.key와 event.code. 문자가 잘못되면 둘 다 기록합니다. 스캐너 배열과 운영 체제 배열의 불일치는 event.key를 바꾸고, event.code는 스캐너가 의도한 키처럼 보이게 둡니다. 숫자 키패드의 숫자는 Numpad1 같은 코드를 씁니다. 일부 입력 마스크는 그것을 Digit1과 다르게 다룹니다. 바코드 스캐너의 잘못된 키보드 배열이 배열 불일치를 설명합니다.
포커스. 스캔 직전에 document.activeElement를 기록합니다. 그것이 바코드 필드가 아니면, 나머지 추적은 잘못된 컨트롤을 설명하는 것입니다. iframe은 자신의 포커스를 가집니다. 임베디드 프레임으로 들어간 스캔은 그 프레임 안의 스크립트에 보입니다.
타이밍. 스캐너는 짧은 페이로드를 종종 1초보다 훨씬 짧게 끝냅니다. 입력 테스터는 문자 사이 평균 간격을 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, 재연결 행은 하드웨어에서 실행합니다. 그 행은 장치, 라벨, 또는 운영 체제 배열에 달려 있으며, 시뮬레이션한 키 입력은 재현하지 않습니다.