CKTIS / JavaScript
Element.innerHTML — odczyt i zastępowanie zawartości HTML
Element.innerHTML odczytuje zawartość elementu jako zapis HTML lub zastępuje ją węzłami utworzonymi z podanego znacznika. Nie oczyszcza niezaufanych danych i może powodować XSS.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
const markup = element.innerHTML;
element.innerHTML = markup;Element.innerHTML jest właściwością Web API, a nie częścią samego ECMAScript. Odczyt serializuje zawartość elementu bez jego zewnętrznego znacznika i bez drzew shadow DOM. Wynik nie musi być identyczny z pierwotnym zapisem źródłowym.
Przypisanie parsuje znacznik w kontekście elementu i zastępuje jego dotychczasową zawartość; nie zastępuje samego elementu. Dla template zmienia zawartość szablonu. W dokumencie XML niepoprawny składniowo XML powoduje SyntaxError.
Bezpieczeństwo: przypisanie domyślnie nie usuwa niebezpiecznych elementów ani atrybutów. Niewykonywanie wstawionych elementów script nie chroni przed XSS, na przykład przez atrybuty obsługi zdarzeń. Nie przekazuj bezpośrednio niezaufanego HTML. Gdy wymuszane są Trusted Types, przypisanie zwykłego tekstowego ciągu może zostać odrzucone.
Przykład używa wyłącznie stałego, zaufanego znacznika. Drugie przypisanie zastępuje pierwszą zawartość, dlatego pozostaje jedno dziecko. Uruchom go w przeglądarce; obecność Node 24 w repozytorium nie dowodzi dostępności tego API.
Przykłady
const box = document.createElement('div');
box.innerHTML = '<strong>Hello</strong>';
console.log(box.innerHTML);
box.innerHTML = '<em>Bye</em>';
console.log(box.innerHTML);
console.log(box.children.length);Wynik
<strong>Hello</strong> <em>Bye</em> 1
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.