رفتن به محتوا

Barcode Scanner Emulator

چگونه ورودی اسکنر کد QR را در برنامه‌های وب بیازماییم

بسیاری از اسکنرهای خارجی قادر به QR از حالت گوه‌کلید استفاده می‌کنند و متن رمزگشایی‌شده QR را در فیلد متمرکز تایپ می‌کنند. آن مسیر را با اسکن یک محموله شناخته‌شده و مقایسه آن با مقداری که صفحه دریافت کرده بیازمایید. هر اسکنر QR مانند صفحه‌کلید تایپ نمی‌کند. دستگاه‌های سریال و رمزگشاهای دوربین یکپارچه‌سازی‌های جدا هستند، و رویدادهای صفحه‌کلید مرورگر اسکنر فیزیکی را شناسایی نمی‌کنند.

کد QR داده ذخیره می‌کند. اسکنر، یا رمزگشای دوربین، آن داده را به متن تبدیل می‌کند. برنامه وب سپس باید آن متن را دریافت کند، تشخیص دهد اسکن کی تمام شده، و آن را اعتبارسنجی کند. این راهنما همان آزمون برنامه است. ساخت برچسب، بررسی کنتراست، و تأیید اینکه دستگاه می‌تواند QR Code را رمزگشایی کند در آزمون کد QR: چگونه اسکنرهای کد QR را بیازماییم آمده است. فرم‌های عمومی بارکد، از جمله رقم کنترل EAN، در چگونه اسکنرهای بارکد را در برنامه‌های وب بیازماییم آمده است.

آزمون ورودی اسکنر QR در ۶۰ ثانیه

از محموله‌ای استفاده کنید که خودتان انتخاب کرده‌اید تا نویسه نادرست آشکار باشد. این راهنمای گام‌به‌گام از QR-INPUT-TEST-12345 استفاده می‌کند.

  1. سازنده کد QR را باز کنید و برای QR-INPUT-TEST-12345 یک کد QR بسازید. سازنده در مرورگر اجرا می‌شود. با اسکنر تماس نمی‌گیرد.
  2. اسکنر قادر به QR را وصل کنید که روی حالت گوه‌کلید تنظیم شده است. اسکنر فقط یک‌بعدی نمی‌تواند این نماد را رمزگشایی کند.
  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 توضیح داده‌شده دنباله ضربه‌کلید، پیشوندها و پسوندها را شرح می‌دهد.

فوکوس مقصد را تعیین می‌کند. اگر عنصر متمرکز بدنه سند، یک دکمه یا قاب دیگری باشد، شنونده‌های این فیلد اسکن را نمی‌بینند.

اسکنرهای QR سریال

اسکنر سریال USB یا درگاه COM مجازی متن رمزگشایی‌شده را به‌صورت بایت به فرایندی می‌فرستد که درگاه را باز کرده است. فوکوس آن فرایند را انتخاب نمی‌کند. فیلدی که فقط به ضربه‌کلید گوش می‌دهد خالی می‌ماند، در حالی که پایانه روی آن درگاه محموله را نشان می‌دهد.

مرورگرهای مبتنی بر Chromium می‌توانند در زمینه امن و پس از حرکت کاربر، درگاهی را که کاربر انتخاب کرده با Web Serial API باز کنند. Firefox و Safari آن API را ندارند. اسکنر گوه به‌صورت درگاه سریال ظاهر نمی‌شود. نام درگاه، نرخ باود و قالب‌بندی به دستگاه و راه‌انداز بستگی دارد. اسکنر بارکد USB HID در برابر سریال دو رابط را مقایسه می‌کند. آزمایشگر ورودی بارکد نمی‌تواند درگاه COM را بخواند.

اسکن QR مبتنی بر دوربین

یکپارچه‌سازی دوربین تصویری می‌گیرد و کد QR را در نرم‌افزار رمزگشایی می‌کند. صفحه از API دوربین و یک رمزگشا استفاده می‌کند. برای محموله رویداد keydown دریافت نمی‌کند. برنامه‌های دوربین تلفن، دکمه‌های دوربین داخل صفحه، و تصویربردار سخت‌افزاری که در فیلد تایپ می‌کند سه محصول متفاوت‌اند. گذراندن آزمون گوه به معنای کار کردن دکمه دوربین نیست، و رمزگشایی موفق دوربین به معنای آن نیست که اسکنر گوه همان رشته را تایپ خواهد کرد.

گرفتن ورودی اسکنر QR با JavaScript

صفحه زیر یک فیلد متمرکز را می‌خواند. Enter فرم را می‌فرستد، و دکمه Accept از همان گرداننده submit استفاده می‌کند، پس یک اسکن یک بار پردازش می‌شود. بدون پسوند ENTER، متن در فیلد می‌ماند تا کسی Accept را فعال کند. محموله گرفته‌شده با textContent نوشته می‌شود، تا نویسه‌هایی مانند < به‌صورت متن دیده بمانند.

مثال سه قالب برنامه را می‌پذیرد: شناسه بلیت مانند QR-INPUT-TEST-12345، یک URL با http یا https، یا یک شیء JSON. متن اسکن‌شده را ثبت می‌کند. به URL موجود در کد QR نمی‌رود. اسکنری که Enter نمی‌فرستد همچنان از راه دکمه کار می‌کند. 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 فرم اداره کنید. شنونده دوم keydown برای Enter همان اسکن را دو بار ثبت می‌کند. 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 تقسیم نمی‌کند. برخی دستگاه‌ها NumPad Enter می‌فرستند. event.key همچنان "Enter" است. event.key را بررسی کنید، نه فقط event.code === "Enter".

پسوند می‌تواند وقتی کسی بارکد پیکربندی را از دفترچه دستگاه اسکن می‌کند عوض شود. پس از هر تغییر پیکربندی Enter، Tab و بدون پسوند را دوباره بیازمایید. بارکد برنامه‌نویسی نسازید. برای آن مدل از دفترچه استفاده کنید.

اشکال‌زدایی رویدادهای صفحه‌کلید

وقتی متن ذخیره‌شده نادرست است، رویدادها را به این ترتیب بررسی کنید.

keydown. برای هر کلید، از جمله Enter و Tab، پیش از آنکه مرورگر نویسه درج کند یا فوکوس را جابه‌جا کند شلیک می‌شود. پایان‌دهنده را اینجا بخوانید.

input. پس از آنکه نویسه چاپی فیلد را عوض می‌کند شلیک می‌شود. برای Enter یا Tab روی ورودی متن شلیک نمی‌شود.

event.key. نویسه یا نام کلید پس از آنکه سیستم‌عامل چیدمان صفحه‌کلید را اعمال کرد.

event.code. کلید فیزیکی، مانند Digit1 یا Numpad1. وقتی ناسازگاری چیدمان event.key را عوض می‌کند می‌تواند ثابت بماند.

فوکوس. پیش از اسکن document.activeElement را ثبت کنید. اگر فیلد QR نباشد، بقیه رد کنترل نادرست را توصیف می‌کند. iframe فوکوس خودش را دارد.

ترتیب. برای اسکن گوه در فیلد متن، رویدادهای keydown چاپی با به‌روزرسانی‌های input دنبال می‌شوند، سپس یک keydown نهایی برای Enter یا Tab وقتی آن پسوند تنظیم شده است. change وقتی فیلد ثبت می‌کند شلیک می‌شود، معمولاً هنگام blur. اسکنی که فوکوس را در همان فیلد می‌گذارد در پایان change تولید نمی‌کند. از change به‌عنوان تنها نشانه تکمیل استفاده نکنید.

زمان‌بندی. اسکنرها اغلب محموله کوتاه را در مدتی کاملاً کمتر از یک ثانیه تمام می‌کنند. آزمایشگر ورودی میانگین فاصله بین نویسه‌ها را با آستانه 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 متن ساده مقدار دقیق دریافت شد.
QR از نوع URL URL کامل گرفته شد، و صفحه به آن نمی‌رود.
QR عددی رقم‌ها حفظ شدند.
نویسه‌های ویژه نویسه‌های درست دریافت شدند.
محموله JSON داده گرفته و اعتبارسنجی شد.
پسوند ENTER پردازش یک بار رخ می‌دهد.
پسوند TAB رفتار فوکوس اداره شد.
بدون پسوند برنامه از سازوکار تکمیل جایگزین استفاده می‌کند.
اسکن تکراری برنامه قواعد رسیدگی به تکرار را اعمال می‌کند.
محموله نامعتبر خطای اعتبارسنجی نمایش داده شد.
فوکوس غایب برنامه ورودی غایب را ایمن اداره می‌کند.
محموله بلند کوتاه‌سازی ناخواسته نیست.

اگر محصول باید خط جدید را ذخیره کند، محموله‌ای را هم اسکن کنید که خط جدید دارد. ثبت کنید فیلد هر خط را دریافت کرده یا نه.

عیب‌یابی

با محموله شناخته‌شده در آزمایشگر ورودی شروع کنید. اگر مقدار آزمایشگر از پیش نادرست است، صفحه نخستین عیب نیست. اگر مقدار آزمایشگر درست است و برنامه نادرست، عیب فوکوس، اعتبارسنجی یا اداره رویداد است. اسکنر بارکد کار نمی‌کند فهرست بررسی گسترده‌تر دستگاه است. چگونه ورودی اسکنر بارکد را بیازماییم فوکوس، چیدمان و گردش‌کار POS فراتر از این فرم را پوشش می‌دهد.

اسکنر بوق می‌زند اما ورودی ظاهر نمی‌شود

بوق معمولاً یعنی اسکنر نماد را رمزگشایی کرده است. به این معنا نیست که صفحه متن را دریافت کرده است. حالت گوه‌کلید را تأیید کنید. حالت‌های سریال و دوربین در فیلد تایپ نمی‌کنند. فیلد را کلیک کنید تا document.activeElement همان ورودی باشد، سپس دوباره اسکن کنید. فیلد غیرفعال، فقط‌خواندنی یا پنهان می‌تواند کلیدها را نادیده بگیرد.

اسکنر QR در Notepad کار می‌کند اما در مرورگر نه

دستگاه تایپ می‌کند. صفحه آن کلیدها را نمی‌پذیرد. فوکوس، شنونده keydown که روی کلیدهای چاپی preventDefault() صدا می‌زند، و شنونده‌ای که فقط paste را اداره می‌کند را بررسی کنید. ورودی گوه رویداد paste شلیک نمی‌کند. نتیجه آزمایشگر را با فیلد برنامه مقایسه کنید.

اسکنر بارکد می‌خواند اما کد QR نه

دستگاه ممکن است فقط یک‌بعدی باشد، یا نمادشناسی QR غیرفعال باشد. صفحه نمی‌تواند آن را درست کند. پشتیبانی دوبعدی را تأیید کنید و QR Code را از دفترچه دستگاه فعال کنید، با بررسی‌های آزمون کد QR: چگونه اسکنرهای کد QR را بیازماییم. اسکن موفق Code 128 فقط مسیر صفحه‌کلید را ثابت می‌کند.

نویسه‌های نادرست

ابتدا QR-INPUT-TEST-12345 را اسکن کنید. اگر آن جور است و محموله URL یا JSON نیست، چیدمان نقطه‌گذاری مانند :، /، { یا " را عوض می‌کند. event.key را با event.code در آزمایشگر رویداد صفحه‌کلید مقایسه کنید، و چیدمان صفحه‌کلید نادرست اسکنر بارکد را ببینید. چیدمان صفحه‌کلید اسکنر را با سیستم‌عامل هماهنگ کنید.

ENTER فرم را دو بار می‌فرستد

مرورگر فرم را می‌فرستد، و شنونده keydown هم Enter را اداره می‌کند. یک مسیر تکمیل نگه دارید و آنجا preventDefault() را صدا بزنید. اسکن فیزیکی دوم شکست متفاوتی است. متن وضعیت در مثال می‌گوید محموله قبلاً پذیرفته شده. اگر خود اسکن اول دو رکورد می‌سازد، پیش از تغییر اسکنر به دنبال دو شنونده بگردید.

ورودی QR کوتاه شده است

تعداد نویسه در آزمایشگر ورودی را با مقدار فیلد مقایسه کنید. ویژگی maxlength، نقاب ورودی، یا preventDefault() روی کلیدهای نویسه می‌تواند رشته را ببرد. خط جدید درون محموله QR می‌تواند ورودی یک‌خطی را زود ارسال کند. برخی اسکنرها هم محدود می‌کنند چند نویسه تایپ می‌کنند. وقتی آزمایشگر، نه فقط برنامه، مقدار کوتاه نشان می‌دهد آن حد را از دفترچه دستگاه بالا ببرید. اسکنر بارکد ENTER نمی‌فرستد حالت مرتبط را پوشش می‌دهد که محموله می‌رسد و فرم هرگز ثبت نمی‌شود.

اسکنر نمی‌تواند کد QR روی صفحه را بخواند

تأیید کنید اسکنر تصویربردار دوبعدی است. روشنایی نمایشگر را بالا ببرید، اندازه کد را زیاد کنید، و ناحیه آرام را از متن و حاشیه خالی نگه دارید. بازتاب، صفحه کم‌نور تلفن، و کدی که برای فاصله کاری بیش از حد متراکم است مسئله نوری‌اند. اگر خواندن از صفحه همچنان شکست می‌خورد همان محموله را چاپ کنید. آزمون برنامه همچنان پس از آنکه هر اسکنی متن تولید کرد از رشته شناخته‌شده استفاده می‌کند.