CKTIS / JavaScript
Clipboard.read — lecture asynchrone du presse-papiers
La méthode navigator.clipboard.read() lit les éléments du presse-papiers et leurs représentations MIME. Elle nécessite un contexte sécurisé et l’autorisation du navigateur pour accéder au presse-papiers.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
navigator.clipboard.read()
navigator.clipboard.read({ unsanitized: ["text/html"] })Clipboard.read, appelée avec navigator.clipboard.read(), renvoie une Promise qui fournit un tableau d’objets ClipboardItem, et non du texte. item.types répertorie les types MIME ; await item.getType(type) fournit un Blob. En revanche, readText() lit le texte sous forme de chaîne de caractères.
Il s’agit d’une API Web, et non d’une fonctionnalité ECMAScript. Elle nécessite un contexte sécurisé ainsi qu’un document actif ayant le focus. Appelez-la après une interaction de l’utilisateur ; un clic ne garantit pas l’accès. Un refus peut entraîner NotAllowedError. Détecter la méthode ne confirme pas l’autorisation ; Node 24 ne prouve pas la prise en charge par un navigateur.
L’option { unsanitized: ["text/html"] } demande du HTML non assaini, sans garantir ce résultat. Considérez les données du presse-papiers comme non fiables ; ne les insérez pas directement avec innerHTML. L’exemple affiche le texte avec textContent.
Exemples
<!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>Résultat
Clipboard.read(): unavailable or denied
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.