Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

crossorigin: scegliere la modalità CORS

Coordina la richiesta del browser con il permesso del server della risorsa.

Versione: HTML Living Standard

Sintassi

<img crossorigin="anonymous" src="https://images.knowledge.test/pixel.svg" alt="Red pixel">

Sugli elementi immagine, media, script e link supportati, crossorigin controlla il caricamento CORS. anonymous usa CORS con credenziali della stessa origine; use-credentials include le credenziali. Un valore vuoto o non valido significa anonymous. L’assenza è diversa: alcune risorse usano no-CORS, mentre i moduli richiedono sempre CORS e applicano l’impostazione alle credenziali.

Il server deve restituire intestazioni appropriate; l’attributo da solo non concede accesso. Le risposte con credenziali richiedono un’origine esplicitamente consentita e il permesso per le credenziali, non un’origine jolly. Imposta la modalità prima della richiesta. Mostrare un’immagine di altra origine non permette automaticamente di leggerne i pixel dal canvas.

Due origini isolate servono la stessa immagine con permesso CORS anonimo. La lettura riesce per l’immagine CORS ma genera un errore di sicurezza per quella ordinaria di altra origine. Non intervengono credenziali reali o server esterni.

Esempi

<!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>

Risultato

cors=255; plain=SecurityError

Entrambe le origini sono intercettate localmente; intestazioni e sicurezza del canvas sono verificate.

Fonti