Метод Document: createProcessingInstruction()
Базовая поддержка Широко доступен
Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с июля 2015 года.
createProcessingInstruction() создаёт новый узел инструкции обработки и возвращает его.
Новый узел обычно вставляется в документ XML, чтобы выполнить с ним какие-либо действия, например, с помощью node.insertBefore.
Синтаксис
createProcessingInstruction(target, data)
Параметры
piNode-
Полученный узел
ProcessingInstruction. target-
Строка, содержащая первую часть инструкции обработки (например,
<?target … ?>) data-
Строка, содержащая любую информацию, которую должна нести инструкция обработки после целевого значения. Информация зависит от вас, но не может содержать
?>, так как это закрывает инструкцию обработки.
Возвращаемое значение
None (undefined).
Исключения
-
InvalidCharacterErrorDOMException -
Выбрасывается, если одно из следующих условий истинно:
- Значение
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/>
Спецификации
Совместимость с браузерами
| Рабочие столы | Мобильные устройства | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| 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