Class Cdata

A representation of an XML CDATASection node.

// Create and log an XML document that shows how special characters like '<', '>', and '&' are
// stored in a CDATASection node as compared to in a Text node.
var illegalCharacters = '<em>The Amazing Adventures of Kavalier & Clay</em>';
var cdata = XmlService.createCdata(illegalCharacters);
var text = XmlService.createText(illegalCharacters);
var root = XmlService.createElement('root').addContent(cdata).addContent(text);
var document = XmlService.createDocument(root);
var xml = XmlService.getPrettyFormat().format(document);
Logger.log(xml);

Methods

Method	Return type	Brief description
`append(text)`	`Text`	Appends the given text to any content that already exists in the node.
`detach()`	`Content`	Detaches the node from its parent `Element` node.
`getParentElement()`	`Element`	Gets the node's parent `Element` node.
`getText()`	`String`	Gets the text value of the `Text` node.
`getValue()`	`String`	Gets the text value of all nodes that are direct or indirect children of the node, in the order they appear in the document.
`setText(text)`	`Text`	Sets the text value of the `Text` node.

Detailed documentation

`append(text)`

Appends the given text to any content that already exists in the node.

Parameters

Name	Type	Description
`text`	`String`	the text to append to the node

Return

Text — the Text node, for chaining

`detach()`

Detaches the node from its parent Element node. If the node does not have a parent, this method has no effect.

Return

Content — the detached node

`getParentElement()`

Gets the node's parent Element node. If the node does not have a parent, this method returns null.

Return

Element — the parent Element node

`getText()`

Gets the text value of the Text node.

Return

String — the text value of the Text node

`getValue()`

Gets the text value of all nodes that are direct or indirect children of the node, in the order they appear in the document.

Return

String — the text value of all nodes that are direct or indirect children of the node

`setText(text)`

Sets the text value of the Text node.

Parameters

Name	Type	Description
`text`	`String`	the text value to set

Return

Text — the Text node, for chaining