コンテンツへスキップ

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 を変えても同じままであることがあります。どちらのプロパティもハードウェアを識別しません。

ブラウザで実機のバーコードスキャナーをテストする方法

アプリケーションのコードを調べる前に、これを実行します。ブラウザが受け取った正確な文字列と終端が分かります。

  1. スキャナーを接続し、電源が入ったことを示すまで待ちます。Bluetooth では、ペアリングを終え、ホストがキーボードプロファイルを使っていることを確認します。
  2. 入力モードを確認します。キーボードウェッジ、USB HID キーボード、Bluetooth HID キーボードはフィールドへ入力できます。シリアル、SPP、ベンダー SDK のモードは入力しません。
  3. バーコード入力テスターを開きます。
  4. テスト開始をクリックするか、スキャン領域をクリックします。準備ができると青くなります。ページは自分ではフォーカスを取りません。
  5. ペイロードが分かっているバーコードをスキャンします。短い数値から始め、次にアプリケーションが保存する句読点を含む値をスキャンします。
  6. 取り込まれた値と文字数を読みます。スキャナーがデータの前に挿入する接頭辞を含め、期待するペイロードと両方を比べます。
  7. 接尾辞を確認します。テスターは ENTER、TAB、またはなしと報告します。自動取得がオンのときは、Enter、Tab、またはキーが止まったあとの短い休止のあと、結果が表示されます。取得を停止を押すまで保持したいときは、自動取得をオフにします。
  8. その結果を、アプリケーションが保存すべき文字列と比べます。接頭辞、置き換わった文字、欠けた終端は、スキャナーの設定で直すか、ページで意図的に扱います。この比較が終わるまで、復号の失敗として扱わないでください。

テスターは、ブラウザが見られるキーボードイベントを記録します。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 から選びます。グローバルショートカットが、そのテキストをフォーカスのあるアプリケーションへ入力します。ウェッジスキャナーが使うキーボード経路を再現します。ラベルを照らしたり、シンボルを読んだり、シンボル体系を復号したりはしません。

上の例のページ、または構築中のページを使います。

  1. ページをデスクトップのブラウザで開き、バーコードのフィールドをクリックします。
  2. エミュレーターで、123456789012 のような分かっている値を入力します。
  3. 接尾辞を ENTER にします。すでに測ったスキャナーのバーストに近づけたいときは、入力の遅延を設定します。
  4. ブラウザのフィールドにまだフォーカスがあるあいだに、エミュレーターのグローバルスキャンショートカットを押します。
  5. ステータスのテキストと、値が一度だけ受け付けられたことを確認します。
  6. TAB で繰り返します。フォーカスは移り、値は一度だけ受け付けられるはずです。
  7. 接尾辞なしで繰り返します。Look up を押すまで、テキストはフィールドに残るはずです。
  8. バーコード入力テスターにフォーカスし、同じ値を再び送ります。取り込まれた文字列、接頭辞、接尾辞を、アプリケーションが保存したものと比べます。

インストールと最初のショートカットは、はじめににあります。設定を変えたあとは、アプリケーションの結果を信じる前に、入力テスターへスキャンを一つ送ります。

テストの光学的な部分と機器固有の部分には、なおハードウェアが必要です。

  • そのスキャナーが、印刷または表示されたシンボルを復号できるか。傷んだラベル、大きさ、コントラスト、距離を含みます。
  • シンボル体系の対応。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、再接続の行はハードウェアで実行します。それらの行は機器、ラベル、またはオペレーティングシステムの配列に依存し、シミュレートしたキー入力は再現しません。