Window : méthode atob()
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 méthode atob() de l'interface Window décode une chaîne de données qui a été encodée avec le codage Base64. Vous pouvez utiliser la méthode Window.btoa() pour encoder et transmettre des données qui pourraient autrement poser des problèmes de communication, puis les transmettre et utiliser la méthode atob() pour décoder à nouveau les données. Par exemple, vous pouvez encoder, transmettre et décoder des caractères de contrôle tels que les valeurs ASCII de 0 à 31.
Vous pouvez également utiliser la méthode Uint8Array.fromBase64(), qui crée un objet Uint8Array à partir d'une chaîne de caractères encodée en base64. Cela donne un tableau d'octets, qui est plus facile à manipuler qu'une chaîne de caractères contenant des octets bruts.
Syntaxe
atob(encodedData)
Paramètres
encodedData-
Une chaîne de caractères encodée en base64, utilisant l'alphabet produit par
Window.btoa().
Valeur de retour
Une chaîne de caractères binaire contenant des octets bruts décodés à partir de encodedData. Les chaînes de caractères en JavaScript sont encodées en UTF-16, ce qui signifie que chaque caractère doit avoir un point de code inférieur à 256, représentant un octet de données.
Exceptions
InvalidCharacterErrorDOMException-
Thrown if
encodedDatas not valid base64.
Exemples
const donneesEncodees = window.btoa("Salut, le monde"); // encode une chaîne de caractères
const donneesDecodees = window.atob(donneesEncodees); // décode la chaîne de caractères
Spécifications
| Specification |
|---|
| HTML # dom-atob-dev |
Compatibilité des navigateurs
Voir aussi
- Une prothèse d'émulation pour
atob(angl.) est disponible danscore-js(angl.) - Les url
data WorkerGlobalScope.atob(): la même méthode, mais dans les contextes de travail.- La méthode
Window.btoa() - La méthode
Uint8Array.fromBase64()