CKTIS / HTML
Атрибут integrity — цялост на ресурсите
Атрибутът integrity предоставя на браузъра очаквания хеш на външен ресурс. Subresource Integrity (SRI) позволява да бъде отхвърлен скрипт или стилов файл, чието съдържание не съвпада с декларираните метаданни.
Версия: WHATWG HTML Living Standard; index snapshot date recorded separately
Синтаксис
integrity="sha256-<base64-digest>"integrity е текстов атрибут за Subresource Integrity (SRI), а не глобален или булев атрибут. Формата sha256-<base64-digest> съчетава име на алгоритъм с хеш, кодиран в Base64. Хешът описва съдържанието на ресурса, а не неговия URL; промяна в съдържанието изисква актуализиране на хеша.
При script атрибутът задава метаданни за цялост при първоначалното изтегляне на външен скрипт. Той не проверява код, написан директно в елемента, и не обхваща автоматично импортирани модули. При link е разрешен само когато rel съдържа stylesheet, preload или modulepreload.
Когато изтеглен ресурс не премине проверката за цялост, браузърът не го използва като успешно зареден скрипт или стилов файл. SRI не замества HTTPS или доверието в документа, съдържащ хеша: нападател, който може да промени както ресурса, така и декларацията му integrity, може да подмени и двете. Ресурсите от друг произход изискват поддръжка на CORS; обикновено се използва crossorigin="anonymous", а сървърът трябва да разреши тази заявка.
Примерът прави два опита да зареди един и същ обект Blob като скрипт. Обектът съдържа точно три байта: abc, без знак за нов ред. При първия опит се използва SHA-256 хеш, който съвпада с хеша на съдържанието, а при втория — хеш, който не съвпада. Примерът показва Matching digest: load и Mismatched digest: error на отделни редове. В други случаи събитието error може да означава и мрежова грешка, а не само несъответствие на хеша. Задайте integrity преди началото на изтеглянето; последваща промяна на атрибута не проверява повторно вече зареден скрипт.
Примери
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Script integrity check</title>
</head>
<body>
<pre id="result" aria-live="polite"></pre>
<script>
// The fixture is exactly three bytes: abc, with no newline.
// Define abc so the fixture can also execute as a classic script.
window.abc = 1;
const fixture = new Blob(['abc'], { type: 'text/javascript' });
function loadWithIntegrity(integrity) {
return new Promise(resolve => {
const url = URL.createObjectURL(fixture);
const script = document.createElement('script');
function finish(event) {
script.remove();
URL.revokeObjectURL(url);
resolve(event.type);
}
script.addEventListener('load', finish, { once: true });
script.addEventListener('error', finish, { once: true });
script.integrity = integrity;
script.src = url;
document.head.append(script);
});
}
Promise.all([
loadWithIntegrity('sha256-ungWv48Bz+pBQUDeXa4iI7ADYaOWF3qctBD/YfIAFa0='),
loadWithIntegrity('sha256-47DEQpj8HBSa+/TImW+5JCeuQeRkm5NMpJWZG3hSuFU=')
]).then(([match, mismatch]) => {
document.getElementById('result').textContent =
`Matching digest: ${match}\nMismatched digest: ${mismatch}`;
});
</script>
</body>
</html>Резултат
Matching digest: load Mismatched digest: error
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.