Chrome 120'den itibaren, Async Clipboard API'de yeni bir unsanitized seçeneği kullanılabilir. Bu seçenek, HTML ile ilgili özel durumlarda panonun içeriğini kopyalandığı zamanki haliyle yapıştırmanız gerektiğinde yardımcı olabilir.
Yani tarayıcıların genellikle ve iyi nedenlerle uyguladığı herhangi bir ara temizleme adımı olmadan. Bu kılavuzda, bu özelliği nasıl kullanacağınızı öğrenebilirsiniz.
Async Clipboard API ile çalışırken çoğu durumda geliştiricilerin panodaki içeriğin bütünlüğü konusunda endişelenmesi gerekmez ve panoya yazdıkları (kopyaladıkları) içeriğin, panodan verileri okuduklarında (yapıştırdıklarında) elde edecekleri içerikle aynı olduğunu varsayabilirler.
Bu, metinler için kesinlikle geçerlidir. Aşağıdaki kodu Geliştirici Araçları konsoluna yapıştırıp sayfaya hemen yeniden odaklanmayı deneyin. (setTimeout(), sayfaya odaklanmak için yeterli zamanınız olması açısından gereklidir. Bu, Async Clipboard API'nin bir şartıdır.) Gördüğünüz gibi giriş, çıkışla tam olarak aynıdır.
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);
Resimlerde durum biraz farklıdır. Tarayıcılar, sıkıştırma bombası saldırılarını önlemek için PNG gibi resimleri yeniden kodlar ancak giriş ve çıkış resimleri görsel olarak piksel piksel tamamen aynıdır.
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);
Peki HTML metinlerine ne olur? Tahmin edebileceğiniz gibi HTML'de durum farklıdır. Burada tarayıcı, kötü şeylerin olmasını önlemek için HTML kodunu temizler. Örneğin, HTML kodundan <script> etiketlerini (ve <meta>, <head> ve <style> gibi diğer etiketleri) çıkarır ve CSS'yi satır içine alır.
Aşağıdaki örneği inceleyin ve Geliştirici Araçları Konsolu'nda deneyin. Çıktının girdiden oldukça farklı olduğunu fark edeceksiniz.
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 temizleme genellikle iyi bir şeydir. Çoğu durumda, temizlenmemiş HTML'ye izin vererek kendinizi güvenlik sorunlarına maruz bırakmak istemezsiniz. Ancak geliştiricinin ne yaptığını tam olarak bildiği ve giriş ile çıkış HTML'sinin bütünlüğünün uygulamanın doğru çalışması için çok önemli olduğu senaryolar vardır. Bu koşullar altında iki seçeneğiniz vardır:
- Hem kopyalama hem de yapıştırma ucunu kontrol ediyorsanız (ör. uygulamanızın içinden kopyalayıp yine uygulamanızın içine yapıştırıyorsanız) Async Clipboard API için web özel biçimlerini kullanmanız gerekir. Burada okumayı durdurun ve bağlantılı makaleyi inceleyin.
- Uygulamanızda yalnızca yapıştırma işlemini kontrol ediyor ancak kopyalama işlemini kontrol etmiyorsanız (ör. kopyalama işlemi, özel web biçimlerini desteklemeyen yerel bir uygulamada gerçekleşiyorsa) bu makalenin geri kalanında açıklanan
unsanitizedseçeneğini kullanmanız gerekir.
Temizleme işlemi, script etiketlerini kaldırma, satır içi stiller ve HTML'nin düzgün biçimlendirilmesini sağlama gibi işlemleri içerir. Bu liste kapsamlı değildir ve gelecekte daha fazla adım eklenebilir.
Temizlenmemiş HTML'yi kopyalama ve yapıştırma
Async Clipboard API ile HTML'yi panoya write() (kopyaladığınızda) tarayıcı, HTML'yi bir DOM ayrıştırıcısından geçirerek ve elde edilen HTML dizesini serileştirerek doğru biçimlendirildiğinden emin olur ancak bu adımda temizleme işlemi yapılmaz. Yapmanız gereken bir şey yok. Başka bir uygulama tarafından panoya yerleştirilen HTML'yi read() ve web uygulamanız tam aslına uygun içeriği almayı seçtiğinde ve kendi kodunuzda temizleme işlemi yapmanız gerektiğinde, read() yöntemine unsanitized özelliği ve ['text/html'] değeri olan bir seçenekler nesnesi iletebilirsiniz. Tek başına şu şekilde görünür:
navigator.clipboard.read({ unsanitized: ['text/html'] }). Aşağıdaki kod örneği, daha önce gösterilenle neredeyse aynıdır ancak bu kez unsanitized seçeneği kullanılmıştır. Geliştirici Araçları Konsolu'nda denediğinizde giriş ve çıkışın aynı olduğunu görürsünüz.
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);
Tarayıcı desteği ve özellik algılama
Özelliğin desteklenip desteklenmediğini doğrudan kontrol etmenin bir yolu yoktur. Bu nedenle, özellik algılama, davranışın gözlemlenmesine dayanır. Bu nedenle, aşağıdaki örnekte <style> etiketinin kalıp kalmadığı (desteklendiğini gösterir) veya satır içine alınıp alınmadığı (desteklenmediğini gösterir) algılanır. Bunun çalışması için sayfanın pano iznini almış olması gerekir.
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);
};
Demo
unsanitized seçeneğinin nasıl çalıştığını görmek için demoyu inceleyin ve kaynak koduna göz atın.
Sonuçlar
Giriş bölümünde de belirtildiği gibi, çoğu geliştiricinin pano temizleme konusunda endişelenmesine gerek yoktur ve tarayıcı tarafından yapılan varsayılan temizleme seçenekleriyle çalışabilir. Geliştiricilerin dikkat etmesi gereken nadir durumlarda unsanitized seçeneği kullanılabilir.
Faydalı bağlantı
Onaylar
Bu makale Anupam Snigdha ve Rachel Andrew tarafından incelenmiştir. API, Microsoft Edge ekibi tarafından belirlenip uygulandı.