URLs de données, URLs préfixées par le schémadata:, permettent aux créateur·ice·s de contenu d'intégrer de petits fichiers inline dans des documents. Elles étaient auparavant connues sous le nom de « data URIs » jusqu'à ce que ce nom soit retiré par le WHATWG.

Syntaxe

data:[<media-type>][;base64],<data>

data:

Le schéma de l'URL.

<media-type>Facultatif

Letype MIME indiquant le type de donnée, commeimage/jpeg pour un fichier image JPEG. Si omis, la valeur par défaut esttext/plain;charset=US-ASCII. Vous pouvez consulterune explication complète de la structure des types MIME etun tableau des types MIME courants sur le web.

;base64Facultatif

Indique que la donnée doit être décodée en base64 ; voirencodage des données au format base64.

<data>

La donnée elle-même. Si la donnée contient descaractères définis comme réservés dans la RFC 3986^(angl.), ou contient des espaces, des retours à la ligne ou d'autres caractères non imprimables, ces caractères doivent êtreencodés en pourcentage. Si la donnée est textuelle, vous pouvez intégrer le texte (en utilisant les entités ou échappements appropriés selon le type de document englobant). Sinon, vous pouvez définirbase64 pour intégrer des données binaires encodées en base64.

Quelques exemples :

data:,Bonjour%2C%20le%20Monde%20%21

Les données text/plainBonjour, le Monde !. Notez que la virgule estencodée en pourcentage en%2C, et l'espace en%20.

data:text/plain;base64,SGVsbG8sIFdvcmxkIQ==

Version encodée en base64 de l'exemple ci-dessus

data:text/html,%3Ch1%3EBonjour%2C%20le%20Monde%20%21%3C%2Fh1%3E

Un document HTML avec<h1>Bonjour, le Monde !</h1>

data:text/html,%3Cscript%3Ealert%28%27salut%27%29%3B%3C%2Fscript%3E

Un document HTML avec<script>alert('salut');</script> qui exécute une alerte JavaScript. Notez que la balise fermante du script est requise.

Encodage des données au format base64

Base64 est un groupe de schémas d'encodage binaire-vers-texte qui représentent des données binaires dans une chaîne de caractèresASCII en les traduisant en une représentation en base 64. Comme elle n'utilise que des caractères autorisés par la syntaxe des URLs (« sûr pour les URLs »), on peut encoder des données binaires dans des URLs de données sans risque. Base64 utilise les caractères+ et/, qui peuvent avoir des significations particulières dans les URLs. Comme les URLs de données n'ont pas de segments de chemin ou de paramètres de requête, cet encodage est sûr dans ce contexte.

Encodage en JavaScript

Les APIs web proposent des méthodes natives pour encoder ou décoder en base64 :Base64.

Encodage sur un système Unix

L'encodage base64 d'un fichier ou d'une chaîne sur les systèmes Linux et macOS peut être réalisé avec la commandebase64 (ou, en alternative, l'utilitaireuuencode avec l'argument-m).

echo -n bonjour|base64# sorties vers la console : Ym9uam91cg==echo -n bonjour>a.txtbase64 a.txt# sorties vers la console : Ym9uam91cg==base64 a.txt>b.txt# sorties vers le fichier b.txt : Ym9uam91cg==

Encodage sous Microsoft Windows

Sous Windows,Convert.ToBase64String^(angl.) de PowerShell peut être utilisé pour effectuer l'encodage Base64 :

[convert]::ToBase64String([Text.Encoding]::UTF8.GetBytes("bonjour"))# sorties vers la console : Ym9uam91cg==

Alternativement, un shell GNU/Linux (commeWSL) fournit l'utilitairebase64 :

bash$ echo -n bonjour | base64# sorties vers la console : Ym9uam91cg==

Problèmes habituels

Cette section décrit les problèmes qui apparaissent fréquemment lors de la création et de l'utilisation des URLs de typedata

data:text/html,beaucoup de texte…<p><span class%3D"bottom">bas</span>?arg=val</p>

Cela représente une ressource HTML dont le contenu est le suivant :

beaucoup de texte…<p><span>bas</span>?arg=val</p>

Syntaxe

Le format des URLs de typedata est très simple, mais il est facile d'oublier la virgule avant le segment de données ou de mal encoder la donnée en base64.

Mise en forme HTML

Une URL de typedata fournit un fichier dans un fichier, qui peut potentiellement être très large par rapport au document englobant. En tant qu'URL, la donnée devrait pouvoir être mise en forme avec des espaces (saut de ligne, tabulation ou espace), mais des problèmes pratiques apparaissentlors de l'encodage en base64^(angl.).

Limitations de longueur

Les navigateurs ne sont pas obligés de supporter une longueur maximale particulière pour la donnée.Chromium et Firefox limitent les URLs de typedata à 512 Mo, et Safari (WebKit) à 2048 Mo.Notez que Firefox 97 a augmenté la limite de 256 Ko à 32 Mo, etFirefox 136 l'a portée à 512 Mo.

Absence de gestion d'erreur

Les paramètres invalides dans le média, ou les coquilles lors de la spécification de'base64', sont ignorés, mais aucune erreur n'est retournée.

Aucun support des chaînes de requête, etc.

La partie donnée d'une URL de typedata est opaque, donc toute tentative d'utiliser une chaîne de requête (paramètres spécifiques à la page, avec la syntaxe<url>?parameter-data) avec une URL de typedata inclura simplement la chaîne de requête dans la donnée représentée par l'URL.

Problèmes de sécurité

De nombreux problèmes de sécurité (par exemple, le phishing) ont été associés aux URLs de typedata, et à la navigation vers celles-ci au niveau supérieur du navigateur. Pour limiter ces problèmes, la navigation de haut niveau vers les URLsdata: est bloquée dans tous les navigateurs modernes. Voircet article du Mozilla Security Team^(angl.) pour plus de détails.

Spécifications

Compatibilité des navigateurs

Voir_aussi

• L'entrée de glossaireBase64
• L'entrée de glossairePercent-encoding
• La méthode globaleatob()
• La méthode globalebtoa()
• Le type de donnée CSS<url>
• L'entrée de glossaireURI