CKEDITOR.dom.range

class

Represents a delimited piece of content in a DOM Document. It is contiguous in the sense that it can be characterized as selecting all of the content between a pair of boundary-points.

This class shares much of the W3C Document Object Model Range ideas and features, adding several range manipulation tools to it, but it's not intended to be compatible with it.

// Create a range for the entire contents of the editor document body.
var range = new CKEDITOR.dom.range( editor.document );
range.selectNodeContents( editor.document.getBody() );
// Delete the contents.
range.deleteContents();

Usually you will want to work on a ranges rooted in the editor's editable element. Such ranges can be created with a shorthand method – editor.createRange.

var range = editor.createRange();
range.root.equals( editor.editable() ); // -> true

Note that the root of a range is an important property, which limits many algorithms implemented in range's methods. Therefore it is crucial, especially when using ranges inside inline editors, to specify correct root, so using the CKEDITOR.editor.createRange method is highly recommended.

Selection

Range is only a logical representation of a piece of content in a DOM. It should not be confused with a selection which represents "physically marked" content. It is possible to create unlimited number of various ranges, when only one real selection may exist at a time in a document. Ranges are used to read position of selection in the DOM and to move selection to new positions.

The editor selection may be retrieved using the CKEDITOR.editor.getSelection method:

var sel = editor.getSelection(),
    ranges = sel.getRanges(); // CKEDITOR.dom.rangeList instance.

var range = ranges[ 0 ];
range.root; // -> editor's editable element.

A range can also be selected:

var range = editor.createRange();
range.selectNodeContents( editor.editable() );
sel.selectRanges( [ range ] );

Filtering

Public
Inherited
Mixed
Protected
Private
Deprecated

Properties

collapsed : Boolean

readonly
Indicates that this is a collapsed range. A collapsed range has its start and end boundaries at the very same point so nothing is contained in it.

See source
```
var range = new CKEDITOR.dom.range( editor.document );
range.selectNodeContents( editor.document.getBody() );
alert( range.collapsed ); // false
range.collapse();
alert( range.collapsed ); // true
```
Defaults to true
document : document

readonly
The document within which the range can be used.

See source
```
// Selects the body contents of the range document.
range.selectNodeContents( range.document.getBody() );
```

`endContainer : element | text`

readonly

Node within which the range ends.

See source

var range = new CKEDITOR.dom.range( editor.document );
range.selectNodeContents( editor.document.getBody() );
alert( range.endContainer.getName() ); // 'body'

`endOffset : Number`

readonly

Offset within the ending node of the range.

See source

var range = new CKEDITOR.dom.range( editor.document );
range.selectNodeContents( editor.document.getBody() );
alert( range.endOffset ); // == editor.document.getBody().getChildCount()

root : element

readonly

The ancestor DOM element within which the range manipulation are limited.

See source

`startContainer : element | text`

readonly

Node within which the range begins.

See source

var range = new CKEDITOR.dom.range( editor.document );
range.selectNodeContents( editor.document.getBody() );
alert( range.startContainer.getName() ); // 'body'

`startOffset : Number`

readonly

Offset within the starting node of the range.

See source

var range = new CKEDITOR.dom.range( editor.document );
range.selectNodeContents( editor.document.getBody() );
alert( range.startOffset ); // 0

Methods

constructor( root ) → range

Creates a CKEDITOR.dom.range instance that can be used inside a specific DOM Document.

See source

Parameters

root : document | element

The document or element within which the range will be scoped. global "TODO" - precise algorithms descriptions needed for the most complex methods like enlarge.

Returns

range
checkBoundaryOfElement( element, checkType ) → Boolean

Check whether a range boundary is at the inner boundary of a given element.

See source

Parameters

element : element

The target element to check.

checkType : Number

The boundary to check for both the range and the element. It can be CKEDITOR.START or CKEDITOR.END.

Returns

Boolean

true if the range boundary is at the inner boundary of the element.
checkEndOfBlock() → Boolean

Note: Calls to this function may produce changes to the DOM. The range may be updated to reflect such changes.

See source

Returns

Boolean
checkReadOnly() → Boolean

Check if elements at which the range boundaries anchor are read-only, with respect to contenteditable attribute.

See source

Returns

Boolean
checkStartOfBlock() → Boolean

Note: Calls to this function may produce changes to the DOM. The range may be updated to reflect such changes.

See source

Returns

Boolean
clone() → range

Clones this range.

See source

Returns

range
cloneContents( [ cloneId ] ) → documentFragment

Clones content nodes of the range and adds them to a document fragment, which is returned.

See source

Parameters

[ cloneId ] : Boolean

Whether to preserve ID attributes in the clone.

Defaults to true

Returns

documentFragment

Document fragment containing a clone of range's content.
collapse( toStart )

Makes the range collapsed by moving its start point (or end point if toStart==true) to the second end.

See source

Parameters

toStart : Boolean

Collapse range "to start".
createBookmark( [ serializable ] ) → Object

Creates a bookmark object, which can be later used to restore the range by using the moveToBookmark function.

See source

This is an "intrusive" way to create a bookmark. It includes  tags in the range boundaries. The advantage of it is that it is possible to handle DOM mutations when moving back to the bookmark.

Note: The inclusion of nodes in the DOM is a design choice and should not be changed as there are other points in the code that may be using those nodes to perform operations.

Parameters

[ serializable ] : Boolean

Indicates that the bookmark nodes must contain IDs, which can be used to restore the range even when these nodes suffer mutations (like cloning or innerHTML change).

Returns

Object

And object representing a bookmark.

Properties

startNode : node | String

Node or element ID.

endNode : node | String

Node or element ID.

serializable : Boolean

collapsed : Boolean
createBookmark2( [ normalized ] ) → Object

Creates a "non intrusive" and "mutation sensible" bookmark. This kind of bookmark should be used only when the DOM is supposed to remain stable after its creation.

See source

Parameters

[ normalized ] : Boolean

Indicates that the bookmark must be normalized. When normalized, the successive text nodes are considered a single node. To successfully load a normalized bookmark, the DOM tree must also be normalized before calling moveToBookmark.

Returns

Object

An object representing the bookmark.

Properties

start : Array

Start container's address (see CKEDITOR.dom.node.getAddress).

end : Array

Start container's address.

startOffset : Number

endOffset : Number

collapsed : Boolean

normalized : Boolean

is2 : Boolean

This is "bookmark2".
createIterator() → iterator

Creates a CKEDITOR.dom.iterator instance for this range.

See source

Returns

iterator
deleteContents( [ mergeThen ] )

Deletes the content nodes of the range permanently from the DOM tree.

See source

Parameters

[ mergeThen ] : Boolean

Merge any split elements result in DOM true due to partial selection.
endPath() → elementPath

Gets CKEDITOR.dom.elementPath for the endContainer.

See source

Returns

elementPath
enlarge( unit, [ excludeBrs ] )

Expands the range so that partial units are completely contained.

See source

Parameters

unit : Number

The unit type to expand with. Use one of following values: CKEDITOR.ENLARGE_BLOCK_CONTENTS, CKEDITOR.ENLARGE_ELEMENT, CKEDITOR.ENLARGE_INLINE, CKEDITOR.ENLARGE_LIST_ITEM_CONTENTS.

[ excludeBrs ] : Boolean

Whether include line-breaks when expanding.

Defaults to false
equals( range ) → Boolean

since 4.13.0

Whether this range is the same as another passed range.

See source

Parameters

range : range

A range to be compared with this range.

Returns

Boolean

Whether ranges are identical.
extractContents( [ mergeThen ], [ cloneId ] ) → documentFragment

The content nodes of the range are cloned and added to a document fragment, meanwhile they are removed permanently from the DOM tree.

See source

Note: Setting the cloneId parameter to false works for partially selected elements only. If an element with an ID attribute is fully enclosed in a range, it will keep the ID attribute regardless of the cloneId parameter value, because it is not cloned — it is moved to the returned document fragment.

Parameters

[ mergeThen ] : Boolean

Merge any split elements result in DOM true due to partial selection.

[ cloneId ] : Boolean

Whether to preserve ID attributes in the extracted content.

Defaults to true

Returns

documentFragment

Document fragment containing extracted content.
fixBlock( isStart, blockTag ) → element
Wraps inline content found around the range's start or end boundary with a block element.

See source
```
// Assuming the following range:
// <h1>foo</h1>ba^r bomfoo
// The result of executing:
range.fixBlock( true, 'p' );
// will be:
// <h1>foo</h1>ba^r bomfoo
```
Non-collapsed range:
```
// Assuming the following range:
// ba[rfoobo]m
// The result of executing:
range.fixBlock( false, 'p' );
// will be:
// ba[rfoobo]m
```
Parameters

isStart : Boolean

Whether the start or end boundary of a range should be checked.

blockTag : String

The name of a block element in which content will be wrapped. For example: 'p'.

Returns

element

Created block wrapper.
getBoundaryNodes() → Object

Returns two nodes which are on the boundaries of this range.

See source

Returns

Object

Properties

startNode : node

endNode : node

precise desc/algorithm
getClientRects( [ isAbsolute ] ) → rect[]

since 4.10.0
Returns an array of CKEDITOR.dom.rect elements that are represented as rectangles which are covered by ranges. Rectangles represent the area of the screen occupied by the elements contained within the range.

See source
In the following example:
```
 first {span second span
 very long }span
```
Brackets represent the beginning and the end of the selection.

Returned rectangles would be represented by areas like below:
```
first [span][ second span]
[very long ]span
```
where each pair of brackets represents one rectangle.

Note: Various browsers might return a different list of rectangles.

Internet Explorer 8 does not have the native range.getClientRects() method, which is a base for this method, implemented. As a workaround it will return an array containing only one rectangle which would start in the top left-hand corner of the selection and end in the bottom right-hand corner. Possible cases when the returned rectangle does not fully cover ranges are presented below:

Parameters

[ isAbsolute ] : Boolean

The function will retrieve an absolute rectangle of the element, i.e. a position relative to the upper-left corner of the topmost viewport.

Returns

rect[]
getCommonAncestor( [ includeSelf ], [ ignoreTextNode ] ) → element

Find the node which fully contains the range.

See source

Parameters

[ includeSelf ] : Boolean

Defaults to false

[ ignoreTextNode ] : Boolean

Whether ignore CKEDITOR.NODE_TEXT type.

Defaults to false

Returns

element
getEnclosedNode() → node

Get the single node enclosed within the range if there's one.

See source

Returns

node
getNextEditableNode() → element | text

since 4.3.0

Gets next node which can be a container of a selection. This methods mimics a behavior of right/left arrow keys in case of collapsed selection. It does not return an exact position (with offset) though, but just a selection's container.

See source

Note: use this method on a collapsed range.

Returns

element | text
getNextNode( evaluator, [ guard ], [ boundary ] ) → element | null

Traverse with CKEDITOR.dom.walker to retrieve the next element before the range start.

See source

Parameters

evaluator : Function

Function used as the walker's evaluator.

[ guard ] : Function

Function used as the walker's guard.

[ boundary ] : element

A range ancestor element in which the traversal is limited, default to the root editable if not defined.

Returns

element | null

The returned node from the traversal.
getPreviousEditableNode() → element | text

since 4.3.0

See getNextEditableNode.

See source

Returns

element | text
getPreviousNode( evaluator, [ guard ], [ boundary ] ) → element | null

Traverse with CKEDITOR.dom.walker to retrieve the previous element before the range start.

See source

Parameters

evaluator : Function

Function used as the walker's evaluator.

[ guard ] : Function

Function used as the walker's guard.

[ boundary ] : element

A range ancestor element in which the traversal is limited, default to the root editable if not defined.

Returns

element | null

The returned node from the traversal.
getTouchedEndNode() → node

Get the node adjacent to the range end or endContainer.

See source

Returns

node
getTouchedStartNode() → node

Get the node adjacent to the range start or startContainer.

See source

Returns

node
insertNode( node )

Inserts a node at the start of the range. The range will be expanded to contain the node.

See source

Parameters

node : node
moveToBookmark( bookmark )

Moves this range to the given bookmark. See createBookmark and createBookmark2.

See source

If serializable bookmark passed, then its  markers will be removed.

Parameters

bookmark : Object
moveToClosestEditablePosition( [ element ], [ isMoveForward ] ) → Boolean

since 4.3.0

Moves the range boundaries to the closest editing point after/before an element or the current range position (depends on whether the element was specified).

See source

For example, if the start element has id="start", foostart</start>, the closest previous editing point is foo^start</start> (between  and ).

See also: moveToElementEditablePosition.

Parameters

[ element ] : element

The starting element. If not specified, the current range position will be used.

[ isMoveForward ] : Boolean

Whether move to the end of editable. Otherwise, look back.

Returns

Boolean

Whether the range was moved.
moveToElementEditEnd( target ) → Boolean

See moveToElementEditablePosition.

See source

Parameters

target : Object

Returns

Boolean

Whether range was moved.
moveToElementEditStart( target ) → Boolean

See moveToElementEditablePosition.

See source

Parameters

target : Object

Returns

Boolean

Whether range was moved.
moveToElementEditablePosition( el, isMoveToEnd ) → Boolean

Moves the range boundaries to the first/end editing point inside an element.

See source

For example, in an element tree like  Text, the start editing point is ^ Text (inside ).

Parameters

el : element

The element into which look for the editing spot.

isMoveToEnd : Boolean

Whether move to the end editable position.

Returns

Boolean

Whether range was moved.
moveToPosition( node, position )
Moves the range to a given position according to the specified node.

See source
```
// HTML: Foo bar
range.moveToPosition( elB, CKEDITOR.POSITION_BEFORE_START );
// Range will be moved to: Foo ^bar
```
See also setStartAt and setEndAt.

Parameters

node : node

The node according to which the position will be set.

position : Number

One of CKEDITOR.POSITION_BEFORE_START, CKEDITOR.POSITION_AFTER_START, CKEDITOR.POSITION_BEFORE_END, CKEDITOR.POSITION_AFTER_END.
moveToRange( range )

Moves the range to the exact position of the specified range.

See source

Parameters

range : range
optimize()

Transforms the startContainer and endContainer properties from text nodes to element nodes, whenever possible. This is actually possible if either of the boundary containers point to a text node, and its offset is set to zero, or after the last char in the node.

See source
optimizeBookmark()

Move the range out of bookmark nodes if they'd been the container.

See source
removeEmptyBlocksAtEnd( atEnd )

Recursively remove any empty path blocks at the range boundary.

See source

Parameters

atEnd : Boolean

Removal to perform at the end boundary, otherwise to perform at the start.
scrollIntoView()

Scrolls the start of current range into view.

See source
select() → selection

Select this range as the only one with CKEDITOR.dom.selection.selectRanges.

See source

Returns

selection
selectNodeContents( node )

Select nodes content. Range will start and end inside this node.

See source

Parameters

node : node
setEnd( endNode, endOffset )

Sets the end position of a Range.

See source

Parameters

endNode : node

The node to end the range.

endOffset : Number

An integer greater than or equal to zero representing the offset for the end of the range from the start of endNode.
setEndAfter( node )
Sets end of this range after the specified node.

See source
```
// Range: foo^bar
range.setEndAfter( elB );
// The range will be changed to:
// foo[bar]
```
Parameters

node : node
setEndAt( node, position )
Moves the end of this range to given position according to specified node.

See source
```
// HTML: ^Foo bar
range.setEndAt( textBar, CKEDITOR.POSITION_BEFORE_START );
// The range will be changed to:
// [Foo ]bar
```
See also setStartAt and moveToPosition.

Parameters

node : node

The node according to which position will be set.

position : Number

One of CKEDITOR.POSITION_BEFORE_START, CKEDITOR.POSITION_AFTER_START, CKEDITOR.POSITION_BEFORE_END, CKEDITOR.POSITION_AFTER_END.
setEndBefore( node )
Sets end of this range before the specified node.

See source
```
// Range: ^foobar
range.setStartAfter( textBar );
// The range will be changed to:
// [foo]bar
```
Parameters

node : node
setStart( startNode, startOffset )

Sets the start position of a range.

See source

Parameters

startNode : node

The node to start the range.

startOffset : Number

An integer greater than or equal to zero representing the offset for the start of the range from the start of startNode.
setStartAfter( node )
Sets start of this range after the specified node.

See source
```
// Range: foobar^
range.setStartAfter( textFoo );
// The range will be changed to:
// foo[bar]
```
Parameters

node : node
setStartAt( node, position )
Moves the start of this range to given position according to specified node.

See source
```
// HTML: Foo bar^
range.setStartAt( elB, CKEDITOR.POSITION_AFTER_START );
// The range will be changed to:
// Foo [bar]
```
See also setEndAt and moveToPosition.

Parameters

node : node

The node according to which position will be set.

position : Number

One of CKEDITOR.POSITION_BEFORE_START, CKEDITOR.POSITION_AFTER_START, CKEDITOR.POSITION_BEFORE_END, CKEDITOR.POSITION_AFTER_END.
setStartBefore( node )
Sets start of this range after the specified node.

See source
```
// Range: foobar^
range.setStartBefore( elB );
// The range will be changed to:
// foo[bar]
```
Parameters

node : node
shrink( mode, [ selectContents ], [ options ] )
Decreases the range to make sure that boundaries always anchor beside text nodes or the innermost element.

See source
Parameters
mode : Number
The shrinking mode (CKEDITOR.SHRINK_ELEMENT or CKEDITOR.SHRINK_TEXT).

CKEDITOR.SHRINK_ELEMENT – Shrinks the range boundaries to the edge of the innermost element.

CKEDITOR.SHRINK_TEXT – Shrinks the range boundaries to anchor by the side of enclosed text node. The range remains if there are no text nodes available on boundaries.
[ selectContents ] : Boolean

Whether the resulting range anchors at the inner OR outer boundary of the node.

Defaults to false

[ options ] : Boolean | Object

If this parameter is of a Boolean type, it is treated as options.shrinkOnBlockBoundary. This parameter was added in 4.7.0.

Properties

[ shrinkOnBlockBoundary ] : Boolean

Whether the block boundary should be included in the shrunk range.

Defaults to true

[ skipBogus ] : Boolean

Whether bogus   elements should be ignored while mode is set to CKEDITOR.SHRINK_TEXT. This option was added in 4.7.0.

Defaults to false

Defaults to true
splitBlock( [ cloneId ] )

See source

Parameters

[ cloneId ] : Boolean

Whether to preserve ID attributes in the result blocks.

Defaults to false
splitElement( element, [ cloneId ] ) → element

Branch the specified element from the collapsed range position and place the caret between the two result branches.

See source

Note: The range must be collapsed and been enclosed by this element.

Parameters

element : element

[ cloneId ] : Boolean

Whether to preserve ID attributes in the result elements.

Defaults to false

Returns

element

Root element of the new branch after the split.
startPath() → elementPath

Gets CKEDITOR.dom.elementPath for the startContainer.

See source

Returns

elementPath
trim( [ ignoreStart ], [ ignoreEnd ] )

See source

Parameters

[ ignoreStart ] : Boolean

Defaults to false

[ ignoreEnd ] : Boolean

precise desc/algorithm

Defaults to false
_find( query, [ includeNonEditables ] ) → element[]

since 4.5.11 private

Looks for elements matching the query selector within a range.

See source

Parameters

query : String

A valid CSS selector.

[ includeNonEditables ] : Boolean

Whether elements with contenteditable set to false should be included.

Defaults to false

Returns

element[]
_getTableElement( [ tableElements ] ) → element | null

since 4.7.0 private

Returns any table element, like td, tbody, table etc. from a given range. The element is returned only if the range is contained within one table (might be a nested table, but it cannot be two different tables on the same DOM level).

See source

Parameters

[ tableElements ] : Object

Mapping of element names that should be considered.

Returns

element | null
_setEndContainer( endContainer )

since 4.4.6 private

Setter for the endContainer.

See source

Parameters

endContainer : element
_setStartContainer( startContainer )

since 4.4.6 private

Setter for the startContainer.

See source

Parameters

startContainer : element

Static methods

mergeRanges( ranges ) → range[]

since 4.7.0 static

Merges every subsequent range in given set, returning a smaller array of ranges.

See source

Note that each range in the returned value will be enlarged with CKEDITOR.ENLARGE_ELEMENT value.

Parameters

ranges : range[]

Returns

range[]

Set of merged ranges.

CKEDITOR.dom.range

Selection

Filtering

Properties

collapsed : BooleanCKEDITOR.dom.range#collapsed

document : documentCKEDITOR.dom.range#document

endContainer : element | textCKEDITOR.dom.range#endContainer

endOffset : NumberCKEDITOR.dom.range#endOffset

root : elementCKEDITOR.dom.range#root

startContainer : element | textCKEDITOR.dom.range#startContainer

startOffset : NumberCKEDITOR.dom.range#startOffset

Methods

constructor( root ) → rangeCKEDITOR.dom.range#constructor

Parameters

Returns

checkBoundaryOfElement( element, checkType ) → BooleanCKEDITOR.dom.range#checkBoundaryOfElement

Parameters

Returns

checkEndOfBlock() → BooleanCKEDITOR.dom.range#checkEndOfBlock

Returns

checkReadOnly() → BooleanCKEDITOR.dom.range#checkReadOnly

Returns

checkStartOfBlock() → BooleanCKEDITOR.dom.range#checkStartOfBlock

Returns

clone() → rangeCKEDITOR.dom.range#clone

Returns

cloneContents( [ cloneId ] ) → documentFragmentCKEDITOR.dom.range#cloneContents

Parameters

Returns

collapse( toStart )CKEDITOR.dom.range#collapse

Parameters

createBookmark( [ serializable ] ) → ObjectCKEDITOR.dom.range#createBookmark

Parameters

Returns

createBookmark2( [ normalized ] ) → ObjectCKEDITOR.dom.range#createBookmark2

Parameters

Returns

createIterator() → iteratorCKEDITOR.dom.range#createIterator

Returns

deleteContents( [ mergeThen ] )CKEDITOR.dom.range#deleteContents

Parameters

endPath() → elementPathCKEDITOR.dom.range#endPath

Returns

enlarge( unit, [ excludeBrs ] )CKEDITOR.dom.range#enlarge

Parameters

equals( range ) → BooleanCKEDITOR.dom.range#equals

Parameters

Returns

extractContents( [ mergeThen ], [ cloneId ] ) → documentFragmentCKEDITOR.dom.range#extractContents

Parameters

Returns

fixBlock( isStart, blockTag ) → elementCKEDITOR.dom.range#fixBlock

Parameters

Returns

getBoundaryNodes() → ObjectCKEDITOR.dom.range#getBoundaryNodes

Returns

getClientRects( [ isAbsolute ] ) → rect[]CKEDITOR.dom.range#getClientRects

Parameters

Returns

getCommonAncestor( [ includeSelf ], [ ignoreTextNode ] ) → elementCKEDITOR.dom.range#getCommonAncestor

Parameters

Returns

getEnclosedNode() → nodeCKEDITOR.dom.range#getEnclosedNode

Returns

getNextEditableNode() → element | textCKEDITOR.dom.range#getNextEditableNode

Returns

getNextNode( evaluator, [ guard ], [ boundary ] ) → element | nullCKEDITOR.dom.range#getNextNode

Parameters

Returns

getPreviousEditableNode() → element | textCKEDITOR.dom.range#getPreviousEditableNode

Returns

getPreviousNode( evaluator, [ guard ], [ boundary ] ) → element | nullCKEDITOR.dom.range#getPreviousNode

Parameters

Returns

getTouchedEndNode() → nodeCKEDITOR.dom.range#getTouchedEndNode

Returns

getTouchedStartNode() → nodeCKEDITOR.dom.range#getTouchedStartNode

Returns

insertNode( node )CKEDITOR.dom.range#insertNode

Parameters

`collapsed : Boolean`

`document : document`

`endContainer : element | text`

`endOffset : Number`

`root : element`

`startContainer : element | text`

`startOffset : Number`

`constructor( root ) → range`

`checkBoundaryOfElement( element, checkType ) → Boolean`

`checkEndOfBlock() → Boolean`

`checkReadOnly() → Boolean`

`checkStartOfBlock() → Boolean`

`clone() → range`

`cloneContents( [ cloneId ] ) → documentFragment`

`collapse( toStart )`

`createBookmark( [ serializable ] ) → Object`

`createBookmark2( [ normalized ] ) → Object`

`createIterator() → iterator`

`deleteContents( [ mergeThen ] )`

`endPath() → elementPath`

`enlarge( unit, [ excludeBrs ] )`

`equals( range ) → Boolean`

`extractContents( [ mergeThen ], [ cloneId ] ) → documentFragment`

`fixBlock( isStart, blockTag ) → element`

`getBoundaryNodes() → Object`

`getClientRects( [ isAbsolute ] ) → rect[]`

`getCommonAncestor( [ includeSelf ], [ ignoreTextNode ] ) → element`

`getEnclosedNode() → node`

`getNextEditableNode() → element | text`

`getNextNode( evaluator, [ guard ], [ boundary ] ) → element | null`

`getPreviousEditableNode() → element | text`

`getPreviousNode( evaluator, [ guard ], [ boundary ] ) → element | null`

`getTouchedEndNode() → node`

`getTouchedStartNode() → node`

`insertNode( node )`

`moveToBookmark( bookmark )`

`moveToClosestEditablePosition( [ element ], [ isMoveForward ] ) → Boolean`

`moveToElementEditEnd( target ) → Boolean`

`moveToElementEditStart( target ) → Boolean`

`moveToElementEditablePosition( el, isMoveToEnd ) → Boolean`

`moveToPosition( node, position )`

`moveToRange( range )`

`optimize()`

`optimizeBookmark()`

`removeEmptyBlocksAtEnd( atEnd )`

`scrollIntoView()`

`select() → selection`

`selectNodeContents( node )`

`setEnd( endNode, endOffset )`

`setEndAfter( node )`

`setEndAt( node, position )`

`setEndBefore( node )`

`setStart( startNode, startOffset )`

`setStartAfter( node )`

`setStartAt( node, position )`

`setStartBefore( node )`

`shrink( mode, [ selectContents ], [ options ] )`

`splitBlock( [ cloneId ] )`

`splitElement( element, [ cloneId ] ) → element`

`startPath() → elementPath`

`trim( [ ignoreStart ], [ ignoreEnd ] )`

`_find( query, [ includeNonEditables ] ) → element[]`

`_getTableElement( [ tableElements ] ) → element | null`

`_setEndContainer( endContainer )`

`_setStartContainer( startContainer )`

`mergeRanges( ranges ) → range[]`