استخراج حمولة QR من صورة والتحقق منها
افك الصورة المحلية وافحص النص غير الموثوق ثم وجّهه إلى validator مناسب لنوعه المزعوم.
- اختيار الأصل
- فك حمولة واحدة
- فحص النص
- التحقق من النوع
- مسح السجل الحساس
أدوات فك الترميز
مفكك QR
يفتح صورة محلية عبر createImageBitmap وCanvas وjsQR، ويفك أول رمز QR مقروء، ويصنف بادئات الحمولة الشائعة، ثم ينسخ النص الدقيق. مفيد لقراءة رموز QR من الصور المحفوظة بدون كاميرا. يدعم التعرف على الروابط والنصوص والبيانات مع نسخ النتيجة.
أدوات QR
اسحب وأسقط صورة رمز QRأو انقر للتصفح — PNG وJPEG وGIF وBMP وWebP
باختصار
يقرأ المفكك صورة واحدة إلى Canvas، ويحاول البكسلات العادية والمعكوسة، ويعيد أول رمز يجده jsQR، ولا يرفع الصورة.
ما الذي تدعمه الأداة
- يقبل صورة واحدة من منتقي الملفات أو السحب، ويفكها بـcreateImageBitmap ويقرأ RGBA من Canvas.
- يشغّل jsQR مع attemptBoth للسطوع العادي والمعكوس ويعيد أول حمولة QR غير فارغة.
- يصنف http/https وmailto وtel وWIFI وvCard وSMS وgeo وVEVENT، وما عداها text.
- يعرض معاينة وينسخ النص ويخزن آخر عشرة نتائج في localStorage اختياريًا عند تفعيل السجل.
كيفية استخدام مفكك QR
اتبع سير العمل الخاص بتنفيذ مفكك QR؛ فكل خطوة تعكس عناصر التحكم والحدود الفعلية في مساحة عمل المتصفح.
- 1
الخطوة 1
أدخل المصدر بدقة
اختر أو أفلت صورة حادة فيها رمز QR كامل واحد ومساحة هادئة ظاهرة.
- 2
الخطوة 2
اختر العملية
استخدم مسار الملف بلا إذن كاميرا؛ يجب أن يدعم المتصفح فك صيغة الصورة.
- 3
الخطوة 3
اضبط الخيارات المتاحة
انتظر فك bitmap ورسم Canvas ومحاولة jsQR للسطوعين.
- 4
الخطوة 4
نفّذ العملية محليًا
راجع الحمولة كاملة وتصنيفها؛ لا تفتح URL قبل فحص المخطط والمضيف والمسار والمحارف المتشابهة.
- 5
الخطوة 5
تحقق من النتيجة ثم تابع
انسخ النص للأداة المناسبة وامسح السجل الاختياري إذا كانت الحمولة حساسة.
الأخطاء الشائعة
تحميل رمز ضبابي أو مقصوص أو صغير أو مائل
النتيجة: قد تضيع أنماط finder أو المساحة الهادئة فلا يجد jsQR رمزًا.
الإصلاح: استخدم الصورة الأصلية بكل الحواف وتجنب لقطة مضغوطة عدة مرات.
اعتبار التصنيف تحققًا من المحتوى
النتيجة: يفحص بادئة نصية فقط؛ قد يكون URL خادعًا أو WIFI/vCard تالفًا.
الإصلاح: افحص النص الدقيق ثم استخدم validator خاصًا بالنوع.
افتراض حد آمن لكل image/*
النتيجة: لا يوجد حد صريح لحجم أو أبعاد الملف قبل تخصيص bitmap.
الإصلاح: استخدم صورة ثابتة معتدلة وقلّص الصور الضخمة قبل الفك على الأجهزة محدودة الذاكرة.
أفضل الممارسات
- افك الرموز المجهولة كنص أولًا ولا تتنقل تلقائيًا.
- احتفظ بالصورة الأصلية حتى مقارنة الحمولة حرفًا بحرف.
- عطّل أو امسح السجل عند Wi-Fi أو token أو جهات اتصال أو روابط خاصة.
سير العمل المرتبط
قيود المتصفح
- يختلف دعم createImageBitmap وcodec؛ قد تفشل SVG أو HEIC أو الصور المتحركة/التالفة/الضخمة أو تستنزف الذاكرة.
- يعيد أول QR فقط، بلا اختيار متعدد أو barcode أو إصلاح تلف أو confidence.
- تعالج بكسلات الصورة كاملة على main thread بعد bitmap وقد تحجب الصور الكبيرة الواجهة مؤقتًا.
المراجع الموثوقة
أمثلة عملية
- الإدخال
- صورة PNG فيها رمز واحد يشفّر https://example.com/docs
- النتيجة
- النوع url والنص الدقيق متاح للنسخ.
يعيد jsQR بيانات الرمز، وتصنف parseQRCodeType البادئة https:// بلا جلب الوجهة أو التحقق منها.
الأسئلة الشائعة
هل يمكن فك QR بلا إذن الكاميرا؟
نعم. يحتاج إلى صورة محلية مختارة فقط؛ استخدم QR Scanner لمسار الكاميرا الصريح.
لماذا تفشل لقطة تبدو واضحة؟
قد يؤدي قص المساحة أو تغيير الحجم أو الضغط أو الوهج أو المنظور أو ضعف التباين إلى فشل الشبكة.
هل يقرأ عدة رموز في صورة واحدة؟
لا. يستخرج الاستدعاء الحالي نتيجة واحدة فقط.
هل يفتح URL الناتج تلقائيًا؟
لا. يعرض القيمة أولًا وأي رابط فتح يحتاج إجراء منفصلًا منك.
أين تُحفظ النتائج السابقة؟
عند تفعيل السجل فقط، تُحفظ عشرة نتائج تحت مفتاح localStorage خاص بالمفكك ويمكن مسحها.
الخصوصية والعمل دون اتصال
تبقى الصورة وبكسلات Canvas وData URL والحمولة على الجهاز. لا يكتب السجل إلا عند تفعيله في هذا المتصفح، ويعمل المفكك دون اتصال بعد التخزين.