Barcode Scanner Emulator
Web Uygulamalarında QR Okuyucu Girişi Nasıl Test Edilir
Birçok harici QR okuyabilen okuyucu keyboard wedge kipini kullanır ve çözülen QR metnini odaklı alana yazar. Bu yolu, bilinen bir yükü tarayıp sayfanın aldığı değerle karşılaştırarak test edin. Her QR okuyucu bir klavye gibi yazmaz. Seri aygıtlar ve kamera çözücüleri ayrı entegrasyonlardır ve tarayıcı klavye olayları fiziksel okuyucuyu tanıtmaz.
Bir QR kodu veri saklar. Okuyucu veya bir kamera çözücüsü bu veriyi metne çevirir. Web uygulaması bu metni almalı, taramanın ne zaman bittiğine karar vermeli ve metni doğrulamalıdır. Bu rehber o uygulama testidir. Etiket üretmek, kontrastı kontrol etmek ve bir aygıtın QR Code çözebildiğini doğrulamak QR Kodu Testi: QR Okuyucuları Nasıl Test Edilir sayfasındadır. EAN kontrol basamakları dahil genel barkod formları Web Uygulamalarında Barkod Okuyucular Nasıl Test Edilir rehberindedir.
60 Saniyede QR Okuyucu Girişini Test Edin
Yanlış bir karakter belli olsun diye kendi seçtiğiniz bir yük kullanın. Bu anlatım QR-INPUT-TEST-12345 kullanır.
- QR Kodu Oluşturucu aracını açın ve
QR-INPUT-TEST-12345için bir QR kodu oluşturun. Oluşturucu tarayıcıda çalışır. Okuyucuyla iletişim kurmaz. - Keyboard wedge kipine ayarlı, QR okuyabilen bir okuyucu bağlayın. Yalnızca 1B okuyan bir okuyucu bu sembolü çözemez.
- Barkod Giriş Test Aracı sayfasını açın.
- Alan odağı alsın diye Testi başlat düğmesine tıklayın veya tarama alanına tıklayın. Test aracı odağı kendiliğinden almaz ve okuyucuyu açmaz.
- QR kodunu tarayın.
- Yakalanan metni ve karakter sayısını okuyun.
- Bu metni
QR-INPUT-TEST-12345ile karşılaştırın. Eşleşme büyük-küçük harfi, kısa çizgileri ve uzunluğu kapsar. - Soneki okuyun. Okuyucu bu tuşlardan birini gönderdiğinde test aracı ENTER, TAB veya Yok bildirir.
Test aracı, tarayıcının görebildiği klavye olaylarını kaydeder. USB aygıtını tanımaz, bir seri bağlantı noktasını okumaz ve QR görüntüsünü çözmez.
QR Okuyucu Giriş Kipleri
Aynı basılı QR kodu üç farklı entegrasyondan gelebilir. Bir kipin testi diğerlerini çalıştırmaz.
Keyboard wedge QR okuyucuları
USB HID klavye kipinde veya Bluetooth HID klavye kipinde işletim sistemi okuyucuyu bir klavye olarak görür. Çözümden sonra okuyucu yükü, odağı olan denetime yazar. Normal bir <input> veya <textarea> bunu alabilir. Sayfa aygıtı açmaz. HID Keyboard Wedge rehberi tuş vuruşu sırasını, ön ekleri ve sonekleri anlatır.
Hedefi odak belirler. Odaklı öğe belge gövdesi, bir düğme veya başka bir çerçeveyse bu alanın dinleyicileri taramayı görmez.
Seri QR okuyucuları
USB seri veya sanal COM bağlantı noktası okuyucusu, çözülen metni bağlantı noktasını açan sürece bayt olarak gönderir. O süreci odak seçmez. Yalnızca tuş vuruşlarını dinleyen bir alan boş kalırken o bağlantı noktasındaki bir terminal yükü gösterir.
Chromium tabanlı tarayıcılar, güvenli bir bağlamda ve bir kullanıcı hareketinden sonra, kullanıcının seçtiği bağlantı noktasını Web Serial API ile açabilir. Firefox ve Safari bu API’yi sunmaz. Bir wedge okuyucu seri bağlantı noktası olarak görünmez. Bağlantı noktası adları, baud ve çerçeveleme aygıta ve sürücüye bağlıdır. USB HID ve Seri Barkod Okuyucular iki arabirimi karşılaştırır. Barkod Giriş Test Aracı bir COM bağlantı noktasını okuyamaz.
Kamera tabanlı QR okuma
Kamera entegrasyonu bir görüntü yakalar ve QR kodunu yazılımda çözer. Sayfa bir kamera API’si ve bir çözücü kullanır. Yük için keydown olayları almaz. Telefon kamerası uygulamaları, sayfa içindeki kamera düğmeleri ve bir alana yazan donanım görüntüleyicisi üç ayrı üründür. Bir wedge testini geçmek kamera düğmesinin çalıştığı anlamına gelmez ve başarılı bir kamera çözümü, bir wedge okuyucunun aynı dizgiyi yazacağı anlamına gelmez.
QR Okuyucu Girişini JavaScript ile Yakalama
Aşağıdaki sayfa odaklı tek bir alanı okur. Enter formu gönderir ve Accept düğmesi aynı submit işleyicisini kullanır, böylece bir tarama bir kez işlenir. ENTER soneki yoksa metin, birisi Accept düğmesini çalıştırana kadar alanda kalır. Yakalanan yük textContent ile yazılır, bu yüzden < gibi karakterler metin olarak görünür kalır.
Örnek üç uygulama biçimini kabul eder: QR-INPUT-TEST-12345 gibi bir bilet kimliği, bir http veya https URL ya da bir JSON nesnesi. Taranan metni kaydeder. QR kodunda bulunan bir URL’ye gitmez. Enter göndermeyen bir okuyucu yine düğme üzerinden çalışır. Betik Tab tuşunu yakalamadığı için Tab, etiketin, alanın ve düğmenin üzerinden her zamanki gibi geçer.
<!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>
Dosyayı kaydedin ve bir masaüstü tarayıcıda açın. Taramadan önce alana tıklayın. autocomplete="off", kayıtlı bir değerin taramanın yerine geçme olasılığını azaltır. Etiket ve düğme durur, böylece bir kişi okuyucu olmadan yük yazabilir.
Enter tuşunu yalnızca formun submit olayında işleyin. Enter için ikinci bir keydown dinleyicisi aynı taramayı iki kez kaydeder. preventDefault() tarayıcıyı bu sayfada tutar. Bir sonraki tarama önceki metne eklenmesin diye karardan sonra alanı temizleyin.
Bir QR yükü satır sonu içerebilir. Bir wedge okuyucu bu sonu çoğu zaman Enter olarak yazar. Tek satırlık bir inputta form ilk satırda gönderilebilir ve gerisi düşer. Uygulama çok satırlı metni kabul etmeliyse bir textarea veya baytları saklayan bir seri okuyucu kullanın. Bu davranışı, yükünde satır sonu bulunan bir QR koduyla doğrulayın.
QR Yüklerini İşleme
Bir QR sembolü bir uygulama biçimi vaat etmez. Aynı semboloji şunlardan herhangi birini taşıyabilir:
QR-INPUT-TEST-12345gibi düz metin.- Bir URL.
- Uygulamanın seçtiği bir tanımlayıcı.
- Bilet numarası artı bir konum kodu gibi yapılandırılmış bir yük.
- Uygulama bu kodlamayı tanımladıysa JSON metni.
Okuyucu çözülen karakterleri iletir. Bunların bir bilet kuralına, bir ürün kataloğuna veya bir JSON şemasına uyup uymadığını denetlemez. Dizgiyi sayfada doğrulayın ve sunucuda yeniden doğrulayın. Gönderilen değer sıradan kullanıcı girdisidir. Tarayıcı bunun bir okuyucudan geldiğini kanıtlayamaz.
QR Girişini Doğrulama
Bir QR yükünün sayısal olduğunu varsaymayın. EAN-13 kuralları uygulanmaz. Metni güvenilmez sayın: metin olarak gösterin ve onu location, innerHTML veya bir betik URL’sine atamayın.
Boş değerler. Yalın bir Enter veya boş bir alanda Accept kayıt oluşturmamalıdır. trim() yalnızca boşluklardan oluşan bir yükü de reddeder.
Beklenmeyen karakterler. Alınan dizgiyi bilinen QR içeriğiyle karşılaştırın. Klavye düzeni uyuşmazlığı çoğu zaman uzunluk aynı kalırken noktalama işaretlerini değiştirir. Biçimin izin vermediği karakterleri reddedin ve nedeni durum metninde gösterin.
Yük uzunluğu. Uygulamanızın sakladığı üst sınırı uygulayın. Input üzerindeki maxlength, daha uzun bir taramayı hata olmadan keser. Bunu yalnızca kabul edilen her yük sığdığında ayarlayın ve bir değer kısa göründüğünde test aracının karakter sayısını alanla karşılaştırın.
Gerekli ön ekler. Ön ek denetimi uygulamaya aittir. Bu bilet kuralı QR- artı büyük harf, rakam ve kısa çizgi kabul eder:
function isTicketId(value) {
return /^QR-[A-Z0-9-]{1,64}$/.test(value)
}
Bir okuyucu ön ekini yalnızca o okuyucu tam olarak bir ön ek gönderecek şekilde yapılandırıldıysa ve uygulama onu saklamıyorsa ayıklayın. Bir AIM semboloji tanımlayıcısı, siz aksine karar verene kadar veridir.
Uygulamaya özel biçimler. Kuralı biçimin yanında tutun. Bir bilet formu, bir URL izin listesi ve bir JSON nesnesi farklı denetimler ister. Tek bir sayısal desen geçerli QR metnini reddeder.
Yinelenen taramalar. Bir fiziksel tarama iki dinleyiciye çarpabilir. Örnekteki gibi tek bir tamamlanma yolu kullanın. İkinci bir tetik çekimi ayrı bir olaydır. Örnek, daha önce kabul ettiği bir yükü reddeder. Bir depo formu bunun yerine miktarı artırabilir. Uygulamanızın belgelediği kuralı test edin.
Bozuk JSON. JSON.parse eksik metinde fırlatır. Başarılı bir ayrıştırmadan sonra şekli denetleyin. Bir dizi veya yalın bir sayı geçerli JSON olabilir ve yine de yanlış tür olabilir:
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.' }
}
}
Beklenmeyen URL’ler. URL’nin kullanılabilir olup olmadığını görmek için onu ayrıştırın, ardından test QR yüküyle birebir eşleşmeliyse taranan dizgiyi saklayın. URL.href bir eğik çizgi ekleyebilir veya kodlamayı değiştirebilir. Yalnızca uygulamanın amaçladığı şemaları kabul edin. URL’yi taramanın yan etkisi olarak açmayın:
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 }
}
Kontrol karakterleri. Gizli bir ön ek durum metninde görünür kalsın diye bir klavye yükündeki ASCII kontrol karakterlerini reddedin. CR ve LF kontrol karakterleridir. Bir wedge okuyucuda Enter ve Tab tuştur. Normal bir metin inputunun içinde karakter değildirler. Bir seri yük yine 0x0D veya 0x0A baytları içerebilir. Bunları seri çerçeveleme sınırında ayıklayın ve çok satırlı bir yükün ortasına ait bir CR’yi silmeyin.
ENTER ve TAB Sonekleri
Sonek, isteğe bağlı okuyucu yapılandırmasıdır. QR sembolünün parçası değildir. Barkod Okuyucularda ENTER ve TAB Sonekleri tuşların nasıl ayırt edileceğini gösterir. Soneki giriş test aracında okuyun, ardından sayfayı konuşlandırdığınız okuyuculara uydurun.
ENTER güncel tarayıcılarda tek satırlık bir metin alanının formunu gönderir. Bir taramanın değeri işlemesi gerektiğinde bunu kullanın. Sayfa yerinde kalmalıysa submit üzerinde preventDefault() çağırın.
TAB odağı sonraki denetime taşır. Alan hâlâ odaktayken değeri keydown içinde okuyun. Sonraki alan odağı almalıysa varsayılan eylemi yerinde bırakın. Klavye kullanıcısı geri gidebilsin diye Shift+Tab tuşunu yok sayın.
Sonek yok yükü alanda bırakır. Örnekteki Accept düğmesi tamamlanma yoludur. Bir hareketsizlik zamanlayıcısı, bir duraklamanın taramanın bittiği anlamına geldiğini tahmin edebilir. Bu zamanlayıcı bir sezgiseldir: yavaş bir Bluetooth patlaması ve hızlı yazan bir kişi aynı aralığı aşabilir. İş akışı kesin bir bitiş istiyorsa yapılandırılmış bir sonek tercih edin.
CR ve LF bayttır. Bir klavye Enter tuşu event.key === "Enter" değeridir. Bunlar birbirinin yerine geçmez. Bir input değerinden yalnızca \r ayıklayan bir dinleyici wedge Enter tuşunu görmez, çünkü karakter hiç eklenmemiştir. Yalnızca event.key izleyen bir dinleyici bir seri tamponu 0x0D üzerinde bölmez. Bazı aygıtlar NumPad Enter gönderir. event.key yine "Enter" olur. Yalnızca event.code === "Enter" değil, event.key değerini denetleyin.
Birisi aygıt kılavuzundan bir yapılandırma barkodu taradığında sonek değişebilir. Her yapılandırma değişikliğinden sonra Enter, Tab ve sonek yok durumlarını yeniden test edin. Bir programlama barkodu uydurmayın. O modelin kılavuzunu kullanın.
Klavye Olaylarında Hata Ayıklama
Saklanan metin yanlışsa olayları bu sırayla inceleyin.
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.
input. Yazdırılabilir bir karakter alanı değiştirdikten sonra tetiklenir. Bir metin inputunda Enter veya Tab için tetiklenmez.
event.key. İşletim sistemi klavye düzenini uyguladıktan sonraki karakter veya tuş adı.
event.code. Digit1 veya Numpad1 gibi fiziksel tuş. Bir düzen uyuşmazlığı event.key değerini değiştirdiğinde aynı kalabilir.
Odak. Taramadan önce document.activeElement değerini günlüğe yazın. QR alanı değilse izin geri kalanı yanlış denetimi anlatır. Bir iframe’in kendi odağı vardır.
Sıra. Bir metin alanına wedge taramasında yazdırılabilir keydown olaylarını input güncellemeleri izler, ardından o sonek yapılandırıldıysa Enter veya Tab için son bir keydown gelir. change, alan değerini işlediğinde, genellikle bulanıklaşınca tetiklenir. Odağı aynı alanda bırakan bir tarama sonunda change üretmez. change olayını tek tamamlanma sinyali olarak kullanmayın.
Zamanlama. Okuyucular kısa bir yükü çoğu zaman bir saniyenin oldukça 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ımı olarak değil. Hızlı yazan bir kişi, otomatik doldurma veya emülatör bu eşiğin okuyucu tarafına düşebilir. Gecikmeli bir Bluetooth taraması yazmaya benzeyebilir. Yükü ve soneki doğrulayın. Zamanlamayı bir ipucu olarak görün.
Klavye Olayı Test Aracı her keydown ve keyup olayını key, code, değiştiriciler ve zaman damgalarıyla listeler. Günlük tarayıcı olaylarıdır. Ham USB trafiği değildir.
Fiziksel Bir QR Okuyucu Olmadan Test
Uygulama mantığı, okuyucu masaya gelmeden test edilebilir.
QR-INPUT-TEST-12345değerini alana yazın ve Accept düğmesini çalıştırın. Bu, doğrulamayı ve gösterimi denetler. Çözmeyi veya sonekleri denetlemez.- Sonraki bölümdeki gibi aynı alanı bir tarayıcı otomasyon aracıyla sürün.
- Okuyucu tarzı yazmaya ihtiyacınız olduğunda Barcode Scanner Emulator kullanın. Masaüstü uygulaması, girdiğiniz bir değeri, bir yazma gecikmesiyle ve hiçbiri, ENTER veya TAB sonekiyle odaklı uygulamaya gönderir. Klavye yolunu yeniden üretir. Bir QR görüntüsünü fotoğraflamaz, bir sembolü çözmez ve sanal bir COM bağlantı noktası oluşturmaz.
Optik ve aygıt davranışı için donanım hâlâ gerekir: o okuyucunun gösterilen veya basılan kodu okuyup okuyamadığı, QR sembolojisinin açık olup olmadığı, klavye düzeni, sonek yapılandırması ve seri veya üretici SDK kipleri. Emülatör klavye yolu için doğru denetimdir. Bir aygıtın belirli bir QR kodunu okuduğunu kanıtlamak için yanlış denetimdir.
QR Giriş Testlerini Otomatikleştirme
Aşağıdaki Playwright testleri örnek sayfayı sürer. Bir wedge okuyucunun yazacağı gibi alana yazar, ardından uygulama davranışını doğrular. USB aygıtlarını açmazlar. @playwright/test, bu rehberi uygulayan kişinin bağımlılığıdır. Bu site onu gerektirmez.
HTML örneğini bu testin yanına qr-form.html olarak kaydedin.
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 karakterleri odaklı alana ekler. Bir USB aygıtı değildir. Beklenmeyen karakter testi fill kullanır, çünkü amaç doğrulama iletisi ve enjekte edilmiş bir öğenin yokluğudur. Bu biçimler dağıttığınız derlemedeyse dosyayı bir URL durumu ve bir JSON durumuyla genişletin. Bir URL doğrulaması, yakalanan metni özgün QR dizgisiyle karşılaştırmalıdır.
QR Okuyucu Test Matrisi
Bunları test altındaki uygulamaya karşı çalıştırın. Yukarıdaki örnek sayfa bilet, URL, JSON, yineleme, boş ve beklenmeyen karakter satırlarını kapsar. Yalnızca sayısal veya çok satırlı bir uygulamanın kendi beklenen sonucu gerekir.
| Senaryo | Beklenen sonuç |
|---|---|
| Düz metin QR | Tam değer alındı |
| URL QR | URL’nin tamamı yakalandı ve sayfa ona gitmedi |
| Sayısal QR | Rakamlar korundu |
| Özel karakterler | Doğru karakterler alındı |
| JSON yükü | Veri yakalandı ve doğrulandı |
| ENTER soneki | İşleme bir kez gerçekleşir |
| TAB soneki | Odak davranışı ele alındı |
| Sonek yok | Uygulama alternatif bir tamamlanma yolu kullanır |
| Yinelenen tarama | Uygulama yineleme kurallarını uygular |
| Geçersiz yük | Doğrulama hatası gösterilir |
| Eksik odak | Uygulama olmayan girdiyi güvenle ele alır |
| Uzun yük | İstenmeyen kesilme yok |
Ürün bir satır sonunu saklamalıysa satır sonu içeren bir yükü de tarayın. Alanın her satırı alıp almadığını kaydedin.
Sorun Giderme
Giriş test aracında bilinen bir yükle başlayın. Test aracının değeri baştan yanlışsa ilk arıza sayfa değildir. Test aracının değeri doğru ve uygulama yanlışsa arıza odak, doğrulama veya olay işlemedir. Barkod Okuyucu Çalışmıyor daha geniş aygıt kontrol listesidir. Barkod Okuyucu Girişi Nasıl Test Edilir bu formun ötesinde odak, düzen ve POS akışlarını kapsar.
Okuyucu bip sesi çıkarır ama giriş görünmez
Bir bip sesi genellikle okuyucunun bir sembolü çözdüğü anlamına gelir. Sayfanın metni aldığı anlamına gelmez. Keyboard wedge kipini doğrulayın. Seri ve kamera kipleri alana yazmaz. document.activeElement o input olsun diye alana tıklayın, ardından yeniden tarayın. Devre dışı, salt okunur veya gizli bir alan tuşları yok sayabilir.
QR okuyucu Notepad’de çalışır ama tarayıcıda çalışmaz
Aygıt yazıyordur. Sayfa bu tuşları kabul etmiyordur. Odağı, yazdırılabilir tuşlarda preventDefault() çağıran bir keydown dinleyicisini ve yalnızca paste işleyen bir dinleyiciyi kontrol edin. Wedge girişi bir paste olayı tetiklemez. Test aracı sonucunu uygulama alanıyla karşılaştırın.
Okuyucu barkodları okur ama QR kodlarını okumaz
Aygıt yalnızca 1B olabilir veya QR sembolojisi kapalı olabilir. Sayfa bunu düzeltemez. 2B desteğini doğrulayın ve QR Kodu Testi: QR Okuyucuları Nasıl Test Edilir içindeki denetimlerle aygıt kılavuzundan QR Code sembolojisini açın. Başarılı bir Code 128 taraması yalnızca klavye yolunu kanıtlar.
Yanlış karakterler
Önce QR-INPUT-TEST-12345 tarayın. O eşleşiyor da bir URL veya JSON yükü eşleşmiyorsa düzen :, /, { veya " gibi noktalama işaretlerini değiştiriyordur. Klavye Olayı Test Aracı içinde event.key ile event.code değerlerini karşılaştırın ve Barkod Okuyucuda Yanlış Klavye Düzeni sayfasına bakın. Okuyucunun klavye düzenini işletim sistemiyle eşleştirin.
ENTER formu iki kez gönderir
Tarayıcı formu gönderir ve bir keydown dinleyicisi de Enter tuşunu işler. Tek bir tamamlanma yolu bırakın ve preventDefault() çağrısını orada yapın. İkinci bir fiziksel tarama ayrı bir arızadır. Örnekteki durum metni yükün zaten kabul edildiğini söyler. İlk taramanın kendisi iki kayıt oluşturuyorsa okuyucuyu değiştirmeden önce iki dinleyici arayın.
QR girişi kesilir
Giriş test aracındaki karakter sayısını alandaki değerle karşılaştırın. Bir maxlength özniteliği, bir giriş maskesi veya karakter tuşlarında preventDefault() dizgiyi kesebilir. QR yükünün içindeki bir satır sonu tek satırlık bir inputu erken gönderebilir. Bazı okuyucular kaç karakter yazacaklarını da sınırlar. Test aracı, yalnızca uygulama değil, kısa bir değer gösterdiğinde bu sınırı aygıt kılavuzundan yükseltin. Barkod Okuyucuda ENTER Eksik yükün geldiği ve formun hiç işlenmediği ilgili durumu kapsar.
Okuyucu ekrandaki bir QR kodunu okuyamaz
Okuyucunun 2B görüntüleyici olduğunu doğrulayın. Ekran parlaklığını artırın, kod boyutunu büyütün ve sessiz bölgeyi metinden ve kenarlıklardan uzak tutun. Parlama, loş bir telefon ekranı ve çalışma mesafesi için fazla sıkışık bir kod optik sorunlardır. Ekrandan okuma başarısız kalırsa aynı yükü yazdırın. Herhangi bir tarama metin ürettikten sonra uygulama testi yine bilinen dizgiyi kullanır.