لم يتم التحقق من ترميز HTML في واجهة برمجة تطبيقات الحافظة غير المتزامنة.

اعتبارًا من الإصدار 120 من Chrome، يتوفّر خيار unsanitized جديد في واجهة برمجة التطبيقات Async Clipboard API. يمكن أن يساعد هذا الخيار في حالات خاصة مع HTML، حيث تحتاج إلى لصق محتويات الحافظة بشكل مماثل لما كانت عليه عند نسخها. أي بدون أي خطوة تنظيف وسيطة تطبّقها المتصفحات عادةً ولأسباب وجيهة. تعرَّف على كيفية استخدامها في هذا الدليل.

عند العمل مع Async Clipboard API، في معظم الحالات، لا يحتاج المطورون إلى القلق بشأن سلامة المحتوى الموجود في الحافظة ويمكنهم افتراض أن ما يكتبونه في الحافظة (نسخ) هو نفس ما سيحصلون عليه عندما يقرأون البيانات من الحافظة (لصق).

هذا صحيح بالتأكيد بالنسبة للنص. جرِّب لصق الرمز التالي في وحدة تحكّم أدوات مطوري البرامج ثم إعادة التركيز على الصفحة على الفور. (يُعدّ setTimeout() ضروريًا ليكون لديك وقت كافٍ للتركيز على الصفحة، وهو أحد متطلبات واجهة برمجة التطبيقات Async Clipboard API). كما ترى، فإن الإدخال هو بالضبط نفس الإخراج.

setTimeout(async () => {
  const input = 'Hello';
  await navigator.clipboard.writeText(input);
  const output = await navigator.clipboard.readText();
  console.log(input, output, input === output);
  // Logs "Hello Hello true".
}, 3000);

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

setTimeout(async () => {
  const dataURL =
    'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVQYV2NgYAAAAAMAAWgmWQ0AAAAASUVORK5CYII=';
  const input = await fetch(dataURL).then((response) => response.blob());
  await navigator.clipboard.write([
    new ClipboardItem({
      [input.type]: input,
    }),
  ]);
  const [clipboardItem] = await navigator.clipboard.read();
  const output = await clipboardItem.getType(input.type);
  console.log(input.size, output.size, input.type === output.type);
  // Logs "68 161 true".
}, 3000);

ولكن ماذا يحدث مع نص HTML؟ كما قد تكون خمّنت، يختلف الوضع مع HTML. في هذه الحالة، يزيل المتصفّح العناصر الضارة من رمز HTML لمنع حدوث مشاكل، وذلك مثلاً من خلال إزالة علامات <script> من رمز HTML (وعلامات أخرى مثل <meta> و<head> و<style>) ومن خلال تضمين CSS. اطّلِع على المثال التالي وجرِّبه في وحدة تحكّم "أدوات مطوري البرامج". ستلاحظ أن الناتج يختلف بشكل كبير عن المدخلات.

setTimeout(async () => {
  const input = `<html>  
  <head>  
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />  
    <meta name="ProgId" content="Excel.Sheet" />  
    <meta name="Generator" content="Microsoft Excel 15" />  
    <style>  
      body {  
        font-family: HK Grotesk;  
        background-color: var(--color-bg);  
      }  
    </style>  
  </head>  
  <body>  
    <div>hello</div>  
  </body>  
</html>`;
  const inputBlob = new Blob([input], { type: 'text/html' });
  await navigator.clipboard.write([
    new ClipboardItem({
      'text/html': inputBlob,
    }),
  ]);
  const [clipboardItem] = await navigator.clipboard.read();
  const outputBlob = await clipboardItem.getType('text/html');
  const output = await outputBlob.text();
  console.log(input, output);
}, 3000);

تطهير HTML هو أمر جيد بشكل عام. فأنت لا تريد تعريض نفسك لمشاكل أمنية من خلال السماح باستخدام HTML غير آمن في معظم الحالات. ومع ذلك، هناك سيناريوهات يعرف فيها المطوّر بالضبط ما يفعله، ويكون فيها سلامة HTML المدخل والمخرج أمرًا بالغ الأهمية لعمل التطبيق بشكل صحيح. في ظل هذه الظروف، لديك خياران:

  1. إذا كنت تتحكّم في كل من عملية النسخ واللصق، على سبيل المثال، إذا كنت تنسخ من داخل تطبيقك ثم تلصق داخل تطبيقك، عليك استخدام تنسيقات الويب المخصّصة لواجهة برمجة التطبيقات Async Clipboard API. توقَّف عن القراءة هنا واطّلِع على المقالة المرتبطة.
  2. إذا كنت تتحكّم في عملية اللصق فقط في تطبيقك، وليس في عملية النسخ، ربما لأنّ عملية النسخ تحدث في تطبيق أصلي لا يتيح التنسيقات المخصّصة على الويب، عليك استخدام الخيار unsanitized، والذي سيتم شرحه في بقية هذه المقالة.

وتشمل عملية التنقية إجراءات مثل إزالة علامات script، وتضمين الأنماط، والتأكّد من أنّ تنسيق HTML سليم. هذه القائمة غير شاملة، وقد تتم إضافة المزيد من الخطوات في المستقبل.

نسخ ولصق محتوى HTML غير المُنقَّح

عند write() (نسخ) HTML إلى الحافظة باستخدام Async Clipboard API، يتأكّد المتصفّح من أنّه تم إنشاؤه بشكل صحيح من خلال تشغيله من خلال محلّل DOM وتسلسل سلسلة HTML الناتجة، ولكن لا تتم عملية تنظيف في هذه الخطوة. ليس عليك اتّخاذ أي إجراء. عندما read() HTML موضوعًا في الحافظة من خلال تطبيق آخر، ويختار تطبيق الويب الحصول على المحتوى الكامل الدقة ويحتاج إلى إجراء أي عملية تنظيف في الرمز البرمجي الخاص بك، يمكنك تمرير كائن خيارات إلى طريقة read() باستخدام السمة unsanitized وقيمة ['text/html']. بشكل منفصل، يبدو على النحو التالي: navigator.clipboard.read({ unsanitized: ['text/html'] }). عينة التعليمات البرمجية التالية أدناه هي نفسها تقريبًا التي تم عرضها سابقًا، ولكن هذه المرة مع الخيار unsanitized. عند تجربتها في وحدة تحكم أدوات مطوري البرامج، سترى أن المدخلات والمخرجات هي نفسها.

setTimeout(async () => {
  const input = `<html>  
  <head>  
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />  
    <meta name="ProgId" content="Excel.Sheet" />  
    <meta name="Generator" content="Microsoft Excel 15" />  
    <style>  
      body {  
        font-family: HK Grotesk;  
        background-color: var(--color-bg);  
      }  
    </style>  
  </head>  
  <body>  
    <div>hello</div>  
  </body>  
</html>`;
  const inputBlob = new Blob([input], { type: 'text/html' });
  await navigator.clipboard.write([
    new ClipboardItem({
      'text/html': inputBlob,
    }),
  ]);
  const [clipboardItem] = await navigator.clipboard.read({
    unsanitized: ['text/html'],
  });
  const outputBlob = await clipboardItem.getType('text/html');
  const output = await outputBlob.text();
  console.log(input, output);
}, 3000);

توافُق المتصفّح ورصد الميزات

لا تتوفّر طريقة مباشرة للتحقّق مما إذا كانت الميزة متاحة، لذا يعتمد رصد الميزة على مراقبة السلوك. لذلك، يعتمد المثال التالي على رصد ما إذا كانت علامة <style> تبقى، ما يشير إلى التوافق، أو يتم تضمينها، ما يشير إلى عدم التوافق. يُرجى العِلم أنّه لكي ينجح ذلك، يجب أن تكون الصفحة قد حصلت على إذن الحافظة.

const supportsUnsanitized = async () => {
  const input = `<style>p{color:red}</style><p>a`;
  const inputBlob = new Blob([input], { type: 'text/html' });
  await navigator.clipboard.write([
    new ClipboardItem({
      'text/html': inputBlob,
    }),
  ]);
  const [clipboardItem] = await navigator.clipboard.read({
    unsanitized: ['text/html'],
  });
  const outputBlob = await clipboardItem.getType('text/html');
  const output = await outputBlob.text();
  return /<style>/.test(output);
};

عرض توضيحي

للاطّلاع على الخيار unsanitized أثناء العمل، يمكنك الاطّلاع على العرض التوضيحي والتحقّق من الرمز المصدر.

الاستنتاجات

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

الإقرارات

تمت مراجعة هذه المقالة من قِبل أنوبام سنيغدا ورايتشل أندرو. تم تحديد واجهة برمجة التطبيقات وتنفيذها من قِبل فريق Microsoft Edge.