Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / HTML

crossorigin: elegir un modo de petición CORS

Coordina la petición del navegador con el permiso del servidor del recurso.

Versión: HTML Living Standard

Sintaxis

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

En elementos compatibles de imagen, medios, script y enlace, crossorigin controla la carga relacionada con CORS. anonymous usa CORS con credenciales del mismo origen; use-credentials incluye credenciales. Un valor vacío o inválido significa anonymous. Omitirlo es diferente: algunos recursos usan no-CORS, mientras los módulos siempre requieren CORS y aplican el ajuste a las credenciales.

El servidor debe devolver cabeceras CORS adecuadas; el atributo no concede acceso por sí solo. Las respuestas con credenciales requieren un origen permitido explícito y permiso para credenciales, no un comodín. Configura el modo antes de iniciar la petición. Mostrar una imagen de otro origen no permite automáticamente leer sus píxeles desde un lienzo.

Dos orígenes aislados sirven la misma imagen con permiso CORS anónimo. La lectura funciona con la imagen CORS, pero la imagen externa ordinaria provoca un error de seguridad. No intervienen credenciales reales ni servidores externos.

Ejemplos

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

Resultado

cors=255; plain=SecurityError

Ambos orígenes se interceptan localmente; se verifican las cabeceras y la protección del lienzo.

Fuentes