Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

Window : propriété crypto

Baseline Widely available

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.

La propriété en lecture seule crypto de l'interface Window retourne l'objet Crypto pour la portée de cette fenêtre. Cet objet donne accès à certains services liés à la cryptographie pour les pages web.

Bien que la propriété elle-même soit en lecture seule, toutes ses méthodes (et celles de son objet enfant, SubtleCrypto) ne le sont pas, et sont donc vulnérables à une attaque par prothèse d'émulation.

Bien que crypto soit disponible sur toutes les fenêtres, l'objet Crypto retourné ne possède qu'une seule fonctionnalité utilisable dans les contextes non sécurisés : la méthode getRandomValues(). En général, il faut utiliser cette API uniquement dans des contextes sécurisés.

Valeur

Une instance de l'interface Crypto, donnant accès à la cryptographie d'usage général et à un générateur de nombres aléatoires robuste.

Exemples

Cet exemple utilise la propriété crypto pour accéder à la méthode getRandomValues().

HTML

html
<p id="myRandText">Les nombres aléatoires sont&nbsp;:</p>
<button type="button">Générer 10 nombres aléatoires</button>

JavaScript

js
function genererNombresAleatoires() {
  const tableau = new Uint32Array(10);
  globalThis.crypto.getRandomValues(tableau);

  const texteAleatoire = document.getElementById("myRandText");
  texteAleatoire.textContent = `Les nombres aléatoires sont : ${tableau.join(" ")}`;
}

document
  .querySelector("button")
  .addEventListener("click", genererNombresAleatoires);

Résultat

Spécifications

Specification
Web Cryptography Level 2
# dom-windoworworkerglobalscope-crypto

Compatibilité des navigateurs

Voir aussi