Spec-Zone.ru › Web APIs

Метод Document: createProcessingInstruction()

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

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

  • Подробнее
  • Полная совместимость
  • Отправить отзыв

createProcessingInstruction() создаёт новый узел инструкции обработки и возвращает его.

Новый узел обычно вставляется в документ XML, чтобы выполнить с ним какие-либо действия, например, с помощью node.insertBefore.

Синтаксис

createProcessingInstruction(target, data)

Параметры

piNode

Полученный узел ProcessingInstruction.

target

Строка, содержащая первую часть инструкции обработки (например, <?target … ?>)

data

Строка, содержащая любую информацию, которую должна нести инструкция обработки после целевого значения. Информация зависит от вас, но не может содержать ?>, так как это закрывает инструкцию обработки.

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

None (undefined).

Исключения

InvalidCharacterError DOMException

Выбрасывается, если одно из следующих условий истинно:

  • Значение target не является допустимым именем XML; например, оно начинается с цифры, тире или точки или содержит символы, отличные от букв, цифр, нижних подчеркиваний, тире или точек.
  • Последовательность закрытия инструкции обработки (?>) является частью значения data.

Примеры

const doc = new DOMParser().parseFromString("<foo />", "application/xml");
const pi = doc.createProcessingInstruction(
  "xml-stylesheet",
  'href="mycss.css"',
);

doc.insertBefore(pi, doc.firstChild);

console.log(new XMLSerializer().serializeToString(doc));
// Displays: <?xml-stylesheet href="mycss.css" type="text/css"?><foo/>

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

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

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

Рабочие столы Мобильные устройства
Chrome Edge Firefox Opera Safari Chrome Android Firefox для Android Opera Android Safari на iOS Samsung Internet WebView Android
createProcessingInstruction 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/createProcessingInstruction

Spec-Zone.ru

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