Lorixen.
AR

ضغط ملفات CSV الكبيرة في المتصفح قبل التنزيل أو الرفع

باختصار: إن كان تطبيق الويب في محلك أو شركتك يصدّر ملفات CSV كبيرة، كسجل المبيعات لسنة أو قائمة كل الزبائن، أو يرفع نسخاً احتياطية إلى الخادم من جهاز الموظف، فضغطها في المتصفح قبل التنزيل أو الرفع يوفر وقتاً وبيانات. الواجهة CompressionStream مدمجة في المتصفحات، وتصفها MDN بأنها Baseline متاحة على نطاق واسع منذ مايو 2023، وتضغط بصيغة gzip أو deflate دون أي مكتبة إضافية. والملف الناتج بصيغة gzip يفتحه أي برنامج ضغط معروف على الحاسوب. في تجربتنا، صغر ملف CSV عربي تجريبي إلى أقل من خُمس حجمه، لكن النسبة تختلف بحسب البيانات.

متى تحتاج هذا

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

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

ملفات CSV نص متكرر كثيراً: الأسماء نفسها، والأصناف نفسها، والفواصل نفسها. هذا النوع من البيانات ينضغط عادة بشكل جيد.

ما هي CompressionStream

تشرح MDN أن واجهة Compression Streams توفر طريقة في جافاسكربت لضغط تيارات البيانات وفكها بصيغ gzip أو deflate، وأن الضغط المدمج يعني أن تطبيقات جافاسكربت لن تحتاج إلى إضافة مكتبة ضغط، فيصغر حجم التطبيق نفسه.

وتتكون من واجهتين:

  • CompressionStream: تضغط تياراً من البيانات.
  • DecompressionStream: تفك ضغط تيار.

وتعمل كلتاهما كتيار تحويل، فتُستخدم مع pipeThrough. وتذكر MDN أن الواجهة متاحة أيضاً داخل Web Workers، وهذا مفيد لضغط ملف كبير دون تجميد الصفحة.

الصيغ المتاحة

يسرد توثيق المنشئ في MDN الصيغ: gzip، وdeflate، وdeflate-raw، إضافة إلى brotli وzstd. ويذكر أن المنشئ يرمي TypeError إن لم تكن الصيغة مدعومة.

انتبه: كون الواجهة نفسها Baseline لا يعني أن كل صيغها كذلك. تذكر MDN أن بعض أجزاء الميزة قد تختلف في مستوى دعمها. للملفات التي سيفتحها شخص آخر، استخدم gzip؛ فهي الصيغة التي تفتحها أدوات الضغط المعتادة على ويندوز وماك ولينكس. وإن أردت تجربة صيغة أخرى، فغلّف الإنشاء بمحاولة والتقط الخطأ.

مثال توضيحي: تنزيل CSV مضغوط

async function downloadGzippedCsv(csvText, fileName) {
  const gzStream = new Blob([csvText]).stream()
    .pipeThrough(new CompressionStream('gzip'));
  const gzBlob = await new Response(gzStream).blob();
  const a = document.createElement('a');
  a.href = URL.createObjectURL(gzBlob);
  a.download = fileName + '.csv.gz';
  a.click();
  URL.revokeObjectURL(a.href);
}

الفكرة من مثال MDN نفسه: تيار البيانات يمر عبر CompressionStream، ثم يُحوّل الناتج إلى Blob باستخدام Response. والامتداد .csv.gz يخبر المستلم أنه CSV مضغوط.

ماذا يحدث فعلاً للحجم

جرّبنا الفكرة نفسها في Node.js 22، الذي يوفر الواجهة نفسها، على ملف CSV تجريبي من 20 ألف سطر بأسماء منتجات عربية متكررة وأرقام. الملف الأصلي كان نحو 646 كيلوبايت، وبعد gzip صار نحو 115 كيلوبايت، أي قرابة 18% من حجمه. وأعاد DecompressionStream النص نفسه تماماً.

هذا مثال توضيحي لا وعد: بيانات حقيقية فيها ملاحظات حرة متنوعة أو أرقام عشوائية كثيرة ستنضغط بنسبة أقل. والصور وملفات PDF وZIP المضغوطة أصلاً لن تصغر تقريباً، فلا تضغطها.

الرفع المضغوط إلى الخادم

للمندوبين الذين يرفعون الطلبات، يمكن ضغط البيانات قبل إرسالها. مثال توضيحي:

const body = new Blob([JSON.stringify(orders)]).stream()
  .pipeThrough(new CompressionStream('gzip'));
const blob = await new Response(body).blob();
await fetch('/api/orders/batch', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', 'Content-Encoding': 'gzip' },
  body: blob
});

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

فك ملف مضغوط في المتصفح

العكس مفيد أيضاً. إن أرسل لك مورد قائمة أسعار بصيغة .csv.gz، يمكن لتطبيقك أن يقرأها مباشرة. مثال MDN يعرض دالة تفك ضغط Blob بـ DecompressionStream ثم تعيد Blob جديداً. بعدها تقرأ النص وتعرضه أو تستورده.

الضغط مع العمل دون اتصال

في مثال المندوبين، الضغط وحده لا يكفي إن كانت الشبكة تنقطع تماماً. الترتيب الأمتن:

  1. يُحفظ كل طلب على الجهاز فور إدخاله، لا عند الرفع فقط.
  2. عند الضغط على «رفع طلبات اليوم»، يُجمع ما لم يُرفع بعد في دفعة واحدة، وتُضغط.
  3. تُرسل الدفعة، ولا تُحذف من الجهاز إلا بعد أن يؤكد الخادم استلامها.
  4. إن فشل الإرسال، تبقى الدفعة كما هي، ويُعرض للمندوب عدد الطلبات المعلقة وزر «حاول مجدداً».

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

ماذا عن ملفات ZIP

كثير من الناس يتوقعون ملف ZIP لا gzip. الفرق أن gzip يضغط ملفاً واحداً، بينما ZIP حاوية قد تضم عدة ملفات. CompressionStream لا تنشئ ZIP بنفسها. إن احتجت إلى تجميع عدة تقارير في ملف واحد، فستحتاج إلى مكتبة لإنشاء ZIP، أو أن تبني الملف على الخادم. لملف CSV واحد كبير، gzip يكفي وأبسط.

نصائح عملية

  • للملفات الصغيرة لا داعي: تقرير من بضع مئات من الأسطر لا يحتاج ضغطاً، والوقت الذي يوفره لا يكاد يُلاحظ.
  • سمِّ الملف بوضوح: اسم مثل «طلبات-2026-10.csv.gz» يخبر المستلم بالمحتوى والشهر والصيغة معاً.
  • اعمل في Worker للملفات الكبيرة: حتى لا تتجمد الشاشة أثناء الضغط.
  • أخبر المستلم: إن كان المدقق لا يعرف التعامل مع .gz، فاشرح له في رسالة قصيرة أنه يُفتح ببرنامج ضغط عادي.
  • لا تخلطه بالتشفير: الضغط يصغّر الملف لكنه لا يحميه. البيانات الحساسة تحتاج حماية منفصلة.

مثال توضيحي لزر في التطبيق

مثال توضيحي لواجهة التصدير: زران بجانب بعض، «تنزيل CSV» و«تنزيل CSV مضغوط»، مع سطر صغير يعرض الحجم المتوقع لكل منهما بعد الحساب. المحاسب يختار المضغوط للبريد، والعادي حين يريد فتحه فوراً في Excel على حاسوبه.

أسئلة شائعة

هل يفتح المدقق ملف .csv.gz؟

نعم، بأي برنامج ضغط شائع يدعم gzip، ثم يُفتح ملف CSV الناتج كالمعتاد.

هل تعمل CompressionStream في كل المتصفحات؟

تصفها MDN بأنها Baseline متاحة على نطاق واسع منذ مايو 2023، مع اختلاف في دعم بعض أجزائها، كبعض الصيغ.

كم سيصغر ملفي؟

يعتمد على البيانات. النص المتكرر ينضغط جيداً، والملفات المضغوطة أصلاً كالصور لا تصغر تقريباً.

هل يفهم الخادم الطلب المضغوط تلقائياً؟

ليس دائماً. يجب أن يُعد الخادم لفك محتوى الطلبات المضغوطة.

إذا كانت تقارير نظامك أو نسخه الاحتياطية ثقيلة في التنزيل والرفع، تواصل معنا لنخففها.

المصادر

WhatsAppاحجز مكالمة