ShadowRoot: phương thức getHTML()

Baseline 2024

Newly available

Since September 2024, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

Phương thức getHTML() của giao diện ShadowRoot được dùng để tuần tự hóa DOM của một shadow root thành một chuỗi HTML.

Phương thức này cung cấp một đối số tùy chọn cho phép tuần tự hóa các nút con là shadow root. Các tùy chọn có thể được dùng để bao gồm các shadow root lồng nhau đã được đặt là serializable, và/hoặc một mảng chỉ định gồm các đối tượng ShadowRoot, có thể là open hoặc closed.

Nếu không có đối số, các nút con là shadow root sẽ không được tuần tự hóa, và phương thức này hoạt động giống như việc đọc giá trị của Element.innerHTML.

Lưu ý rằng một số trình duyệt tuần tự hóa các ký tự < và > thành < và > khi chúng xuất hiện trong giá trị thuộc tính (xem Tương thích trình duyệt). Điều này nhằm ngăn một lỗ hổng bảo mật tiềm tàng (mutation XSS) trong đó kẻ tấn công có thể tạo dữ liệu đầu vào bỏ qua một hàm làm sạch, dẫn đến tấn công cross-site scripting (XSS).

Cú pháp

getHTML(options)

Tham số

options Optional

Một đối tượng tùy chọn với các tham số tùy chọn sau:

serializableShadowRoots: Giá trị boolean chỉ định có bao gồm các shadow root có thể tuần tự hóa hay không. Giá trị mặc định là false.
shadowRoots: Một mảng các đối tượng ShadowRoot cần được tuần tự hóa. Chúng được bao gồm bất kể chúng có được đánh dấu là serializable hay không, hoặc là open hay closed. Giá trị mặc định là một mảng rỗng.