İçeriğe atla

Barcode Scanner Emulator

Web Uygulamalarında Barkod Okuyucular Nasıl Test Edilir

Birçok USB ve Bluetooth barkod okuyucu, çözülen veriyi klavye girişi olarak gönderir. Bu yüzden web uygulamasındaki odaklı bir alan, okuyucuya özel bir tarayıcı API’si olmadan taramayı alabilir. Seri bağlantı noktaları ve üretici SDK’ları ayrı entegrasyonlardır. Klavye yolunu fiziksel bir okuyucuyla veya benzetilmiş tuş vuruşlarıyla test edebilirsiniz.

Bir web uygulaması barkod okuyucuyu genellikle bir klavye olarak görür. Test, odaklı denetimin uygulamanızın beklediği yükü alıp almadığı ve sayfanın okuyucunun göndermek üzere yapılandırıldığı sonlandırıcıyı işleyip işlemediğidir. Bu sonlandırıcı Enter, Tab veya hiçbir şey olabilir.

Fiziksel bir okuyucu takılıyken bir Barkod Giriş Test Aracı oturumu kullanın. Geliştirme sırasında aynı klavye yoluna ihtiyacınız varsa ve donanım masada değilse Barcode Scanner Emulator kullanın. Odak, düzen ve POS akışlarına daha geniş bir bakış Barkod Okuyucu Girişi Nasıl Test Edilir rehberindedir. Bu rehber tarayıcı uygulamasında kalır: yakalama, sonekler, doğrulama ve gerçekten gözlemleyebileceğiniz olaylar.

Barkod Okuyucular Web Uygulamalarıyla Nasıl İletişim Kurar

Arabirim kipi, sayfanın ne alabileceğine karar verir. Form kodunu değiştirmeden önce bunu doğrulayın. Bir okuyucu, çoğu zaman üretici kılavuzundaki bir yapılandırma barkodunu okuyarak kip değiştirebilir.

USB HID keyboard wedge

USB HID klavye kipinde okuyucu bir klavye olarak numaralanır. İşletim sistemi normal klavye sürücüsünü yükler. Okuyucu bir sembolü çözdükten sonra karakterleri, klavye odağı hangi denetimdeyse ona tuş vuruşu olarak gönderir. Sayfa bu tuş vuruşlarını dinler veya bunların eklediği metni okur. Aygıta bir bağlantı açmaz.

Bu yol, bir ödeme alanının, bir arama kutusunun veya başka bir metin girişinin sıradan HTML ile taramayı kabul edebilmesinin nedenidir. HID Keyboard Wedge rehberi tuş vuruşu sırasını, ön ekleri ve sonekleri daha ayrıntılı anlatır.

Bluetooth HID

Klavye olarak eşleştirilmiş bir Bluetooth okuyucu aynı uygulama yolunu kullanır. Ana bilgisayar onu bir HID klavye olarak görür ve odaklı alan tuş vuruşlarını alır. Eşleştirme, pil ve radyo aygıt konularıdır. Karakterler tarayıcıya ulaştıktan sonra sayfa onları USB wedge girişiyle aynı şekilde işler.

Seri bağlantı noktası ve sanal COM bağlantı noktası

Seri bir okuyucu, birçok USB sanal COM bağlantı noktası kipi dahil, çözülen metni bir bağlantı noktasındaki baytlar olarak gönderir. Hedefi odak seçmez. Bağlantı noktasını açan süreç seçer. Yalnızca tuş vuruşlarını dinleyen bir metin alanı bu akışı görmez.

Chromium tabanlı tarayıcılar, kullanıcı bağlantı noktasını seçip izin verdikten sonra Web Serial API üzerinden bir seri bağlantı noktası açabilir. Firefox ve Safari bu API’yi sunmaz. Bir wedge testi seri bir entegrasyonu çalıştırmaz ve bir seri test, bir wedge okuyucunun ne yazacağını söylemez.

Üreticiye özel arabirimler

Bazı aygıtlar bir üretici SDK’sı, OPOS, JPOS veya USB HID POS gibi klavye olmayan bir HID arabirimi kullanır. Bu arabirimler odaklı alana yazmaz. Normal bir web sayfası yerel bir SDK yükleyemez. Chromium, bir kullanıcı hareketinden sonra WebHID üzerinden bazı klavye olmayan HID aygıtlarını isteyebilir. Klavye sınıfı HID aygıtları engelli kalır, bu yüzden bir wedge okuyucu klavyeden ayırt edilemez. Bir üretici arabirimini kendi entegrasyonu olarak ele alın ve onu gerçekten o arabirimi açan yazılımla test edin.

Tarayıcının görebildikleri

Bir wedge taraması keydown ve keyup olayları olarak gelir ve yazdırılabilir karakterler odaklı alanı günceller. Tarayıcı bir aygıt adı, bir USB seri numarası veya okuyucu olduğunu söyleyen bir bayrak almaz. WebHID uygulayan tarayıcılar klavye arabirimlerini yine de reddeder, bu yüzden sayfa betiği bir wedge okuyucunun ham HID raporlarını da okuyamaz.

event.key, işletim sistemi etkin klavye düzenini uyguladıktan sonraki karakter veya tuş adıdır. event.code, Digit1 veya Numpad1 gibi fiziksel tuşu adlandırır ve bir düzen uyuşmazlığı event.key değerini değiştirdiğinde aynı kalabilir. İki özellik de donanımı tanıtmaz.

Fiziksel Bir Barkod Okuyucu Tarayıcıda Nasıl Test Edilir

Uygulama kodunda hata ayıklamadan önce bunu çalıştırın. Tarayıcının aldığı tam dizgiyi ve sonlandırıcıyı gösterir.

  1. Okuyucuyu bağlayın ve gücünün olduğunu gösterene kadar bekleyin. Bluetooth için eşleştirmeyi bitirin ve ana bilgisayarın bir klavye profili kullandığını doğrulayın.
  2. Giriş kipini doğrulayın. Keyboard wedge, USB HID klavye veya Bluetooth HID klavye bir alana yazabilir. Seri, SPP ve üretici SDK kipleri yazamaz.
  3. Barkod Giriş Test Aracı sayfasını açın.
  4. Testi başlat düğmesine tıklayın veya tarama alanına tıklayın. Hazır olduğunda maviye döner. Sayfa odağı kendiliğinden almaz.
  5. Yükünü zaten bildiğiniz bir barkodu tarayın. Kısa bir sayısal değerle başlayın, ardından uygulamanızın sakladığı noktalama işaretlerini içeren bir değeri tarayın.
  6. Yakalanan değeri ve karakter sayısını okuyun. İkisini de beklediğiniz yükle karşılaştırın; okuyucunun veriden önce eklediği bir ön ek varsa onu da katın.
  7. Soneki denetleyin. Test aracı ENTER, TAB veya Yok bildirir. Otomatik yakalama açıkken sonuç, tuşlar durduktan sonra Enter, Tab veya kısa bir duraklamanın ardından görünür. Yakalamanın Durdur düğmesine basana kadar tutulmasını istiyorsanız Otomatik yakalama seçeneğini kapatın.
  8. Bu sonucu uygulamanızın saklaması gereken dizgiyle karşılaştırın. Bir ön ek, değiştirilmiş bir karakter veya eksik bir sonlandırıcı okuyucu yapılandırmasında düzeltilmeli veya sayfada bilinçli olarak ele alınmalıdır. Bu karşılaştırma bitene kadar bunu bir çözme hatası saymayın.

Test aracı, tarayıcının görebildiği klavye olaylarını kaydeder. USB aygıtını tanıyamaz ve bir seri bağlantı noktasını okuyamaz. Bir metin düzenleyici taramayı alır da tarayıcı almazsa Okuyucu Notepad’de Çalışıyor ama POS’ta Çalışmıyor ile devam edin.

Barkod Okuyucu Girişini JavaScript ile Yakalama

Okuyucu, odağı olan öğeye yazar. Alana görünür bir etiket verin, klavye kullanıcıları bir kod yazabilsin diye onu normal bir metin girişi olarak bırakın ve iş akışı girişin tamamlandığını söylediğinde değeri okuyun. Aşağıdaki sayfa bunu yapar. Enter formu bir kez gönderir. Tab, boş olmayan bir değeri tamamlar ve ardından tarayıcının odağı taşımasına izin verir. Sonlandırıcısı olmayan bir tarama, birisi Look up düğmesini çalıştırana kadar alanda kalır.

<!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>

Bu dosyayı kaydedin ve bir masaüstü tarayıcısında açın. Odak kaydıysa alana tıklayın. Bir wedge okuyucu veya sonraki bölümdeki emülatör ardından #barcode alanına yazar.

Odak gerekir. document.activeElement belge gövdesi, bir düğme veya başka bir girişse bu alanın dinleyicileri taramayı görmez. Karakterler odaklı denetime düşer veya kaybolur. Bir iletişim kutusu kapandıktan sonra dahil, iş akışı taramaya hazır olduğunda field.focus() çağırın.

Boş giriş yok sayılır. Form yerinde kalır ve durum metni hiçbir şey alınmadığını söyler. Yalnızca boşluk, trim() sonrasında boştur.

Örnek Enter veya Tab eklemez. Okuyucu bunları gönderecek şekilde yapılandırılmamışsa değer alanda kalır ve tamamlanma yolu Look up olur. autocomplete="off", kayıtlı bir değerin taramayı değiştirmesi olasılığını azaltır. Etiket, düğme ve Shift+Tab kullanılabilir kalır; böylece bir kişi okuyucu olmadan kod girebilir.

Enter’ı tek bir yerde işleyin. Bu örnek, Look up düğmesini ve klavyedeki Enter’ı da kapsayan form submit olayını kullanır. Enter için ikinci bir keydown dinleyicisi aynı taramayı iki kez kaydeder. Giriş bir formun içinde değilse Enter’ı keydown üzerinde dinleyin ve bir üst formun da gönderilmemesi için preventDefault() çağırın:

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

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

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

Başarılı bir kabulden sonra alanı temizleyin; böylece sonraki tarama önceki yükün sonuna eklenmez. Enter’dan sonra örnek aynı alana yeniden odaklanır, çünkü bu iş akışı aynı kutuda başka bir tarama bekler. Tab’dan sonra odağı rahat bırakır; tarayıcı sonraki denetime geçebilir.

ENTER ve TAB Soneklerini İşleme

Sonek, okuyucunun yükten sonra gönderebileceği bir tuştur. Bu bir aygıt ayarıdır. Enter yaygındır ve isteğe bağlıdır. Barkod Okuyucularda ENTER ve TAB Sonekleri rehberi sonlandırıcıları nasıl ayırt edeceğinizi anlatır. Test ettiğiniz okuyucudaki ayarı doğrulayın, ardından sayfayı o iş akışına uydurun.

ENTER

Tek satırlık bir metin alanının içindeki Enter, güncel tarayıcılarda çevreleyen formu gönderir. Bir arama kutusunda olduğu gibi tek bir taramanın değeri işlemesi gerektiğinde bunu kullanın. submit olayında preventDefault() tarayıcının sayfadan ayrılmasını durdurur. Tam sayfa gezinmesi istediğiniz davranışsa bunu atlayın.

Barkod görünür de form hiçbir şey yapmazsa okuyucu sonek göndermiyor olabilir. Barkod Okuyucuda ENTER Eksik bu yapılandırmayı adım adım anlatır. Bazı aygıtlar NumPad Enter gönderir. event.key yine "Enter" olur. event.key değerini denetleyin; yalnızca event.code === "Enter" denetimine güvenmeyin, yoksa o okuyucu bozuk görünür.

TAB

Tab, odağı sonraki odaklanabilir denetime taşır. Bu, ürün kodu ardından miktar gibi bir diziye uyar. Enter ile gönderim bekleyen bir formu şaşırtır.

Alan hâlâ odaktayken değeri keydown içinde okuyun. Tarayıcı odağı bu olaydan sonra taşır. Sonraki denetim odağı almalıysa varsayılan eylemi yerinde bırakın. preventDefault() odağı olduğu yerde tutar; değer geçersizse ve operatörün bunu görmesini istiyorsanız yararlıdır. Bir klavye kullanıcısı formda geriye gidebilsin diye Shift+Tab’ı yok sayın. Bir okuyucu Tab soneki, Shift olmadan Tab’dır.

Dinleyici blur veya change üzerindeyse ve başka bir şey denetimi temizliyorsa, bir Tab soneki kodunuz alanı okumadan önce de odağı taşıyabilir. Değeri keydown olayının target öğesinden okuyun.

Sonek yok

Sonek yokken yük alanda durur. Taramanın ne zaman bittiğine uygulamanın karar vermesi gerekir. Açık bir düğme, operatörden daha sonra gelen bir Enter veya başka bir adıma geçmek güvenilir tamamlanma noktalarıdır. Bir hareketsizlik zamanlayıcısı, yazmadaki bir duraklamayı taramanın sonu sayabilir. Bu zamanlayıcı bir sezgiseldir. Yavaş bir okuyucu, bir Bluetooth gecikmesi veya hızlı yazan bir kişi eşiğin yanlış tarafına düşebilir. İş akışı kesin bir tarama sonu sinyali istiyorsa yapılandırılmış bir soneki tercih edin.

Yapılandırma farkları

Aynı markanın okuyucuları farklı soneklerle gelebilir ve bir yapılandırma barkodu, JavaScript’inizde hiçbir değişiklik olmadan soneki değiştirebilir. Bazı aygıtlar bir ön ek, ]C1 gibi bir semboloji tanımlayıcısı veya CR ve LF gönderir. Kullanıcılarınızın gerçekten seçebildiği üç sonlandırıcı ayarını test edin: Enter, Tab ve hiçbiri. Konuşlandırılan okuyucuların hangisini kullandığını kaydedin ve sayfayı o ayara karşı test edin.

Barkod Okuyucu Girişinin Doğrulanması

Alanın aldığı dizgiyi doğrulayın. Her barkodun aynı uzunlukta, aynı karakter kümesinde veya aynı sağlama toplamında olduğunu varsaymayın. Code 128 ve QR yükleri değişir. EAN-13 13 basamaktır. İkisini de saklayan bir uygulamanın ikisi için de kuralları olmalıdır.

Boş giriş. Reddedin veya yok sayın. Yüksüz bir sonek veya boş bir alanda Look up tıklaması kayıt oluşturmamalıdır.

Beklenmeyen karakterler. Alınan dizgiyi bilinen bir etiketle karşılaştırın. Bir düzen uyuşmazlığı çoğu zaman uzunluk aynı kalırken değişen bir simge olarak görünür; kaymış bir rakam veya noktalama gibi. Denetim karakterleri bir ön ekten veya bir GS1 grup ayırıcısından gelebilir. Biçiminizin tanımladığı karakterlere izin verin. Yukarıdaki örnek, ASCII denetim karakterlerini durum metninde görünür kalsınlar diye reddeder. Grup ayırıcı bekleyen bir GS1 ayrıştırıcısı o karaktere izin vermeli, geri kalanını reddetmelidir.

Uzunluk. Uygulamanızın kabul ettiği uzunlukları uygulayın. Form birden fazla semboloji aldığında genel bir alt ve üst sınır, tek bir zorunlu uzunluktan daha güvenlidir. Girişteki maxlength, daha uzun bir yükü sessizce keser; bu yüzden yalnızca kabul edilen her kod sığdığında ayarlayın.

Ön ek. Bir ön eki yalnızca okuyucuyu tam olarak o ön eki gönderecek şekilde yapılandırdıysanız ve uygulama onu saklamıyorsa ayıklayın.

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

Okuyucu AIM semboloji tanımlayıcısını iletecek şekilde ayarlıysa bu veri sayılır. Uygulamanın onu saklayıp saklamayacağına karar verene kadar yerinde bırakın.

Sonek. Sonlandırıcıyı saklanan değerin dışında tutun. Enter ve Tab tuştur. Normal bir metin girişine eklenmezler. Bir seri yük yine de CR veya LF baytları içerebilir. Bunları seri akışı ayrıştırdığınız sınırda ayıklayın ve meşru olarak içeren bir yükün ortasından ayıklamadığınızı test edin.

Yinelenen gönderimler. Aynı Enter için hem keydown hem submit çalışırsa bir tarama iki kez işlenebilir. Tek bir tamamlanma yolu kullanın. Aynı kodun ikinci bir taraması ayrı bir sorudur. Bir depo formu miktarı artırabilir. Bir bilet formu daha önce kullanılmış bir kodu reddedebilir. Bu kuralı uygulamaya koyun ve bilerek test edin. Tarayıcı, ikinci bir tetik çekimini ikinci bir dinleyiciden ayıramaz.

Uygulama kuralları. Sağlama toplamları belirli sembolojilere aittir. EAN-13 son basamağı denetim basamağı olarak kullanır. Bu işlev yalnızca o biçimi kabul eder:

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 ve QR bu hesabı kullanmaz. Okuyucu kendi sembolojisini zaten denetlemiş ve insan tarafından okunabilir veriyi iletmiş olabilir. Sakladığınız biçimleri doğrulayın ve denetimi sunucuda yineleyin. Gönderilen dizgi sıradan kullanıcı girişidir. Tarayıcı bunun bir okuyucudan geldiğini kanıtlayamaz.

Fiziksel Donanım Olmadan Barkod Okuyucu Girişini Test Etme

Barcode Scanner Emulator, Windows, macOS ve Linux için bir masaüstü uygulamasıdır. Gönderilecek metni girer, bir yazma gecikmesi seçer ve hiçbiri, ENTER veya TAB soneklerinden birini seçersiniz. Genel bir kısayol bu metni odaklı uygulamaya yazar. Bir wedge okuyucunun kullandığı klavye yolunu yeniden üretir. Bir etiketi aydınlatmaz, bir sembol okumaz ve bir semboloji çözmez.

Yukarıdaki örnek sayfayı veya oluşturduğunuz sayfayı kullanın:

  1. Sayfayı bir masaüstü tarayıcısında açın ve barkod alanına tıklayın.
  2. Emülatörde 123456789012 gibi bilinen bir değer girin.
  3. Soneki ENTER olarak ayarlayın. Patlamanın daha önce ölçtüğünüz bir okuyucuya benzemesini istiyorsanız yazma gecikmesini ayarlayın.
  4. Tarayıcı alanı hâlâ odaktayken emülatörün genel tarama kısayoluna basın.
  5. Durum metnini ve değerin bir kez kabul edildiğini doğrulayın.
  6. TAB ile yineleyin. Odak taşınmalı ve değer bir kez kabul edilmelidir.
  7. Sonek olmadan yineleyin. Look up düğmesini çalıştırana kadar metin alanda kalmalıdır.
  8. Barkod Giriş Test Aracı aracına odaklanın ve aynı değeri yeniden gönderin. Yakalanan dizgiyi, ön eki ve soneki uygulamanın sakladığı değerle karşılaştırın.

Kurulum ve ilk kısayol Başlarken bölümündedir. Bir ayar değişikliğinden sonra, uygulamadaki sonuca güvenmeden önce giriş test aracına bir tarama gönderin.

Testin optik ve aygıta özel kısımları için donanım hâlâ gerekir:

  • O okuyucunun basılı veya ekranda gösterilen sembolü, hasarlı etiketler, boyut, karşıtlık ve mesafe dahil, çözüp çözemediği.
  • Semboloji desteği. Bir 1D lazer okuyucu bir QR kodunu okuyamaz. Bkz. QR Kodu Testi: QR Okuyucuları Nasıl Test Edilir.
  • USB numaralandırma, Bluetooth eşleştirme ve okuyucunun kendi klavye düzeni ile sonek yapılandırması.
  • Seri, HID POS ve üretici SDK entegrasyonları.

Emülatör, klavye yolu boyunca uygulama mantığı için doğru araçtır. Belirli bir okuyucunun belirli bir etiketi okuduğunu kanıtlamak için yanlış araçtır.

Barkod Okuyucu Klavye Olaylarında Hata Ayıklama

Saklanan değer yanlış olduğunda olayları bu sırayla izleyin.

keydown. Enter ve Tab dahil her tuş için, tarayıcı bir karakter eklemeden veya odağı taşımadan önce tetiklenir. Sonlandırıcıyı burada okuyun. Bir tuş basılı tutulduğunda event.repeat doğrudur. Bir wedge okuyucu normalde her karakter için ayrı bir basış gönderir.

input. Yazdırılabilir bir karakter değerini değiştirdikten sonra alanda tetiklenir. Metin büyürken ona ihtiyacınız varsa izlenecek doğru olay budur. Enter veya Tab için tetiklenmez, çünkü bu tuşlar bir metin girişine karakter eklemez.

change. Değer işlendikten sonra, genellikle alan odağı yitirdiğinde tetiklenir. Odağı aynı alanda bırakan bir okuyucu taramanın sonunda change üretmez. change olayını tek tamamlanma sinyali olarak kullanmayın.

event.key ve event.code. Bir karakter yanlışsa ikisini de günlüğe yazın. Okuyucu düzeni ile işletim sistemi düzeni arasındaki uyuşmazlık event.key değerini değiştirir ve event.code değerini okuyucunun amaçladığı tuş gibi bırakır. Sayısal tuş takımındaki rakamlar Numpad1 ve benzeri kodları kullanır. Bazı giriş maskeleri bunları Digit1 değerinden farklı işler. Barkod Okuyucuda Yanlış Klavye Düzeni düzen uyuşmazlığını açıklar.

Odak. Bir taramadan hemen önce document.activeElement değerini günlüğe yazın. Barkod alanı değilse izin geri kalanı yanlış denetimi açıklıyordur. Iframe’lerin kendi odağı vardır. Gömülü bir çerçeveye yapılan tarama, o çerçevenin içindeki betiğe görünür.

Zamanlama. Okuyucular kısa bir yükü çoğu zaman bir saniyenin çok altında bitirir. Giriş test aracı, karakterler arasındaki ortalama aralığı 100 ms eşiğiyle karşılaştırır ve sonucu zamanlama olarak etiketler, donanım tanıması olarak değil. Bir aralık eşiği hızlı yazan birini, otomatik doldurmayı veya emülatörü okuyucu sayabilir. Karakterler arası gecikmesi olan bir okuyucu, bir Bluetooth bağlantısı veya uzun bir yük yazma gibi görünebilir. Yakalanan değeri ve soneki kullanın. Zamanlamayı bir ipucu olarak kullanın.

Klavye Olayı Test Aracı her keydown ve keyup olayını key, code, değiştiriciler ve zaman damgalarıyla listeler. Birleştirilmiş dizgi bir ön ek tuşunu veya bir numpad kodunu gizlediğinde bunu kullanın. Günlük tarayıcı olaylarıdır. Ham USB trafiği değildir.

Web Uygulamalarında Sık Karşılaşılan Sorunlar

Tarama yanlış alana gider. Wedge girişi odağı izler. Odağı taşıyan her gezinme, iletişim kutusu veya doğrulama iletisinden sonra hedef alana tıklayın. Metin alanı olmayan bir kalıcı pencere, taramayı kısayol tuşları olarak yutabilir.

Okuyucu bir metin düzenleyicide çalışır, tarayıcıda çalışmaz. Aygıt yazıyordur. Sayfa bu tuşları kabul etmiyordur. Odağı, devre dışı veya salt okunur bir girişi ve yazdırılabilir tuşlarda preventDefault() çağıran bir keydown dinleyicisini denetleyin. Yalnızca paste işleyen bir dinleyici wedge girişini hiç görmez. Hiçbir uygulama karakter almıyorsa Barkod Okuyucu Çalışmıyor ile başlayın.

Enter formu iki kez gönderir veya sayfadan uzaklaşır. Tarayıcı formu gönderir ve dinleyiciniz de Enter’ı işler. Bu yollardan birinde preventDefault() çağırın ve değeri bir kez işleyin. Okuyucu Enter gönderdiğinde çok alanlı bir form, sonraki alanlar dolmadan gönderilebilir. Bu iş akışı için Tab kullanın veya form tamamlanana kadar gönderimi engelleyin.

Tab odağı değiştirir. Bu Tab tuşudur. Okuyucuda Enter yapılandırın veya değeri keydown içinde okuyup odak taşınmasına izin verin. Yukarıdaki sonek bölümüne bakın.

Klavye düzeni yanlıştır. Rakamlar, noktalama işaretlerini değiştiren bir uyuşmazlıktan sağ çıkabilir. Sakladığınız simgeleri içeren bilinen bir değeri, iş istasyonunun gerçekten kullandığı düzende tarayın.

Aynı tarama iki kayıt oluşturur. İki fiziksel tarama aramadan önce bir Enter üzerinde iki dinleyici arayın. Ardından bilinçli bir ikinci taramayı test edin ve uygulamanızın belgelediği miktar veya yineleme kuralını doğrulayın.

Değer eksik veya kesiktir. Bir maxlength özniteliği, bir giriş maskesi veya karakter tuşlarında preventDefault() yükü düşürebilir veya kesebilir. Giriş test aracındaki karakter sayısını alanınızdaki değerle karşılaştırın. Bir ön ek de doğru bir yükü fazla uzun gösterebilir.

QR kodları hiç görünmez. Okuyucu yalnızca 1D olabilir veya QR sembolojisi kapalı olabilir. Uygulama bunu düzeltemez. Donanımı QR Kodu Testi: QR Okuyucuları Nasıl Test Edilir ile doğrulayın, ardından alan testine dönün.

Web Uygulaması Test Kontrol Listesi

Bunu, yayınlamayı düşündüğünüz derlemede, desteklediğiniz her tarayıcıda kullanın. Parola yöneticisi ve otomatik doldurma uzantıları odağı taşıdığı için yeni bir profilin yanı sıra bu uzantıların yüklü olduğu bir profili de denetleyin.

  • Okuyucu bağlı veya eşleştirilmiş ve ana bilgisayar onu hazır gösteriyor.
  • Okuyucu keyboard-wedge kipinde; seri veya bir üretici SDK kipinde değil.
  • Barkod alanı taramadan hemen önce odaklı. document.activeElement o alandır.
  • Bilinen bir barkod, uzunluk dahil, karakter karakter geliyor.
  • Bir ENTER soneki değeri bir kez gönderiyor veya kabul ediyor ve sonlandırıcıyı saklanan dizgide bırakmıyor.
  • Bir TAB soneki odağı amaçladığınız denetime taşıyor ve değer taşımadan önce okunuyor.
  • Soneksiz bir yapılandırma, uygulama onu tamamlayana kadar değeri kullanılabilir bırakıyor.
  • Boş bir gönderim reddediliyor veya yok sayılıyor.
  • Bir tarama iki kayıt oluşturmuyor. Gerçek bir ikinci tarama, uygulamanın yineleme kuralını izliyor.
  • Noktalama, simgeler ve biçimlerinizin kullandığı herhangi bir GS1 ayırıcı gidiş dönüşten sağ çıkıyor.
  • Okuyucu klavye düzeni ve işletim sistemi düzeni, etikette basılı karakterleri üretiyor.
  • Fiş çekilip yeniden takıldıktan veya Bluetooth bağlantısı düştükten sonra sonraki tarama hâlâ alana ulaşıyor.
  • Art arda birkaç tarama ayrı değerler olarak kalıyor. Alan onları birleştirmiyor.
  • Aynı denetimler, yaygın otomatik doldurma uzantılarıyla ve onlarsız, desteklediğiniz tarayıcılarda geçiyor.

İletişim kutuları, bir ödemenin tamamındaki sekme sırası ve POS miktar akışları için Barkod Okuyucu Girişi Nasıl Test Edilir rehberine devam edin.

Test Senaryosu Matrisi

Okuyucu sütunu, aygıtın ve tarayıcının ne yaptığıdır. Beklenen davranış sütunu, uygulamanın buna yanıt olarak ne yapması gerektiğidir. Yinelenen bir ürün kodunun miktarı artırması gibi iş kuralları uygulamaya aittir. Her ürün için tek bir kural varsaymak yerine bunları testte belirtin.

Senaryo Beklenen davranış
Geçerli barkod Uygulama değeri kabul eder ve yükü sonlandırıcı olmadan saklar.
Boş giriş Uygulama bunu reddeder veya yok sayar ve kayıt oluşturmaz.
ENTER soneki Uygulama değeri bir kez gönderir veya kabul eder.
TAB soneki Odak amaçlanan sonraki denetime taşınır ve değer tutulur.
Sonek yok Giriş, uygulama onu işleyene kadar kullanılabilir kalır.
Hızlı art arda taramalar Her değer ayrı işlenir ve bir öncekiyle birleştirilmez.
Yanlış klavye düzeni Beklenmeyen karakterler yakalanan değerde görünür ve doğrulamada başarısız olur.
Yinelenen tarama Uygulama kendi yineleme kuralını izler; örneğin miktarı artırır veya bir tekrarı reddeder.
Geçersiz barkod biçimi Uygulama o biçim için doğrulama hatasını gösterir ve değeri saklamaz.
Kaybolan giriş odağı Uygulama bir barkod uydurmaz. Tarama yoktur veya odaklı denetime düşer ve sayfa güvenli bir durumda kalır.

Geçerli, boş, ENTER, TAB ve soneksiz satırları fiziksel okuyucuyla ve bir kez de emülatörle çalıştırın. Klavye düzeni, QR ve yeniden bağlanma satırlarını donanımda çalıştırın. Bu satırlar aygıta, etikete veya işletim sistemi düzenine bağlıdır; benzetilmiş tuş vuruşları bunları yeniden üretmez.