XMLSerializer: serializeToString() method

Cú pháp

serializeToString(rootNode)

Tham số

rootNode

Node dùng làm gốc của cây DOM hoặc cây con cần xây dựng biểu diễn XML.

Giá trị trả về

Một chuỗi chứa biểu diễn XML của cây DOM đã chỉ định.

Ngoại lệ

TypeError

Ném ra nếu rootNode đã chỉ định không phải là kiểu nút tương thích. Nút gốc phải là Node hoặc Attr.

InvalidStateError DOMException

Ném ra nếu cây không thể được tuần tự hóa thành công, thường do vấn đề về khả năng tương thích của nội dung với tuần tự hóa XML.

SyntaxError DOMException

Ném ra nếu yêu cầu tuần tự hóa HTML nhưng không thể thành công do nội dung không đúng định dạng.

Ghi chú sử dụng

Kiểu nút tương thích

Nút gốc đã chỉ định — và tất cả các hậu duệ của nó — phải tương thích với thuật toán tuần tự hóa XML. Bản thân nút gốc phải là đối tượng Node hoặc Attr.

Các kiểu sau cũng được phép là hậu duệ của nút gốc, ngoài Node và Attr:

• DocumentType
• Document
• DocumentFragment
• Element
• Comment
• Text
• ProcessingInstruction
• Attr

Nếu gặp bất kỳ kiểu nào khác, ngoại lệ TypeError sẽ được ném ra.

Ghi chú về XML kết quả

Có một số điểm đáng lưu ý về XML do serializeToString() xuất ra:

• Đối với tuần tự hóa XML, các nút Element và Attr luôn được tuần tự hóa với namespaceURI của chúng. Điều này có thể nghĩa là prefix hoặc namespace mặc định được chỉ định trước đó có thể bị loại bỏ hoặc thay đổi.
• XML kết quả tương thích với trình phân tích cú pháp HTML.
• Các phần tử trong namespace HTML không có nút con (do đó đại diện cho thẻ rỗng) được tuần tự hóa với cả thẻ mở và thẻ đóng ("<someelement></someelement>") thay vì dùng thẻ rỗng ("<someelement/>").

Đặc tả kỹ thuật

Tương thích trình duyệt

Xem thêm

• Phân tích cú pháp và tuần tự hóa XML
• Tuần tự hóa sang HTML: Element.innerHTML và Element.outerHTML
• Phân tích cú pháp HTML hoặc XML để tạo cây DOM: DOMParser