CKTIS / HTML
crossorigin : choisir le mode de requête CORS
Accordez la requête du navigateur avec la permission du serveur distant.
Version : HTML Living Standard
Syntaxe
<img crossorigin="anonymous" src="https://images.knowledge.test/pixel.svg" alt="Red pixel">Sur les éléments image, média, script et lien concernés, crossorigin contrôle le chargement CORS. anonymous utilise CORS avec les identifiants de même origine ; use-credentials inclut les identifiants. Une valeur vide ou invalide signifie anonymous. L’absence diffère : certaines ressources utilisent no-CORS, tandis que les modules exigent toujours CORS et emploient ce réglage pour les identifiants.
Le serveur doit renvoyer des en-têtes CORS adaptés ; l’attribut seul n’autorise rien. Une réponse avec identifiants exige une origine explicitement permise et l’autorisation des identifiants, pas une origine générique. Réglez le mode avant la requête. Afficher une image d’une autre origine n’autorise pas automatiquement la lecture de ses pixels dans un canevas.
Deux origines isolées servent la même image avec permission CORS anonyme. La lecture réussit pour l’image CORS mais provoque une erreur de sécurité pour l’image interorigine ordinaire. Aucun véritable identifiant ou serveur externe n’intervient.
Exemples
<!doctype html><meta charset="utf-8"><output id="result"></output><script>
async function readPixel(cors) {
const image = new Image();
if (cors) image.crossOrigin = 'anonymous'; // Set before starting the request.
image.src = 'https://images.knowledge.test/pixel.svg?' + (cors ? 'cors' : 'plain');
await image.decode();
const canvas = document.createElement('canvas'); canvas.width = canvas.height = 1;
const context = canvas.getContext('2d'); context.drawImage(image, 0, 0);
try { return context.getImageData(0, 0, 1, 1).data[0]; }
catch (error) { return error.name; }
}
// The intercepted second-origin image response explicitly allows anonymous CORS.
Promise.all([readPixel(true), readPixel(false)]).then(([cors, plain]) => {
document.querySelector('#result').textContent = 'cors=' + cors + '; plain=' + plain;
});
</script>Résultat
cors=255; plain=SecurityError
Les deux origines sont interceptées localement ; les en-têtes et la protection du canevas sont vérifiés.