If an object or map contains a key that, when converted to a string,
is equal to the value of aliasString
, then the name of the XML element
containing the object will be replaced with the value associated with
said key.
For example, if aliasString
is "="
, then the following object:
{
"abc": {
"=": "def"
"#": "ghi"
}
}
will result in the following XML for a root element named "root"
:
<root>
<def>ghi</def>
</root>
The default alias string is "="
.
If an object or map contains a key that, when converted to a string,
begins with the value of attributeString
, then the value mapped by
said key will be interpreted as attributes for the XML element for that
object.
The keys of the value of attributeString
are interpreted as attribute
names, while the values mapping to those keys are interpreted as
attribute values.
For example, if attributeString
is "@"
, then the following object:
{
"abc": {
"@1": {
"ghi": "jkl",
"mno": "pqr"
},
"stu": "vwx",
"@2": {
"yza": "bcd"
},
}
}
will result in the following XML for a root element named "root"
:
<root>
<abc ghi='jkl' mno='pqr' yza='bcd'>
<stu>vwx</stu>
</abc>
</root>
The default attribute string is "@"
.
Whether to enclose any text containing the characters <
or &
in CDATA sections. If this is false, these characters shall be replaced
with XML escape characters instead.
By default, this is disabled.
If an object or map contains a key that, when converted to a string, is
equal to an item in cdataKeys
, then the value mapped by said key will
be enclosed in a CDATA section.
For example, if cdataKeys
is:
[
"abc"
]
then the following object:
{
"abc": "def&",
"ghi": "jkl",
"mno": "pqr<"
}
will result in the following XML for a root element named "root"
:
<root>
<abc><![CDATA[def&]]></ghi>
<ghi>jlk</ghi>
<mno>pqr<</mno>
</root>
If cdataKeys
has a key named "*"
, then that entry will match all
keys.
By default, this is an empty array.
The options associated with the XML declaration.
The options associated with the XML document type definition.
The options associated with the formatting of the XML document.
Whether to replace any characters that are not valid in XML in particular contexts with the Unicode replacement character, U+FFFD.
At present this is limited to attribute names and values; element names and character data; CDATA sections; and comments. This may be extended in future.
By default, this is disabled.
If a value has a type (as defined by calling Object.prototype.toString
on the value) equal to a key in typeHandlers
, then said value will be
replaced by the return value of the function mapped to by the key in
typeHandlers
. This function is called with the value as a parameter.
If one of these functions returns the sole instance of Absent, then the value will be suppressed from the XML output altogether.
For example, if typeHandlers
is:
{
"[object Date]": function(value) {
return value.getYear();
},
"[object Null]": function(value) {
return Absent.instance;
}
}
then the following object:
{
"abc": new Date(2012, 10, 31),
"def": null
}
will result in the following XML for a root element named "root"
:
<root>
<abc>2012</abc>
</root>
If typeHandlers
has a key named "*"
, then that entry will match all
values, unless there is a more specific entry.
Note that normal parsing still occurs for the value returned by the function; it is not directly converted to a string.
The default value is an empty object.
Whether to use a self-closing tag for empty elements.
For example, the following element will be used:
<element/>
instead of:
<element></element>
By default, this is enabled.
Whether to throw an exception if basic XML validation fails while building the document.
By default, this is enabled.
If an object or map contains a key that, when converted to a string,
begins with the value of valueString
, then the value mapped by said key
will be represented as bare text within the XML element for that object.
For example, if valueString
is "#"
, then the following object:
new Map([
["#1", "abc"],
["def", "ghi"],
["#2", "jkl"]
])
will result in the following XML for a root element named "root"
:
<root>
abc
<def>ghi</def>
jkl
</root>
The default value is "#"
.
If an object or map contains a key that, when converted to a string, is
equal to a key in wrapHandlers
, and the key in said object or map maps
to an array or set, then all items in the array or set will be wrapped
in an XML element with the same name as the key.
The key in wrapHandlers
must map to a function that is called with the
key name, as well as the array or set, as parameters. This function must
return a string or value that can be converted to a string, which will
become the name for each XML element for each item in the array or set.
Alternatively, this function may return null
to indicate that no
wrapping should occur.
For example, if wrapHandlers
is:
{
"abc": function(key, value) {
return "def";
}
}
then the following object:
{
"ghi": "jkl",
"mno": {
"pqr": ["s", "t"]
},
"uvw": {
"abc": ["x", "y"]
}
}
will result in the following XML for a root element named "root"
:
<root>
<ghi>jkl</ghi>
<mno>
<pqr>s</pqr>
<pqr>t</pqr>
</mno>
<uwv>
<abc>
<def>x</def>
<def>y</def>
</abc>
</uwv>
</root>
If wrapHandlers
has a key named "*"
, then that entry will
match all arrays and sets, unless there is a more specific entry.
The default value is an empty object.
Generated using TypeDoc
The options associated with parsing an object and formatting the resulting XML.