החל מגרסה 120 של Chrome, אפשרות חדשה של unsanitized זמינה ב-Async Clipboard API. האפשרות הזו יכולה לעזור במצבים מיוחדים עם HTML, שבהם צריך להדביק את התוכן של הלוח בדיוק כמו שהוא היה כשהוא הועתק.
כלומר, בלי שלב ביניים של הסרת תוכן זדוני או רגיש שדפדפנים בדרך כלל מבצעים, מסיבות טובות. במדריך הזה מוסבר איך להשתמש בו.
כשעובדים עם Async Clipboard API, ברוב המקרים המפתחים לא צריכים לדאוג לגבי תקינות התוכן בלוח, ויכולים להניח שמה שהם כותבים בלוח (העתקה) הוא אותו דבר שהם יקבלו כשהם קוראים את הנתונים מהלוח (הדבקה).
זה נכון במיוחד לגבי טקסט. נסו להדביק את הקוד הבא ב-DevTools Console ואז למקד מחדש את הדף מיד. (הערך 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 Console. תבחינו שהפלט שונה באופן משמעותי מהקלט.
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 לא מנוקה
כשאתם write() (מעתיקים) HTML ללוח באמצעות Async Clipboard API, הדפדפן מוודא שהפורמט שלו תקין על ידי הפעלה שלו דרך מנתח DOM וסריאליזציה של מחרוזת ה-HTML שנוצרה, אבל בשלב הזה לא מתבצעת הסרת תוכן זדוני או רגיש. אתם לא צריכים לעשות כלום. כשאתם read() HTML שהוצב בלוח על ידי אפליקציה אחרת, ואפליקציית האינטרנט שלכם בוחרת לקבל את התוכן המלא וצריכה לבצע הסרת תוכן זדוני או רגיש בקוד שלכם, אתם יכולים להעביר אובייקט אפשרויות ל-method 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.
קישורים שימושיים
תודות
המאמר הזה נבדק על ידי Anupam Snigdha ו-Rachel Andrew. ה-API צוין והוטמע על ידי הצוות של Microsoft Edge.