برمجة

TextDecoder: احمِ الحروف العربية عند قراءة الاستجابة على أجزاء

فريق فايندو جروب2 دقائق قراءة0 مشاهدة0 تعليقات
مشاركة:
حاسوب وشاشة إضافية يعرضان محرر JavaScript ونصًا عربيًا ضمن تجربة ترميز

قد يصل النص العربي صحيحًا عند تنزيله كاملًا، ثم تظهر علامة الاستبدال عند عرضه أثناء وصول أجزاء الشبكة. الحرف الواحد في UTF-8 قد يتكون من عدة بايتات، وحد نهاية الجزء الذي وصل لا يلزم أن يكون نهاية حرف. تغيير الخط العربي لا يعالج هذه المشكلة لأن الخلل حدث قبل العرض.

احتفظ بحالة فك الترميز

توفر decode خيار stream لإخبار TextDecoder بأن هناك أجزاء أخرى لاحقًا. استخدم الكائن نفسه طوال التدفق، ثم استدعِ decode دون جزء جديد لإنهائه. إنشاء Decoder جديد لكل قطعة يفقد الحالة التي تربط البايتات المتبقية. وإذا اخترت fatal، فخطأ فك الترميز يرفع TypeError بدل المرور الصامت؛ حدد معالجة مناسبة لهذا الفشل.

اختبار قصير للحروف المقسومة

المثال التالي لا يحتاج خادمًا. فهو يقسم عبارة عربية عند كل حد بايت ممكن، ويعيد تجميع الناتج. هذه طريقة لاختبار الفرضية قبل تغيير مكتبة الشبكة أو الواجهة. نجاح الحالة الكاملة وحدها لا يكفي؛ مواضع القطع داخل الحروف هي الحالات التي نريد تغطيتها.

const text = 'طلب جديد رقم ١٢ ✅';
const bytes = new TextEncoder().encode(text);
for (let cut = 1; cut < bytes.length; cut++) {
const decoder = new TextDecoder('utf-8', { fatal: true });
const actual = decoder.decode(bytes.slice(0, cut), { stream: true })
+ decoder.decode(bytes.slice(cut), { stream: true })
+ decoder.decode();
if (actual !== text) throw new Error(`cut=${cut}`);
}

لا تخلط الحروف مع الرسائل

فك الترميز الصحيح لا يعني أنك حصلت على كائن JSON كامل أو سطر سجل كامل. بعد تحويل البايتات إلى نص، احتفظ بباقي الرسالة بحسب بروتوكولك، ثم حلل الرسائل المكتملة فقط. في مثال افتراضي لخدمة تعرض تحديثات الطلبات، يمكن لرسالة واحدة أن تمتد عبر ثلاث قطع، ويمكن لقطعة واحدة أن تحتوي رسالتين.

أضف إلى اختبار التطبيق جزءًا فارغًا، وإغلاقًا طبيعيًا، ثم انقطاعًا قبل اكتمال الرسالة الأخيرة. يجب ألا تظهر الرسالة الجزئية كطلب مؤكد أو صف مكتمل. عند الإلغاء أوقف القراءة وحدّث الحالة المرئية، ولا تُحوّل أي نص غير مكتمل إلى نتيجة نهائية لمجرد أن الاتصال انتهى.

معيار قبول عملي

استخدم عينات تشمل التشكيل والأرقام العربية والإيموجي، وقارن النص حرفيًا بالعينة الأصلية. سجل عدد الرسائل المكتملة وحالة النهاية دون نسخ بيانات العملاء في التقرير. إذا نجح فك الترميز وفشل تحليل الرسائل، انتقل إلى فواصل البروتوكول بدل إضافة نسخ متكررة من البايتات المتبقية.

المراجع والخطوة التالية

يمكن تطبيق هذه المراجعة ضمن تطوير تطبيقات الويب وحساب الحروف العربية والإيموجي. الأمثلة تعليمية، والصورة مشهد تقني توضيحي مولد بالذكاء الاصطناعي وليست لقطة من مشروع عميل.

التصنيفات:برمجة
شارك:

التعليقات

لا توجد تعليقات بعد

أضف تعليقك

كن أول من يعلق على هذا المقال

02 · تابع القراءة

مقالات ذات صلة