Code de la touche Impr. écran

Impr. écran envoie event.key « PrintScreen » et keyCode 44, et sous Windows seulement au keyup.

Toutes les valeurs d’un coup d’œil

Valeurs pour Impr. écran
Toucheevent.codeevent.keykeyCodekeyCode sur Macevent.location
Impr. écran / F13PrintScreenPrintScreen441240 (Standard)

keyCode tel que Chrome et Edge l’envoient sous Windows. La colonne Mac (Chrome et Safari sur Mac) et la colonne Firefox n’affichent que les nombres qui diffèrent. Certaines touches diffèrent aussi selon le système, comme le dit le texte plus bas. event.which est toujours le même nombre que keyCode. event.key correspond à une disposition américaine sans Maj.

Appuyez dessus ici

Cliquez ici, puis appuyez sur Impr. écran

Vous n’utilisez que le clavier ? Appuyez sur Échap, puis sur Tab, pour quitter la zone de touche.

Code pour réagir à Impr. écran

Recommandé : reconnaître event.key
document.addEventListener('keyup', (event) => {
  if (event.key === 'PrintScreen') {
    // Votre code ici
  }
});
Reconnaître la place de la touche : event.code
document.addEventListener('keyup', (event) => {
  if (event.code === 'PrintScreen') {
    // Votre code ici
  }
});
Ancien code qui utilise encore keyCode (obsolète)
document.addEventListener('keyup', (event) => {
  if (event.keyCode === 44) {
    // Votre code ici
  }
});

Quelle valeur utiliser

Vérifiez event.key === 'PrintScreen' (ou event.code, qui est identique). keyCode vaut 44 sous Windows. Sur un Mac, la touche Impr. écran d’un clavier PC fonctionne comme F13 : Chrome et Safari donnent key et code "F13" avec keyCode 124, donc une vérification de PrintScreen ne la reconnaît pas sur Mac.

Écoutez keyup, pas keydown. Windows garde l’appui de la touche pour lui et ne transmet que le relâchement au navigateur.

Ce qui pose problème

Mon gestionnaire keydown ne voit jamais Impr. écran

Sous Windows, le navigateur ne reçoit qu’un keyup. Déplacez la vérification sur keyup :

window.addEventListener('keyup', (event) => {
  if (event.key === 'PrintScreen') { /* ... */ }
});

Sous Linux, l’outil de capture du bureau prend souvent la touche, et la page peut ne rien recevoir du tout.

Je veux bloquer les captures d’écran

Une page web ne le peut pas. Impr. écran enregistre l’image avant que votre page entende la touche, et beaucoup de captures n’utilisent pas cette touche : Windows + Maj + S, l’Outil Capture d’écran, Commande + Maj + 3, 4 ou 5 sur un Mac, les boutons d’un téléphone, ou un autre appareil photo. Vider le presse-papiers au keyup n’aide pas non plus : à ce moment, la capture peut déjà être enregistrée dans un fichier, et les versions récentes de Windows ouvrent l’Outil Capture d’écran avec Impr. écran.

Une vidéo protégée (DRM) peut apparaître en noir sur certaines captures, mais seulement la vidéo, et pas sur tous les systèmes.

Je veux savoir quand quelqu’un a fait une capture d’écran

Impossible de le savoir de façon fiable. Le keyup vous dit qu’Impr. écran a été pressée pendant que votre page avait le focus sous Windows. Il ne dit pas si une capture a été enregistrée, et toutes les autres façons d’en faire une restent invisibles pour la page.

Impr. écran demande Fn sur mon portable

Beaucoup de portables placent Impr. écran sur une autre touche avec Fn. Le navigateur reçoit quand même "PrintScreen", car le clavier gère Fn lui-même. Certains portables n’ont pas de touche Impr. écran du tout.

Remarque : un Mac n’a pas de touche Impr. écran. Ses raccourcis de capture sont Commande + Maj + 3 (tout l’écran), Commande + Maj + 4 (une zone) et Commande + Maj + 5 (la barre d’outils). macOS les prend pour lui : la page ne les reçoit donc pas comme un raccourci.

Alt+Impr. écran

Sous Windows, Alt + Impr. écran capture seulement la fenêtre active. La page peut voir le keydown d’Alt, puis le keyup d’Impr. écran, avec event.altKey à true.