WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

crossorigin: den CORS-Anfragemodus wählen

Verbinden Sie Browseranfragen mit der Zustimmung des Ressourcenservers.

Version: HTML Living Standard

Syntax

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

Bei unterstützten Bild-, Medien-, Skript- und Linkelementen steuert crossorigin CORS-bezogenes Laden. anonymous verwendet CORS mit Zugangsdaten nur für denselben Ursprung; use-credentials schließt Zugangsdaten ein. Leere und ungültige Werte bedeuten anonymous. Weglassen unterscheidet sich: Manche Ressourcen nutzen no-CORS, Module erfordern immer CORS und verwenden die Einstellung für Zugangsdaten.

Der Server muss passende CORS-Header senden; das Attribut allein gewährt keinen Zugriff. Antworten mit Zugangsdaten brauchen einen ausdrücklich erlaubten Ursprung und die Zustimmung zu Zugangsdaten, keinen Platzhalter-Ursprung. Setzen Sie den Modus vor Beginn der Anfrage. Die Anzeige eines fremden Bildes erlaubt nicht automatisch das Lesen seiner Canvas-Pixel.

Zwei isolierte Ursprünge liefern dasselbe Bild mit Erlaubnis für anonymes CORS. Pixellesen gelingt beim CORS-Bild, beim gewöhnlichen fremden Bild entsteht ein Sicherheitsfehler. Echte Zugangsdaten oder externe Server sind nicht beteiligt.

Beispiele

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

Ergebnis

cors=255; plain=SecurityError

Beide Ursprünge werden lokal abgefangen; Antwortheader und Canvas-Schutz werden geprüft.

Quellen