Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

crossorigin: tryb żądania CORS

Połącz ustawienie żądania przeglądarki z uprawnieniem udzielanym przez serwer zasobu.

Wersja: HTML Living Standard

Składnia

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

Na obsługiwanych obrazach, mediach, skryptach i odnośnikach crossorigin steruje pobieraniem związanym z CORS. anonymous używa CORS z poświadczeniami dla tego samego pochodzenia; use-credentials uwzględnia poświadczenia także między pochodzeniami. Pusta lub błędna wartość oznacza anonymous. Pominięcie jest inne: część zasobów używa no-CORS, a moduły zawsze wymagają CORS i używają ustawienia dla poświadczeń.

Serwer musi zwrócić odpowiednie nagłówki; atrybut sam nie przyznaje dostępu. Odpowiedzi z poświadczeniami wymagają jawnego dozwolonego pochodzenia i zgody na poświadczenia, nie gwiazdki. Ustaw tryb przed rozpoczęciem żądania. Wyświetlenie obcego obrazu nie oznacza prawa odczytu jego pikseli z płótna.

Dwa odizolowane pochodzenia serwują ten sam obraz z pozwoleniem na anonimowy CORS. Odczyt pikseli działa dla obrazu CORS, ale zwykły obraz z innego pochodzenia powoduje błąd bezpieczeństwa. Nie używamy prawdziwych poświadczeń ani zewnętrznego serwera.

Przykłady

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

Wynik

cors=255; plain=SecurityError

Oba pochodzenia są przechwytywane lokalnie; test sprawdza nagłówki odpowiedzi i zabezpieczenie płótna.

Źródła