Home
JavaScript and XPages reference
This reference describes the JavaScript™ language elements, Application Programming Interfaces (APIs), and other artifacts that you need to create scripts, plus the XPages simple actions.
DOM (JavaScript)
Represents a document in XML Document Object Model format.
DOMCharacterData (JavaScript)
Provides methods for accessing character data.

JavaScript and XPages reference
This reference describes the JavaScript™ language elements, Application Programming Interfaces (APIs), and other artifacts that you need to create scripts, plus the XPages simple actions.
- JavaScript™ language elements (JavaScript™)
  The JavaScript™ language elements are based on the ECMAScript Language Specification Standard ECMA-262 (see http://www.ecma-international.org/publications/standards/Ecma-262.htm). The JavaScript described here applies to the server-side interpreter. Client-side scripts are interpreted by the browser.
- Simple actions (JavaScript)
  A simple action performs a pre-programmed activity that can be modified by arguments.
- Global objects and functions (JavaScript™)
  Global objects provide entry points to server-side scripts. Entering the name of a global object instantiates it.
- DOM (JavaScript)
  Represents a document in XML Document Object Model format.
  - DOMAttr (JavaScript)
    Represents an attribute of an element.
  - DOMCDATASection (JavaScript)
    Represents a CDATA section.
  - DOMCharacterData (JavaScript)
    Provides methods for accessing character data.
    - appendData (DOMCharacterData - JavaScript)
      Appends a string to the end of the data in a node.
    - deleteData (DOMCharacterData - JavaScript)
      Deletes a range of 16-bit units from the node.
    - getData (DOMCharacterData - JavaScript)
      Gets the character data of a node.
    - getLength (DOMCharacterData - JavaScript)
      Gets the number of 16-bit units that are available.
    - insertData (DOMCharacterData - JavaScript)
      Inserts a string at the specified 16-bit unit offset.
    - replaceData (DOMCharacterData - JavaScript)
      Replaces characters starting at the specified 16-bit unit offset with the specified string.
    - setData (DOMCharacterData - JavaScript)
      Sets the character data of a node.
    - substringData (DOMCharacterData - JavaScript)
      Extracts a range of data from the node.
  - DOMComment (JavaScript)
    Represents a comment.
  - DOMDocument (JavaScript)
    Represents the root of a document.
  - DOMDocumentFragment (JavaScript)
    Represents a lightweight (or minimal) document.
  - DOMDocumentType (JavaScript)
    Represents a definition of a document.
  - DOMElement (JavaScript)
    Represents an element in a document.
  - DOMEntity (JavaScript)
    Represents an entity, parsed or not, in a document.
  - DOMEntityReference (JavaScript)
    Represents a reference to an entity.
  - DOMException (JavaScript)
  - DOMImplementation (JavaScript)
    Provides methods for operations independent of an instance of the document object model.
  - DOMNamedNodeMap (JavaScript)
    Represent a collection of nodes.
  - DOMNode (JavaScript)
    Represents a node in the Document Object Model.
  - DOMNodeList (JavaScript)
    Represents an ordered collection of nodes.
  - DOMNotation (JavaScript)
    Represents a notation in the document definition.
  - DOMProcessingInstruction (JavaScript)
    Represents processor-specific information in the text of the document.
  - DOMText (JavaScript)
    Represents the content (character data) of an element or attribute.
  - DOMUtil (JavaScript)
    Represents utility methods.
  - NamespaceContext (JavaScript)
    Represents a namespace context.
  - NamespaceContextImpl (JavaScript)
    Manipulates a namespace context.
- Domino®
  This library provides access to the HCL Domino® back-end.
- Runtime (JavaScript)
  The Runtime library contains classes that provide useful methods for globalization.
- Standard (JavaScript)
  The Standard library contains classes for manipulating data of different types and performing common operations.
- XSP (JavaScript™)
  The XSP library contains classes that access the browser context.

DOMCharacterData (JavaScript)

Provides methods for accessing character data.

Defined in

DOM (JavaScript)

Methods

This class inherits the methods of DOMNode (JavaScript). The methods listed below are in addition.


Method	Description
`appendData(str:string) : void`	Appends a string to the end of the data in a node.
`deleteData(offset:int, count:int) : void`	Deletes a range of 16-bit units from the node.
`getData() : string`	Gets the character data of a node.
`getLength() : int`	Gets the number of 16-bit units that are available.
`insertData(offset:int, str:string) : void`	Inserts a string at the specified 16-bit unit offset.
`replaceData(offset:int, count:int, str:string) : void`	Replaces characters starting at the specified 16-bit unit offset with the specified string.
`setData(str:string) : void`	Sets the character data of a node.
`substringData(offset:int, count:int) : string`	Extracts a range of data from the node.

Usage

The CharacterData interface extends Node with a set of attributes and methods for accessing character data in the DOM. For clarity this set is defined here rather than on each object that uses these attributes and methods. No DOM objects correspond directly to CharacterData, though Text and others do inherit the interface from it. All offsets in this interface start from 0.

As explained in the DOMString interface, text strings in the DOM are represented in UTF-16, i.e. as a sequence of 16-bit units. In the following, the term 16-bit units is used whenever necessary to indicate that indexing on CharacterData is done in 16-bit units.