콘텐츠로 건너뛰기

Barcode Scanner Emulator

웹 애플리케이션에서 QR 코드 스캐너 입력을 테스트하는 방법

QR을 읽을 수 있는 많은 외부 스캐너는 키보드 웨지 모드를 쓰고, 디코딩된 QR 텍스트를 포커스된 필드에 입력합니다. 아는 페이로드를 스캔하고 페이지가 받은 값과 비교해 그 경로를 테스트합니다. 모든 QR 스캐너가 키보드처럼 입력하지는 않습니다. 시리얼 장치와 카메라 디코더는 다른 연동이고, 브라우저 키보드 이벤트는 실제 스캐너를 식별하지 않습니다.

QR 코드는 데이터를 담습니다. 스캐너 또는 카메라 디코더가 그 데이터를 텍스트로 바꿉니다. 웹 애플리케이션은 그 텍스트를 받고, 스캔이 끝난 시점을 정하고, 검증해야 합니다. 이 가이드는 그 애플리케이션 테스트입니다. 라벨 생성, 대비 확인, 장치가 QR Code를 디코딩할 수 있는지 확인하는 일은 QR 코드 테스트: QR 코드 스캐너를 테스트하는 방법에서 다룹니다. EAN 체크 디짓을 포함한 일반 바코드 폼은 웹 애플리케이션에서 바코드 스캐너를 테스트하는 방법에서 다룹니다.

60초 안에 QR 스캐너 입력 테스트하기

직접 고른 페이로드를 쓰면 잘못된 문자가 분명합니다. 이 절차는 QR-INPUT-TEST-12345를 사용합니다.

  1. QR 코드 생성기를 열고 QR-INPUT-TEST-12345의 QR 코드를 만듭니다. 생성기는 브라우저에서 실행됩니다. 스캐너에 접속하지 않습니다.
  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 키보드 웨지 설명이 설명합니다.

목적지를 정하는 것은 포커스입니다. 포커스된 요소가 문서 body, 버튼, 또는 다른 프레임이면 이 필드의 리스너는 스캔을 보지 못합니다.

시리얼 QR 스캐너

USB 시리얼 또는 가상 COM 포트 스캐너는 디코딩된 텍스트를, 포트를 연 프로세스에 바이트로 보냅니다. 그 프로세스를 고르는 것은 포커스가 아닙니다. 키 입력만 듣는 필드는 비어 있고, 그 포트의 터미널에는 페이로드가 보입니다.

Chromium 기반 브라우저는 보안 컨텍스트에서 사용자 동작 뒤에, 사용자가 고른 포트를 Web Serial API로 열 수 있습니다. Firefox와 Safari는 그 API를 제공하지 않습니다. 웨지 스캐너는 시리얼 포트로 나타나지 않습니다. 포트 이름, 보레이트, 프레이밍은 장치와 드라이버에 따라 다릅니다. USB HID와 시리얼 바코드 스캐너가 두 인터페이스를 비교합니다. 바코드 입력 테스터는 COM 포트를 읽을 수 없습니다.

카메라 기반 QR 스캔

카메라 연동은 이미지를 포착하고 소프트웨어에서 QR 코드를 디코딩합니다. 페이지는 카메라 API와 디코더를 씁니다. 페이로드에 대한 keydown 이벤트는 받지 않습니다. 전화 카메라 앱, 페이지 안의 카메라 버튼, 필드에 입력하는 하드웨어 이미저는 서로 다른 세 제품입니다. 웨지 테스트를 통과해도 카메라 버튼이 동작한다는 뜻은 아니고, 카메라 디코딩이 성공해도 웨지 스캐너가 같은 문자열을 입력한다는 뜻은 아닙니다.

JavaScript로 QR 스캐너 입력 캡처하기

아래 페이지는 포커스된 필드 하나를 읽습니다. Enter는 폼을 제출하고, Accept 버튼은 같은 제출 핸들러를 쓰므로 한 번의 스캔은 한 번 처리됩니다. ENTER 접미사가 없으면 누군가 Accept를 활성화할 때까지 텍스트가 필드에 남습니다. 캡처된 페이로드는 textContent로 쓰이므로 < 같은 문자는 텍스트로 보입니다.

예는 세 가지 애플리케이션 형식을 받습니다. QR-INPUT-TEST-12345 같은 티켓 ID, http 또는 https URL, 또는 JSON 객체입니다. 스캔한 텍스트를 기록합니다. QR 코드에서 찾은 URL로 이동하지는 않습니다. Enter를 보내지 않는 스캐너도 버튼을 통해 동작합니다. 스크립트가 Tab을 가두지 않으므로 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 이벤트에서만 처리합니다. Enter를 위한 두 번째 keydown 리스너는 같은 스캔을 두 번 기록합니다. 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는 현재 브라우저에서 한 줄 텍스트 필드의 폼을 제출합니다. 한 번의 스캔이 값을 확정해야 할 때 사용합니다. 페이지가 그 자리에 있어야 하면 submit에서 preventDefault()를 호출합니다.

TAB은 포커스를 다음 컨트롤로 옮깁니다. 필드에 아직 포커스가 있을 때 keydown에서 값을 읽습니다. 다음 필드가 포커스를 받아야 하면 기본 동작을 그대로 둡니다. 키보드 사용자가 뒤로 이동할 수 있도록 Shift+Tab은 무시합니다.

접미사 없음은 페이로드를 필드에 남깁니다. 예의 Accept 버튼이 완료 경로입니다. 무활동 타이머는 멈춤이 스캔의 끝이라고 짐작할 수 있습니다. 그 타이머는 휴리스틱입니다. 느린 Bluetooth 버스트와 빠른 입력자 모두 같은 간격을 넘을 수 있습니다. 워크플로에 확실한 끝이 필요하면 설정된 접미사를 우선합니다.

CR과 LF는 바이트입니다. 키보드 Enter는 event.key === "Enter"입니다. 둘은 서로 바꾸어 쓸 수 없습니다. 입력 값에서 \r만 제거하는 리스너는 웨지 Enter를 보지 못합니다. 그 문자는 삽입된 적이 없기 때문입니다. event.key만 보는 리스너는 시리얼 버퍼를 0x0D에서 나누지 못합니다. 일부 장치는 숫자 키패드의 Enter를 보냅니다. event.key는 여전히 "Enter"입니다. event.code === "Enter"만이 아니라 event.key를 확인합니다.

누군가 장치 매뉴얼의 구성 바코드를 스캔하면 접미사가 바뀔 수 있습니다. 설정을 바꾼 뒤에는 Enter, Tab, 접미사 없음을 다시 테스트합니다. 프로그래밍 바코드를 만들지 마십시오. 그 모델의 매뉴얼을 사용합니다.

키보드 이벤트 디버그

저장된 텍스트가 잘못되었으면 이벤트를 이 순서로 살펴봅니다.

keydown. Enter와 Tab을 포함해 모든 키에서 발생하며, 브라우저가 문자를 넣거나 포커스를 옮기기 전입니다. 종료 키는 여기서 읽습니다.

input. 인쇄 가능한 문자가 필드를 바꾼 뒤에 발생합니다. 텍스트 입력에서 Enter나 Tab에는 발생하지 않습니다.

event.key. 운영 체제가 키보드 배열을 적용한 뒤의 문자 또는 키 이름입니다.

event.code. Digit1이나 Numpad1 같은 물리 키입니다. 배열 불일치가 event.key를 바꿔도 그대로일 수 있습니다.

포커스. 스캔 전에 document.activeElement를 기록합니다. 그것이 QR 필드가 아니면 나머지 추적은 잘못된 컨트롤을 설명합니다. iframe은 자신의 포커스를 가집니다.

순서. 텍스트 필드로 들어오는 웨지 스캔에서는 인쇄 가능한 keydown 뒤에 input 갱신이 오고, 그 접미사가 설정되어 있으면 Enter 또는 Tab의 마지막 keydown이 옵니다. change는 필드가 값을 확정할 때, 대개 blur에서 발생합니다. 같은 필드에 포커스를 남기는 스캔은 끝에 change를 만들지 않습니다. change만 완료 신호로 쓰지 마십시오.

타이밍. 스캐너는 짧은 페이로드를 종종 1초보다 훨씬 짧게 끝냅니다. 입력 테스터는 문자 사이 평균 간격을 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 정확한 값을 받음
URL QR 전체 URL을 캡처하고, 페이지는 그곳으로 이동하지 않음
숫자 QR 숫자가 유지됨
특수 문자 올바른 문자를 받음
JSON 페이로드 데이터를 캡처하고 검증함
ENTER 접미사 처리가 한 번 일어남
TAB 접미사 포커스 동작을 처리함
접미사 없음 애플리케이션이 다른 완료 방식을 사용함
중복 스캔 애플리케이션이 중복 처리 규칙을 적용함
잘못된 페이로드 검증 오류를 표시함
포커스 없음 애플리케이션이 없는 입력을 안전하게 처리함
긴 페이로드 의도하지 않은 잘림이 없음

제품이 줄 바꿈을 저장해야 하면 줄 바꿈이 있는 페이로드도 스캔합니다. 필드가 모든 줄을 받았는지 기록합니다.

문제 해결

아는 페이로드로 입력 테스터에서 시작합니다. 테스터의 값이 이미 잘못되었으면 페이지가 첫 고장이 아닙니다. 테스터의 값은 맞고 애플리케이션이 잘못되었으면 고장은 포커스, 검증, 또는 이벤트 처리입니다. 바코드 스캐너가 작동하지 않음은 더 넓은 장치 점검 목록입니다. 바코드 스캐너 입력을 테스트하는 방법은 이 폼을 넘는 포커스, 배열, POS 워크플로를 다룹니다.

스캐너는 소리를 내지만 입력이 나타나지 않음

비프는 대개 스캐너가 심볼을 디코딩했음을 뜻합니다. 페이지가 텍스트를 받았다는 뜻은 아닙니다. 키보드 웨지 모드를 확인합니다. 시리얼과 카메라 모드는 필드에 입력하지 않습니다. document.activeElement가 그 입력이 되도록 필드를 클릭한 뒤 다시 스캔합니다. 비활성화되었거나 읽기 전용이거나 숨겨진 필드는 키를 무시할 수 있습니다.

QR 스캐너는 메모장에서는 되고 브라우저에서는 안 됨

장치는 입력하고 있습니다. 페이지가 그 키를 받아들이지 않습니다. 포커스, 인쇄 가능한 키에서 preventDefault()를 호출하는 keydown 리스너, paste만 처리하는 리스너를 확인합니다. 웨지 입력은 paste 이벤트를 발생시키지 않습니다. 테스터 결과와 애플리케이션 필드를 비교합니다.

스캐너는 바코드는 읽고 QR 코드는 읽지 못함

장치가 1D 전용이거나 QR 심볼로지가 꺼져 있을 수 있습니다. 페이지는 그것을 고치지 못합니다. 2D 지원을 확인하고, QR 코드 테스트: QR 코드 스캐너를 테스트하는 방법의 확인을 사용해 장치 매뉴얼에서 QR Code를 켭니다. Code 128 스캔이 성공해도 증명되는 것은 키보드 경로뿐입니다.

문자가 올바르지 않음

먼저 QR-INPUT-TEST-12345를 스캔합니다. 그것은 일치하고 URL 또는 JSON 페이로드는 일치하지 않으면, 배열이 :, /, {, " 같은 문장 부호를 바꾸고 있는 것입니다. 키보드 이벤트 테스터에서 event.key와 event.code를 비교하고 바코드 스캐너의 잘못된 키보드 배열을 보십시오. 스캐너의 키보드 배열을 운영 체제에 맞춥니다.

ENTER가 폼을 두 번 제출함

브라우저가 폼을 제출하고, keydown 리스너도 Enter를 처리합니다. 완료 경로는 하나로 두고 거기서 preventDefault()를 호출합니다. 두 번째 물리적 스캔은 다른 고장입니다. 예의 상태 텍스트는 페이로드가 이미 받아들여졌다고 말합니다. 첫 스캔 자체가 레코드 두 개를 만들면, 스캐너를 바꾸기 전에 리스너가 둘인지 찾습니다.

QR 입력이 잘림

입력 테스터의 문자 수와 필드의 값을 비교합니다. maxlength 속성, 입력 마스크, 문자 키의 preventDefault()는 문자열을 자를 수 있습니다. QR 페이로드 안의 줄 바꿈은 한 줄 입력을 일찍 제출할 수 있습니다. 일부 스캐너는 입력하는 문자 수도 제한합니다. 테스터가 짧은 값을 보일 때, 애플리케이션만이 아니라 장치 매뉴얼에서 그 한도를 올립니다. 바코드 스캐너에 ENTER가 없음은 페이로드는 도착하는데 폼이 확정되지 않는 관련 경우를 다룹니다.

스캐너가 화면의 QR 코드를 읽지 못함

스캐너가 2D 이미저인지 확인합니다. 화면 밝기를 올리고, 코드 크기를 키우고, 여백(quiet zone)을 글자와 테두리에서 비워 둡니다. 반사, 어두운 전화 화면, 작업 거리에 비해 너무 촘촘한 코드는 광학 문제입니다. 화면 읽기가 계속 실패하면 같은 페이로드를 인쇄합니다. 어떤 스캔이든 텍스트를 내면, 애플리케이션 테스트는 여전히 아는 문자열을 사용합니다.