Spec-Zone.ru › Web APIs

Документ: метод createCDATASection()

Базовая Широко доступная

Эта функция хорошо отработана и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с июля 2015 года.

  • Узнать больше
  • Показать полную совместимость
  • Отправить отзыв

createCDATASection() создаёт новый узел CDATA-раздела и возвращает его.

Синтаксис

createCDATASection(data)

Параметры

data

Строка, содержащая данные, которые нужно добавить в CDATA-раздел.

Возвращаемое значение

Узел CDATA Section.

Примеры

const doc = new DOMParser().parseFromString("<xml></xml>", "application/xml");
const cdata = doc.createCDATASection("Some <CDATA> data & then some");
doc.querySelector("xml").appendChild(cdata);
console.log(new XMLSerializer().serializeToString(doc));
// Displays: <xml><![CDATA[Some <CDATA> data & then some]]></xml>

Примечания

  • Это будет работать только с XML, а не с HTML-документами (так как HTML-документы не поддерживают CDATA-разделы); попытка использовать это с HTML-документом вызовет NOT_SUPPORTED_ERR.
  • Вызовет исключение NS_ERROR_DOM_INVALID_CHARACTER_ERR при попытке отправить закрывающую последовательность CDATA (]]>) в качестве части данных, поэтому необработанные данные, предоставленные пользователем, нельзя безопасно использовать без риска получения этого исключения (createTextNode() часто может использоваться вместо него).

Спецификации

Спецификация
DOM
# ref-for-dom-document-createcomment①

Совместимость с браузерами

Рабочие столы Мобильные устройства
Chrome Edge Firefox Opera Safari Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet WebView Android
createCDATASection 1 12 1 ≤12.1 1 18 4 ≤12.1 1 1.0 4.4

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Document/createCDATASection

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API