CKTIS / JavaScript
Clipboard.read — asinhrono branje odložišča
Metoda navigator.clipboard.read() prebere elemente odložišča in njihove predstavitve MIME. Zahteva varen kontekst in dovoljenje brskalnika za dostop do odložišča.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
navigator.clipboard.read()
navigator.clipboard.read({ unsanitized: ["text/html"] })Clipboard.read, klicana kot navigator.clipboard.read(), vrne Promise z matriko objektov ClipboardItem, ne besedila. item.types našteje vrste MIME; await item.getType(type) zagotovi Blob. Nasprotno pa readText() prebere besedilo kot niz.
To je spletni API, ne funkcija ECMAScript. Zahteva varen kontekst in aktiven dokument, ki ima fokus. Pokličite jo po uporabnikovi interakciji; klik dostopa ne zagotavlja. Zavrnitev lahko povzroči NotAllowedError. Zaznava metode ne potrjuje dovoljenja; Node 24 ne dokazuje podpore v brskalniku.
Možnost { unsanitized: ["text/html"] } zahteva neočiščen HTML, vendar tega rezultata ne zagotavlja. Podatke iz odložišča obravnavajte kot nezaupanja vredne; ne vstavljajte jih neposredno prek innerHTML. Primer prikaže besedilo z textContent.
Primeri
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Clipboard.read without clipboard access</title>
</head>
<body>
<p id="result" role="status"></p>
<script>
const frame = document.createElement('iframe');
frame.title = 'Clipboard.read permission test';
frame.hidden = true;
frame.allow = "clipboard-read 'none'";
frame.srcdoc = `<!doctype html>
<html lang="en"><head><meta charset="utf-8">
<title>Clipboard.read test</title></head><body>
<script>
(async () => {
const blocked = 'Clipboard.read(): unavailable or denied';
const clipboard = navigator.clipboard;
const policy = document.featurePolicy;
// Only call the native API if the policy recognizes and denies clipboard-read.
if (typeof clipboard?.read !== 'function' ||
!policy?.features?.().includes('clipboard-read') ||
policy.allowsFeature?.('clipboard-read') !== false) {
parent.postMessage(blocked, '*');
return;
}
try {
await clipboard.read();
parent.postMessage('Clipboard.read(): unexpectedly allowed', '*');
} catch (error) {
parent.postMessage(error.name === 'NotAllowedError' ? blocked :
'Clipboard.read(): ' + error.name, '*');
}
})();
<\/script></body></html>`;
window.addEventListener('message', (event) => {
if (event.source === frame.contentWindow) {
document.querySelector('#result').textContent = event.data;
}
});
document.body.append(frame);
</script>
</body>
</html>Rezultat
Clipboard.read(): unavailable or denied
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.