عرض مصدر JavaScript/Document/createCDATASection

<noinclude>{{DISPLAYTITLE:<code>Document.createCDATASection()‎</code>}}</noinclude>
يُنشئُ التّابع <code>Document.createCDATASection()‎</code> عقدةَ قسم CDATA جديدةً ويُعيدها.

==البنية العامة==
<syntaxhighlight lang="javascript">
CDATASectionNode = document.createCDATASection(data)
</syntaxhighlight>
*<code>CDATASectionNode</code>
: يُمثّل عقدةً من النّوع [[CDATASection]].

*<code>data</code>
: سلسلةٌ نصيّة تحتوي على البيانات المرغوب إضافتها إلى قسم CDATA.

==مثال==
<syntaxhighlight lang="javascript">


var docu = new DOMParser().parseFromString('<xml></xml>',  "application/xml")

var cdata = docu.createCDATASection('هنا عقدة البيانات');

docu.getElementsByTagName('xml')[0].appendChild(cdata);

alert(new XMLSerializer().serializeToString(docu));
// ستَعرضُ
// <xml><![CDATA[هنا عقدة البيانات]]></xml>
</syntaxhighlight>
==ملاحظات==
* يعمل هذا مع مستندات XML فقط، ولا يعمل مع مستندات HTML (لأنّ مُستندات HTML لا تدعم أقسامCDATA)؛ مُحاولة استعمال التّابع مع مُستندات HTML سترمي الاستثناء <code>NOT_SUPPORTED_ERR</code>.
* سترمي كذلك الاستثناء <code>NS_ERROR_DOM_INVALID_CHARACTER_ERR</code> في حالة مُرّرت سلسلة الإغلاق  ‎"‎]]>‎"‎ كجزءٍ من البيانات، لذا لا يُمكن استعمال بيانات مُزوَّدة من طرف المُستخدم بأمان دون تهريبها (unescaped) ودون رمي هذا الاستثناء (يُمكن  استخدام التّابع <code>[[Document/createTextNode|document.createTextNode‎()‎]]</code> مكان هذا التّابع).

==مصادر ومواصفات==
* مواصفة [http://www.w3.org/TR/REC-DOM-Level-1/level-one-core.html#method-createCDATASection createCDATASection]

 [[تصنيف:JavaScript]]
 [[تصنيف:Web API]]
 [[تصنيف:DOM]]
 [[تصنيف:Document]]