از Chrome 120، گزینه جدید unsanitized در Async Clipboard
API دردسترس است. این گزینه میتواند در شرایط خاص با HTML کمک کند، جایی که باید
محتویات بریدهدان را دقیقاً همانطور که هنگام کپی شدن بود جایگذاری کنید.
یعنی بدون هیچ مرحله پاکسازی واسطهای که مرورگرها معمولاً—و
به دلایل خوب—اعمال میکنند. در این راهنما با نحوه استفاده از آن آشنا شوید.
هنگام کار با Async Clipboard API، در اکثر موارد، توسعهدهندگان نیازی به نگرانی درباره یکپارچگی محتوای بریدهدان ندارند و میتوانند فرض کنند آنچه در بریدهدان مینویسند (کپی میکنند) همان چیزی است که هنگام خواندن دادهها از بریدهدان (جایگذاری) دریافت خواهند کرد.
این موضوع قطعاً درباره نوشتار صدق میکند. کد زیر را در کنسول DevTools جایگذاری کنید و سپس بلافاصله صفحه را دوباره فوکوس کنید. (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.
مثال زیر را درنظر بگیرید و آن را در «کنسول DevTools» امتحان کنید. متوجه خواهید شد که برونداد تفاوت قابلتوجهی با ورودی دارد.
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 ورودی و خروجی برای عملکرد صحیح برنامه بسیار مهم است. در این شرایط، دو انتخاب دارید:
- اگر هم بر کپی کردن و هم بر جایگذاری کردن کنترل دارید، مثلاً اگر از داخل برنامهتان کپی میکنید و سپس در برنامهتان جایگذاری میکنید، باید از قالبهای سفارشی وب برای Async Clipboard API استفاده کنید. خواندن را در اینجا متوقف کنید و مقاله پیوندشده را بررسی کنید.
- اگر فقط انتهای جایگذاری را در برنامهتان کنترل میکنید، اما انتهای کپی را کنترل نمیکنید،
شاید به این دلیل که عملیات کپی در برنامه به زبان اصلی دستگاهی اتفاق میافتد که از
قالبهای سفارشی وب پشتیبانی نمیکند، باید از گزینه
unsanitizedاستفاده کنید که در ادامه این مقاله توضیح داده شده است.
پاکسازی شامل مواردی مانند برداشتن برچسبهای script، سبکهای درونخطی، و
اطمینان از خوشساخت بودن HTML است. این فهرست کامل نیست و ممکن است در آینده مراحل بیشتری اضافه شود.
کپی و جایگذاری HTML پاکسازینشده
وقتی HTML را با Async Clipboard API در بریدهدان write() (کپی) میکنید،
مرورگر با اجرای آن ازطریق تجزیهکننده DOM و سریالسازی رشته HTML حاصل، مطمئن میشود که بهدرستی شکل گرفته است، اما در این مرحله هیچ پاکسازیای انجام نمیشود. لازم نیست کاری انجام دهید. وقتی read() HTML را که توسط برنامه دیگری در بریدهدان قرار داده شده است میخوانید و برنامه وب شما برای دریافت محتوای کاملاً دقیق موافقت میکند و لازم است هرگونه پاکسازی را در کد خودتان انجام دهید، میتوانید شیء گزینهها را با ویژگی unsanitized و مقدار ['text/html'] به روش read() ارسال کنید. بهصورت مجزا، اینگونه بهنظر میرسد:
navigator.clipboard.read({ unsanitized: ['text/html'] }). نمونه کد زیر تقریباً مشابه نمونهای است که قبلاً نشان داده شد، اما این بار با گزینه unsanitized. وقتی آن را در «کنسول DevTools» امتحان میکنید، خواهید دید که ورودی و
خروجی یکسان هستند.
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 وجود دارد.
پیوندهای مفید
تصدیقنامهها
این مقاله را Anupam Snigdha و Rachel Andrew بازبینی کردهاند. این میانای برنامهسازی کاربردی توسط تیم Microsoft Edge مشخص و پیادهسازی شده است.