ตั้งแต่ Chrome 120 เป็นต้นไป ตัวเลือก 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 ขาเข้าและขาออกเป็นสิ่งสำคัญต่อการทำงานที่ถูกต้องของแอป ในสถานการณ์เหล่านี้ คุณมี 2 ตัวเลือกดังนี้
- หากคุณควบคุมทั้งการคัดลอกและการวาง เช่น หากคัดลอกจากภายในแอปเพื่อวางภายในแอปในลักษณะเดียวกัน คุณควรใช้รูปแบบที่กำหนดเองบนเว็บสำหรับ Async Clipboard API โปรดหยุดอ่านที่นี่และดูบทความที่ลิงก์ไว้
- หากคุณควบคุมเฉพาะการวางในแอป แต่ไม่ได้ควบคุมการคัดลอก อาจเป็นเพราะการคัดลอกเกิดขึ้นในแอปที่มากับเครื่องซึ่งไม่รองรับรูปแบบที่กำหนดเองของเว็บ คุณควรใช้ตัวเลือก
unsanitizedซึ่งอธิบายไว้ในส่วนที่เหลือของบทความนี้
การตรวจสอบความปลอดภัยรวมถึงการดำเนินการต่างๆ เช่น การนำแท็ก script ออก การจัดรูปแบบในบรรทัด และการตรวจสอบว่า HTML มีรูปแบบที่ถูกต้อง รายการนี้ยังไม่ครอบคลุมทั้งหมด และอาจมีการเพิ่มขั้นตอนอื่นๆ ในอนาคต
คัดลอกและวาง HTML ที่ไม่ผ่านการตรวจสอบความปลอดภัย
เมื่อคุณwrite() (คัดลอก) HTML ไปยังคลิปบอร์ดด้วย Async Clipboard API เบราว์เซอร์จะตรวจสอบว่า HTML มีรูปแบบที่ถูกต้องโดยเรียกใช้ผ่านโปรแกรมแยกวิเคราะห์ 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
ลิงก์ที่มีประโยชน์
การรับทราบ
บทความนี้ได้รับการตรวจสอบโดย Anupam Snigdha และ Rachel Andrew ทีม Microsoft Edge เป็นผู้ระบุและติดตั้งใช้งาน API นี้