happy-dom
Version:
Happy DOM is a JavaScript implementation of a web browser without its graphical user interface. It includes many web standards from WHATWG DOM and HTML.
470 lines • 17.3 kB
JavaScript
"use strict";
var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
if (k2 === undefined) k2 = k;
var desc = Object.getOwnPropertyDescriptor(m, k);
if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
desc = { enumerable: true, get: function() { return m[k]; } };
}
Object.defineProperty(o, k2, desc);
}) : (function(o, m, k, k2) {
if (k2 === undefined) k2 = k;
o[k2] = m[k];
}));
var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
Object.defineProperty(o, "default", { enumerable: true, value: v });
}) : function(o, v) {
o["default"] = v;
});
var __importStar = (this && this.__importStar) || (function () {
var ownKeys = function(o) {
ownKeys = Object.getOwnPropertyNames || function (o) {
var ar = [];
for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
return ar;
};
return ownKeys(o);
};
return function (mod) {
if (mod && mod.__esModule) return mod;
var result = {};
if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
__setModuleDefault(result, mod);
return result;
};
})();
var __importDefault = (this && this.__importDefault) || function (mod) {
return (mod && mod.__esModule) ? mod : { "default": mod };
};
Object.defineProperty(exports, "__esModule", { value: true });
const Event_js_1 = __importDefault(require("../event/Event.cjs"));
const PropertySymbol = __importStar(require("../PropertySymbol.cjs"));
const DOMExceptionNameEnum_js_1 = __importDefault(require("../exception/DOMExceptionNameEnum.cjs"));
const NodeTypeEnum_js_1 = __importDefault(require("../nodes/node/NodeTypeEnum.cjs"));
const NodeUtility_js_1 = __importDefault(require("../nodes/node/NodeUtility.cjs"));
const RangeUtility_js_1 = __importDefault(require("../range/RangeUtility.cjs"));
const SelectionDirectionEnum_js_1 = __importDefault(require("./SelectionDirectionEnum.cjs"));
/**
* Selection.
*
* Based on logic from:
* https://github.com/jsdom/jsdom/blob/master/lib/jsdom/living/selection/Selection-impl.js
*
* Reference:
* https://developer.mozilla.org/en-US/docs/Web/API/Selection.
*/
class Selection {
#ownerDocument = null;
#range = null;
#direction = SelectionDirectionEnum_js_1.default.directionless;
/**
* Constructor.
*
* @param ownerDocument Owner document.
*/
constructor(ownerDocument) {
this.#ownerDocument = ownerDocument;
}
/**
* Returns range count.
*
* @see https://w3c.github.io/selection-api/#dom-selection-rangecount
* @returns Range count.
*/
get rangeCount() {
return this.#range ? 1 : 0;
}
/**
* Returns collapsed state.
*
* @see https://w3c.github.io/selection-api/#dom-selection-iscollapsed
* @returns "true" if collapsed.
*/
get isCollapsed() {
return this.#range === null || this.#range.collapsed;
}
/**
* Returns type.
*
* @see https://w3c.github.io/selection-api/#dom-selection-type
* @returns Type.
*/
get type() {
if (!this.#range) {
return 'None';
}
else if (this.#range.collapsed) {
return 'Caret';
}
return 'Range';
}
/**
* Returns anchor node.
*
* @see https://w3c.github.io/selection-api/#dom-selection-anchornode
* @returns Node.
*/
get anchorNode() {
if (!this.#range) {
return null;
}
return this.#direction === SelectionDirectionEnum_js_1.default.forwards
? this.#range.startContainer
: this.#range.endContainer;
}
/**
* Returns anchor offset.
*
* @see https://w3c.github.io/selection-api/#dom-selection-anchoroffset
* @returns Node.
*/
get anchorOffset() {
if (!this.#range) {
return 0;
}
return this.#direction === SelectionDirectionEnum_js_1.default.forwards
? this.#range.startOffset
: this.#range.endOffset;
}
/**
* Returns anchor node.
*
* @deprecated
* @alias anchorNode
* @returns Node.
*/
get baseNode() {
return this.anchorNode;
}
/**
* Returns anchor offset.
*
* @deprecated
* @alias anchorOffset
* @returns Node.
*/
get baseOffset() {
return this.anchorOffset;
}
/**
* Returns focus node.
*
* @see https://w3c.github.io/selection-api/#dom-selection-focusnode
* @returns Node.
*/
get focusNode() {
return this.anchorNode;
}
/**
* Returns focus offset.
*
* @see https://w3c.github.io/selection-api/#dom-selection-focusoffset
* @returns Node.
*/
get focusOffset() {
return this.anchorOffset;
}
/**
* Returns focus node.
*
* @deprecated
* @alias focusNode
* @returns Node.
*/
get extentNode() {
return this.focusNode;
}
/**
* Returns focus offset.
*
* @deprecated
* @alias focusOffset
* @returns Node.
*/
get extentOffset() {
return this.focusOffset;
}
/**
* Adds a range.
*
* @see https://w3c.github.io/selection-api/#dom-selection-addrange
* @param newRange Range.
*/
addRange(newRange) {
if (!newRange) {
throw new this.#ownerDocument[PropertySymbol.window].TypeError('Failed to execute addRange on Selection. Parameter 1 is not of type Range.');
}
if (!this.#range && newRange[PropertySymbol.ownerDocument] === this.#ownerDocument) {
this.#associateRange(newRange);
}
}
/**
* Returns Range.
*
* @see https://w3c.github.io/selection-api/#dom-selection-getrangeat
* @param index Index.
* @returns Range.
*/
getRangeAt(index) {
if (!this.#range || index !== 0) {
throw new this.#ownerDocument[PropertySymbol.window].DOMException('Invalid range index.', DOMExceptionNameEnum_js_1.default.indexSizeError);
}
return this.#range;
}
/**
* Removes a range from a selection.
*
* @see https://w3c.github.io/selection-api/#dom-selection-removerange
* @param range Range.
*/
removeRange(range) {
if (this.#range !== range) {
throw new this.#ownerDocument[PropertySymbol.window].DOMException('Invalid range.', DOMExceptionNameEnum_js_1.default.notFoundError);
}
this.#associateRange(null);
}
/**
* Removes all ranges.
*/
removeAllRanges() {
this.#associateRange(null);
}
/**
* Removes all ranges.
*
* @alias removeAllRanges()
*/
empty() {
this.removeAllRanges();
}
/**
* Collapses the current selection to a single point.
*
* @see https://w3c.github.io/selection-api/#dom-selection-collapse
* @param node Node.
* @param offset Offset.
*/
collapse(node, offset) {
if (node === null) {
this.removeAllRanges();
return;
}
if (node[PropertySymbol.nodeType] === NodeTypeEnum_js_1.default.documentTypeNode) {
throw new this.#ownerDocument[PropertySymbol.window].DOMException("DocumentType Node can't be used as boundary point.", DOMExceptionNameEnum_js_1.default.invalidNodeTypeError);
}
if (offset > NodeUtility_js_1.default.getNodeLength(node)) {
throw new this.#ownerDocument[PropertySymbol.window].DOMException('Invalid range index.', DOMExceptionNameEnum_js_1.default.indexSizeError);
}
if (node[PropertySymbol.ownerDocument] !== this.#ownerDocument) {
return;
}
const newRange = new this.#ownerDocument[PropertySymbol.window].Range();
newRange[PropertySymbol.start].node = node;
newRange[PropertySymbol.start].offset = offset;
newRange[PropertySymbol.end].node = node;
newRange[PropertySymbol.end].offset = offset;
this.#associateRange(newRange);
}
/**
* Collapses the current selection to a single point.
*
* @see https://w3c.github.io/selection-api/#dom-selection-setposition
* @alias collapse()
* @param node Node.
* @param offset Offset.
*/
setPosition(node, offset) {
this.collapse(node, offset);
}
/**
* Collapses the selection to the end.
*
* @see https://w3c.github.io/selection-api/#dom-selection-collapsetoend
*/
collapseToEnd() {
if (this.#range === null) {
throw new this.#ownerDocument[PropertySymbol.window].DOMException('There is no selection to collapse.', DOMExceptionNameEnum_js_1.default.invalidStateError);
}
const { node, offset } = this.#range[PropertySymbol.end];
const newRange = new this.#ownerDocument[PropertySymbol.window].Range();
newRange[PropertySymbol.start].node = node;
newRange[PropertySymbol.start].offset = offset;
newRange[PropertySymbol.end].node = node;
newRange[PropertySymbol.end].offset = offset;
this.#associateRange(newRange);
}
/**
* Collapses the selection to the start.
*
* @see https://w3c.github.io/selection-api/#dom-selection-collapsetostart
*/
collapseToStart() {
if (!this.#range) {
throw new this.#ownerDocument[PropertySymbol.window].DOMException('There is no selection to collapse.', DOMExceptionNameEnum_js_1.default.invalidStateError);
}
const { node, offset } = this.#range[PropertySymbol.start];
const newRange = new this.#ownerDocument[PropertySymbol.window].Range();
newRange[PropertySymbol.start].node = node;
newRange[PropertySymbol.start].offset = offset;
newRange[PropertySymbol.end].node = node;
newRange[PropertySymbol.end].offset = offset;
this.#associateRange(newRange);
}
/**
* Indicates whether a specified node is part of the selection.
*
* @see https://w3c.github.io/selection-api/#dom-selection-containsnode
* @param node Node.
* @param [allowPartialContainment] Set to "true" to allow partial containment.
* @returns Always returns "true" for now.
*/
containsNode(node, allowPartialContainment = false) {
if (!this.#range || node[PropertySymbol.ownerDocument] !== this.#ownerDocument) {
return false;
}
const startIsBeforeNode = RangeUtility_js_1.default.compareBoundaryPointsPosition(this.#range[PropertySymbol.start], {
node,
offset: 0
}) === -1;
const endIsAfterNode = RangeUtility_js_1.default.compareBoundaryPointsPosition(this.#range[PropertySymbol.end], {
node,
offset: NodeUtility_js_1.default.getNodeLength(node)
}) === 1;
return allowPartialContainment
? startIsBeforeNode || endIsAfterNode
: startIsBeforeNode && endIsAfterNode;
}
/**
* Deletes the selected text from the document's DOM.
*
* @see https://w3c.github.io/selection-api/#dom-selection-deletefromdocument
*/
deleteFromDocument() {
if (this.#range) {
this.#range.deleteContents();
}
}
/**
* Moves the focus of the selection to a specified point.
*
* @see https://w3c.github.io/selection-api/#dom-selection-extend
* @param node Node.
* @param offset Offset.
*/
extend(node, offset) {
if (node[PropertySymbol.ownerDocument] !== this.#ownerDocument) {
return;
}
if (!this.#range) {
throw new this.#ownerDocument[PropertySymbol.window].DOMException('There is no selection to extend.', DOMExceptionNameEnum_js_1.default.invalidStateError);
}
const anchorNode = this.anchorNode;
const anchorOffset = this.anchorOffset;
const newRange = new this.#ownerDocument[PropertySymbol.window].Range();
newRange[PropertySymbol.start].node = node;
newRange[PropertySymbol.start].offset = 0;
newRange[PropertySymbol.end].node = node;
newRange[PropertySymbol.end].offset = 0;
if (node[PropertySymbol.ownerDocument] !== this.#range[PropertySymbol.ownerDocument]) {
newRange[PropertySymbol.start].offset = offset;
newRange[PropertySymbol.end].offset = offset;
}
else if (RangeUtility_js_1.default.compareBoundaryPointsPosition({ node: anchorNode, offset: anchorOffset }, { node, offset }) <= 0) {
newRange[PropertySymbol.start].node = anchorNode;
newRange[PropertySymbol.start].offset = anchorOffset;
newRange[PropertySymbol.end].node = node;
newRange[PropertySymbol.end].offset = offset;
}
else {
newRange[PropertySymbol.start].node = node;
newRange[PropertySymbol.start].offset = offset;
newRange[PropertySymbol.end].node = anchorNode;
newRange[PropertySymbol.end].offset = anchorOffset;
}
this.#associateRange(newRange);
this.#direction =
RangeUtility_js_1.default.compareBoundaryPointsPosition({ node, offset }, { node: anchorNode, offset: anchorOffset }) === -1
? SelectionDirectionEnum_js_1.default.backwards
: SelectionDirectionEnum_js_1.default.forwards;
}
/**
* Selects all children.
*
* @see https://w3c.github.io/selection-api/#dom-selection-selectallchildren
* @param node Node.
*/
selectAllChildren(node) {
if (node[PropertySymbol.nodeType] === NodeTypeEnum_js_1.default.documentTypeNode) {
throw new this.#ownerDocument[PropertySymbol.window].DOMException("DocumentType Node can't be used as boundary point.", DOMExceptionNameEnum_js_1.default.invalidNodeTypeError);
}
if (node[PropertySymbol.ownerDocument] !== this.#ownerDocument) {
return;
}
const length = node[PropertySymbol.nodeArray].length;
const newRange = new this.#ownerDocument[PropertySymbol.window].Range();
newRange[PropertySymbol.start].node = node;
newRange[PropertySymbol.start].offset = 0;
newRange[PropertySymbol.end].node = node;
newRange[PropertySymbol.end].offset = length;
this.#associateRange(newRange);
}
/**
* Sets the selection to be a range including all or parts of two specified DOM nodes, and any content located between them.
*
* @see https://w3c.github.io/selection-api/#dom-selection-setbaseandextent
* @param anchorNode Anchor node.
* @param anchorOffset Anchor offset.
* @param focusNode Focus node.
* @param focusOffset Focus offset.
*/
setBaseAndExtent(anchorNode, anchorOffset, focusNode, focusOffset) {
if (anchorOffset > NodeUtility_js_1.default.getNodeLength(anchorNode) ||
focusOffset > NodeUtility_js_1.default.getNodeLength(focusNode)) {
throw new this.#ownerDocument[PropertySymbol.window].DOMException('Invalid anchor or focus offset.', DOMExceptionNameEnum_js_1.default.indexSizeError);
}
if (anchorNode[PropertySymbol.ownerDocument] !== this.#ownerDocument ||
focusNode[PropertySymbol.ownerDocument] !== this.#ownerDocument) {
return;
}
const anchor = { node: anchorNode, offset: anchorOffset };
const focus = { node: focusNode, offset: focusOffset };
const newRange = new this.#ownerDocument[PropertySymbol.window].Range();
if (RangeUtility_js_1.default.compareBoundaryPointsPosition(anchor, focus) === -1) {
newRange[PropertySymbol.start] = anchor;
newRange[PropertySymbol.end] = focus;
}
else {
newRange[PropertySymbol.start] = focus;
newRange[PropertySymbol.end] = anchor;
}
this.#associateRange(newRange);
this.#direction =
RangeUtility_js_1.default.compareBoundaryPointsPosition(focus, anchor) === -1
? SelectionDirectionEnum_js_1.default.backwards
: SelectionDirectionEnum_js_1.default.forwards;
}
/**
* Returns string currently being represented by the selection object.
*
* @returns Selection as string.
*/
toString() {
return this.#range ? this.#range.toString() : '';
}
/**
* Sets the current range.
*
* @param range Range.
*/
#associateRange(range) {
const oldRange = this.#range;
this.#range = range;
this.#direction =
range === null ? SelectionDirectionEnum_js_1.default.directionless : SelectionDirectionEnum_js_1.default.forwards;
if (oldRange !== this.#range) {
// https://w3c.github.io/selection-api/#selectionchange-event
this.#ownerDocument.dispatchEvent(new Event_js_1.default('selectionchange'));
}
}
}
exports.default = Selection;
//# sourceMappingURL=Selection.cjs.map