Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / HTML

crossorigin: escolher o modo de pedido CORS

Articule o pedido do navegador com a permissão do servidor do recurso.

Versão: HTML Living Standard

Sintaxe

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

Nos elementos compatíveis de imagem, multimédia, script e ligação, crossorigin controla o carregamento CORS. anonymous usa CORS com credenciais da mesma origem; use-credentials inclui credenciais. Um valor vazio ou inválido significa anonymous. A omissão é diferente: alguns recursos usam no-CORS, enquanto módulos exigem sempre CORS e aplicam a definição às credenciais.

O servidor tem de devolver cabeçalhos CORS adequados; o atributo não concede acesso sozinho. Respostas com credenciais exigem uma origem explicitamente autorizada e permissão para credenciais, não uma origem universal. Defina o modo antes de iniciar o pedido. Mostrar uma imagem de outra origem não permite automaticamente ler os seus píxeis num canvas.

Duas origens isoladas servem a mesma imagem com permissão CORS anónima. A leitura funciona para a imagem CORS, mas a imagem normal de outra origem provoca um erro de segurança. Não intervêm credenciais reais nem servidores externos.

Exemplos

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

Ambas as origens são intercetadas localmente; verificam-se os cabeçalhos e a proteção do canvas.

Fontes