KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / HTML

crossorigin: een CORS-aanvraagmodus kiezen

Stem de browseraanvraag af op toestemming van de bronserver.

Versie: HTML Living Standard

Syntax

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

Op ondersteunde afbeelding-, media-, script- en linkelementen regelt crossorigin CORS-gerelateerd ophalen. anonymous gebruikt CORS met gegevens voor dezelfde oorsprong; use-credentials neemt toegangsgegevens mee. Een lege of ongeldige waarde betekent anonymous. Weglaten verschilt: sommige bronnen gebruiken no-CORS, terwijl modules altijd CORS eisen en de instelling voor toegangsgegevens gebruiken.

De server moet geschikte CORS-headers terugsturen; het attribuut geeft niet zelfstandig toegang. Antwoorden met toegangsgegevens vereisen een expliciete toegestane oorsprong en toestemming voor die gegevens, geen wildcard-oorsprong. Stel de modus vóór de aanvraag in. Een afbeelding van een andere oorsprong tonen geeft niet automatisch toegang tot haar canvaspixels.

Twee geïsoleerde oorsprongen leveren hetzelfde beeld met anonieme CORS-toestemming. Pixels lezen lukt bij het CORS-beeld, maar geeft een beveiligingsfout bij het gewone beeld van een andere oorsprong. Er worden geen echte toegangsgegevens of externe servers gebruikt.

Voorbeelden

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

Resultaat

cors=255; plain=SecurityError

Beide oorsprongen worden lokaal onderschept; responsheaders en canvasbeveiliging worden gecontroleerd.

Bronnen