@ckeditor/ckeditor5-utils 34.2.0 → 35.1.0

package/src/dom/getpositionedancestor.js

@@ -2,27 +2,22 @@
  * @license Copyright (c) 2003-2022, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
-
 /**
  * @module utils/dom/getpositionedancestor
  */
-
 import global from './global';
-
 /**
  * For a given element, returns the nearest ancestor element which CSS position is not "static".
  *
- * @param {HTMLElement} element The native DOM element to be checked.
+ * @param {HTMLElement} [element] The native DOM element to be checked.
  * @returns {HTMLElement|null}
  */
-export default function getPositionedAncestor( element ) {
-	if ( !element || !element.parentNode ) {
-		return null;
-	}
-
-	if ( element.offsetParent === global.document.body ) {
-		return null;
-	}
-
-	return element.offsetParent;
+export default function getPositionedAncestor(element) {
+    if (!element || !element.parentNode) {
+        return null;
+    }
+    if (element.offsetParent === global.document.body) {
+        return null;
+    }
+    return element.offsetParent;
 }

package/src/dom/global.js

@@ -2,13 +2,10 @@
  * @license Copyright (c) 2003-2022, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
-
 /* globals window, document */
-
 /**
  * @module utils/dom/global
  */
-
 /**
  * A helper (module) giving an access to the global DOM objects such as `window` and
  * `document`. Accessing these objects using this helper allows easy and bulletproof
@@ -23,4 +20,18 @@
  *
  *		console.log( global.window.innerWidth );
  */
-export default { window, document };
+let global;
+// In some environments window and document API might not be available.
+try {
+    global = { window, document };
+}
+catch (e) {
+    // It's not possible to mock a window object to simulate lack of a window object without writing extremely convoluted code.
+    /* istanbul ignore next */
+    // Let's cast it to not change module's API.
+    // We only handle this so loading editor in environments without window and document doesn't fail.
+    // For better DX we shouldn't introduce mixed types and require developers to check the type manually.
+    // This module should not be used on purpose in any environment outside browser.
+    global = { window: {}, document: {} };
+}
+export default global;

package/src/dom/indexof.js

@@ -2,24 +2,20 @@
  * @license Copyright (c) 2003-2022, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
-
 /**
  * @module utils/dom/indexof
  */
-
 /**
  * Returns index of the node in the parent element.
  *
  * @param {Node} node Node which index is tested.
  * @returns {Number} Index of the node in the parent element. Returns 0 if node has no parent.
  */
-export default function indexOf( node ) {
-	let index = 0;
-
-	while ( node.previousSibling ) {
-		node = node.previousSibling;
-		index++;
-	}
-
-	return index;
+export default function indexOf(node) {
+    let index = 0;
+    while (node.previousSibling) {
+        node = node.previousSibling;
+        index++;
+    }
+    return index;
 }

package/src/dom/insertat.js

@@ -2,11 +2,9 @@
  * @license Copyright (c) 2003-2022, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
-
 /**
  * @module utils/dom/insertat
  */
-
 /**
  * Inserts node to the parent at given index.
  *
@@ -14,6 +12,6 @@
  * @param {Number} index Insertions index.
  * @param {Node} nodeToInsert Node to insert.
  */
-export default function insertAt( parentElement, index, nodeToInsert ) {
-	parentElement.insertBefore( nodeToInsert, parentElement.childNodes[ index ] || null );
+export default function insertAt(parentElement, index, nodeToInsert) {
+    parentElement.insertBefore(nodeToInsert, parentElement.childNodes[index] || null);
 }

package/src/dom/iscomment.js

@@ -2,19 +2,16 @@
  * @license Copyright (c) 2003-2022, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
-
 /* globals Node */
-
 /**
  * @module utils/dom/iscomment
  */
-
 /**
  * Checks whether the object is a native DOM Comment node.
  *
  * @param {*} obj
  * @returns {Boolean}
  */
-export default function isComment( obj ) {
-	return obj && obj.nodeType === Node.COMMENT_NODE;
+export default function isComment(obj) {
+    return obj && obj.nodeType === Node.COMMENT_NODE;
 }

package/src/dom/isnode.js

@@ -2,25 +2,23 @@
  * @license Copyright (c) 2003-2022, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
-
 /**
  * @module utils/dom/isnode
  */
-
 /**
  * Checks if the object is a native DOM Node.
  *
  * @param {*} obj
  * @returns {Boolean}
  */
-export default function isNode( obj ) {
-	if ( obj ) {
-		if ( obj.defaultView ) {
-			return obj instanceof obj.defaultView.Document;
-		} else if ( obj.ownerDocument && obj.ownerDocument.defaultView ) {
-			return obj instanceof obj.ownerDocument.defaultView.Node;
-		}
-	}
-
-	return false;
+export default function isNode(obj) {
+    if (obj) {
+        if (obj.defaultView) {
+            return obj instanceof obj.defaultView.Document;
+        }
+        else if (obj.ownerDocument && obj.ownerDocument.defaultView) {
+            return obj instanceof obj.ownerDocument.defaultView.Node;
+        }
+    }
+    return false;
 }

package/src/dom/isrange.js

@@ -2,17 +2,15 @@
  * @license Copyright (c) 2003-2022, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
-
 /**
  * @module utils/dom/isrange
  */
-
 /**
  * Checks if the object is a native DOM Range.
  *
  * @param {*} obj
  * @returns {Boolean}
  */
-export default function isRange( obj ) {
-	return Object.prototype.toString.apply( obj ) == '[object Range]';
+export default function isRange(obj) {
+    return Object.prototype.toString.apply(obj) == '[object Range]';
 }

package/src/dom/istext.js

@@ -2,17 +2,15 @@
  * @license Copyright (c) 2003-2022, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
-
 /**
  * @module utils/dom/istext
  */
-
 /**
  * Checks if the object is a native DOM Text node.
  *
  * @param {*} obj
  * @returns {Boolean}
  */
-export default function isText( obj ) {
-	return Object.prototype.toString.call( obj ) == '[object Text]';
+export default function isText(obj) {
+    return Object.prototype.toString.call(obj) == '[object Text]';
 }

package/src/dom/isvisible.js

@@ -2,11 +2,9 @@
  * @license Copyright (c) 2003-2022, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
-
 /**
  * @module utils/dom/isvisible
  */
-
 /**
  * Checks whether the element is visible to the user in DOM:
  *
@@ -20,6 +18,6 @@
  * @param {HTMLElement|null|undefined} element
  * @returns {Boolean}
  */
-export default function isVisible( element ) {
-	return !!( element && element.getClientRects && element.getClientRects().length );
+export default function isVisible(element) {
+    return !!(element && element.getClientRects && element.getClientRects().length);
 }

package/src/dom/iswindow.js

@@ -2,29 +2,24 @@
  * @license Copyright (c) 2003-2022, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
-
 /**
  * @module utils/dom/iswindow
  */
-
 /**
  * Checks if the object is a native DOM Window.
  *
  * @param {*} obj
  * @returns {Boolean}
  */
-export default function isWindow( obj ) {
-	const stringifiedObject = Object.prototype.toString.apply( obj );
-
-	// Returns `true` for the `window` object in browser environments.
-	if ( stringifiedObject == '[object Window]' ) {
-		return true;
-	}
-
-	// Returns `true` for the `window` object in the Electron environment.
-	if ( stringifiedObject == '[object global]' ) {
-		return true;
-	}
-
-	return false;
+export default function isWindow(obj) {
+    const stringifiedObject = Object.prototype.toString.apply(obj);
+    // Returns `true` for the `window` object in browser environments.
+    if (stringifiedObject == '[object Window]') {
+        return true;
+    }
+    // Returns `true` for the `window` object in the Electron environment.
+    if (stringifiedObject == '[object global]') {
+        return true;
+    }
+    return false;
 }