CKTIS / HTML
crossorigin: režim požadavku CORS
Spojte nastavení požadavku s povolením serveru prostředku.
Verze: HTML Living Standard
Syntaxe
<img crossorigin="anonymous" src="https://images.knowledge.test/pixel.svg" alt="Red pixel">Na podporovaných obrázcích, médiích, skriptech a odkazech crossorigin řídí načítání spojené s CORS. anonymous používá CORS s přihlašovacími údaji stejného původu; use-credentials zahrnuje přihlašovací údaje. Prázdná nebo neplatná hodnota znamená anonymous. Vynechání je jiné: některé prostředky používají no-CORS, moduly vždy vyžadují CORS a nastavení vztahují k přihlašovacím údajům.
Server musí vrátit vhodné CORS hlavičky; atribut sám přístup neuděluje. Odpovědi s přihlašovacími údaji potřebují výslovně povolený původ a souhlas s údaji, nikoli zástupný původ. Režim nastavte před požadavkem. Zobrazení cizího obrázku automaticky nepovoluje čtení jeho pixelů z plátna.
Dva izolované původy dodávají stejný obrázek s anonymním CORS povolením. Čtení pixelů u CORS obrázku uspěje, u běžného cizího obrázku vyvolá bezpečnostní chybu. Nepoužívají se skutečné přihlašovací údaje ani externí server.
Příklady
<!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>Výsledek
cors=255; plain=SecurityError
Oba původy jsou místně zachyceny; ověřují se hlavičky odpovědí i zabezpečení plátna.