База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Element.innerHTML и граници на сигурността при вмъкване на текст

Разграничи разбора на маркировка от вмъкването на буквален текст. Научи как да предотвратяваш DOM XSS и какво се променя при налагане на Trusted Types.

Версия: ECMAScript 2024 and the current web platform; runtime support varies

Синтаксис

const markup = element.innerHTML;
element.innerHTML = htmlStringOrTrustedHTML;
const text = element.textContent;
element.textContent = plainText;
element.append(plainText);
element.insertAdjacentText("beforeend", plainText);
element.setHTML(htmlToSanitize); // Where supported.

Четенето на Element.innerHTML връща сериализираното съдържание на елемента без външния му таг. При присвояване в HTML документ фрагментът се анализира в контекста на елемента и обикновено заменя съществуващите му дъщерни възли. При HTML елемент <template> четенето сериализира съдържанието на template.content, а присвояването заменя дъщерните възли на този DocumentFragment, а не тези на самия елемент. element.innerHTML += fragment също заменя възлите, вместо да добавя нови след тях: първо прочита сериализираното съдържание, а след това анализира отново съединения низ.

Четенето на Node.textContent върху елемент връща обединения текст на наследниците му, а не тяхната маркировка. Присвояването на непразен низ заменя дъщерните възли с един текстов възел, а празният низ ги премахва. За да запазиш съществуващите възли, добави низ в края с append(text) или го вмъкни на избрано място спрямо елемента с insertAdjacentText(position, text). Никоя от тези текстови операции не интерпретира маркировката или символните препратки в низа.

Не подавай недоверени низове на innerHTML: това е точка за инжектиране на HTML, което може да доведе до DOM XSS. Вмъкнатите по този начин елементи script не се изпълняват, но други механизми, например атрибути за обработка на събития, все още могат да изпълнят код. Показвай недоверен текст в обикновен елемент като div. Вмъкването като текст не прави същите данни безопасни в контекст на скрипт, стил или URL, нито при последващ анализ като HTML.

Ако ти трябва форматиран HTML от недоверен източник, използвай setHTML(), където се поддържа, или почисти HTML с проверен инструмент преди вмъкването. Никога не използвай присвояване на непочистен HTML към innerHTML като резервен вариант. Ако CSP налага Trusted Types и няма политика по подразбиране, присвояването на обикновен низ към innerHTML предизвиква TypeError. TrustedHTML не гарантира почистване: сигурността зависи от политиката, създала обекта. Това са API на уеб платформата, а не възможности на ECMAScript; провери поддръжката на защитите, които използваш.

Примери

<!doctype html>
<meta charset="utf-8">
<title>innerHTML and textContent</title>
<script>
{
  const sample = "<em>A &amp; B</em>";
  const parsed = document.createElement("div");
  const literal = document.createElement("div");

  parsed.innerHTML = sample;
  literal.textContent = sample;

  console.log(`innerHTML: ${parsed.childElementCount} | ${parsed.textContent}`);
  console.log(`textContent: ${literal.childElementCount} | ${literal.textContent}`);
}
</script>

Резултат

innerHTML: 1 | A & B
textContent: 0 | <em>A &amp; B</em>

Запази примера като HTML файл, отвори го в браузър без налагане на Trusted Types и провери резултата в конзолата на браузъра. Фиксираният низ е безвреден: анализът създава един елемент `em` и преобразува символната препратка в `&`. Вмъкването като текст запазва целия низ и не създава дъщерен елемент.

Свързани уроци

  • JavaScript · Урок 15 · Напреднало · Версия: 4

Източници