pseudo-dom 0.9.0 → 0.11.0

package/dist/services/ElementService.js

@@ -1,426 +1,732 @@
-'use strict'
-
-require('core-js/modules/esnext.iterator.constructor.js')
-require('core-js/modules/esnext.iterator.every.js')
-require('core-js/modules/esnext.iterator.find.js')
-require('core-js/modules/esnext.iterator.for-each.js')
-require('core-js/modules/esnext.iterator.map.js')
-require('core-js/modules/esnext.iterator.some.js')
-const __importDefault = void 0 && (void 0).__importDefault || function (mod) {
-  return mod && mod.__esModule
-    ? mod
-    : {
-        default: mod
-      }
-}
-Object.defineProperty(exports, '__esModule', {
-  value: true
-})
-exports.ElementService = void 0
-const createEvent_1 = __importDefault(require('../factories/createEvent'))
-const NodeService_1 = require('./NodeService')
-const AttrService_1 = require('./AttrService')
-const DOMTokenListService_1 = require('./DOMTokenListService')
-const NamedNodeMapService_1 = require('./NamedNodeMapService')
-const getParentNodesFromAttribute_1 = __importDefault(require('../functions/getParentNodesFromAttribute'))
-const HTMLCollectionService_1 = require('./HTMLCollectionService')
-const cloneObject_1 = __importDefault(require('si-funciona/dist/helpers/objects/cloneObject'))
-const isEqual_1 = __importDefault(require('si-funciona/dist/helpers/objects/isEqual'))
-const query_1 = require('../factories/query')
-/**
- * Simulate the behaviour of the Element Class when there is no DOM available.
- * @author Joshua Heagle <joshuaheagle@gmail.com>
- * @class
- * @augments PseudoNode
- * @property {string} tagName
- * @property {string} className
- * @property {string} id
- * @property {string} innerHtml
- * @property {Array} attributes
- * @property {function} hasAttribute
- * @property {function} setAttribute
- * @property {function} getAttribute
- * @property {function} removeAttribute
- */
-class ElementService extends NodeService_1.NodeService {
-  /**
-   * @param {Object} [settings={}]
-   * @param {string} [settings.tagName=''] The name of the tag this element represents
-   * @param {Array<{name: string, value: *}>} [settings.attributes=[]] The attributes (also assigned as properties) to start with
-   * @param {PseudoNode|null} [settings.parent=null] The node to add this element to as its last child
-   * @param {Array<PseudoNode>} [settings.children=[]] The nodes to start as children
-   * @constructor
-   */
-  constructor ({
-    tagName = '',
-    attributes = [],
-    parent = null,
-    children = []
-  } = {}) {
-    super()
-    this.defaultEventApplied = false
-    this.tokenList = new DOMTokenListService_1.DOMTokenListService()
-    this.tag = tagName
-    this.attributeList = attributes.concat([{
-      name: 'className',
-      value: ''
-    }, {
-      name: 'id',
-      value: ''
-    }, {
-      name: 'innerHTML',
-      value: ''
-    }])
-    this.propertyAttributes = this.attributeList.map(({
-      name
-    }) => name)
-    this.attributeList.forEach(({
-      name,
-      value
-    }) => {
-      this[name] = value
-    })
-    children.forEach(child => {
-      if (!child || typeof child.nodeType !== 'number') {
-        throw new TypeError('The children of an element must be nodes.')
-      }
-      this.appendChild(child)
-    })
-    if (parent) {
-      parent.appendChild(this)
-    }
-  }
-
-  /**
-   * The attributes with the values they have now: the ones which are also properties (className, id, style, ...) can
-   * have been changed through the property, which does not change the stored list.
-   * @returns {Array<{name: string, value: *}>}
-   */
-  currentAttributes () {
-    return this.attributeList.map(({
-      name,
-      value
-    }) => ({
-      name,
-      value: this.propertyAttributes.indexOf(name) >= 0 ? this[name] : value
-    }))
-  }
-
-  get nodeName () {
-    return this.tag
-  }
-
-  /**
-   * A copy of this element without its children: the same tag and attributes (the values which are objects, such as
-   * style, are copied too rather than shared), but not its parent or listeners.
-   * @returns {ElementService}
-   */
-  cloneShallow () {
-    const copy = new this.constructor({
-      tagName: this.tag
-    })
-    copy.attributeList.length = 0
-    this.currentAttributes().forEach(({
-      name,
-      value
-    }) => {
-      const copied = typeof value === 'object' && value !== null ? (0, cloneObject_1.default)(value) : value
-      copy.attributeList.push({
-        name,
-        value: copied
-      })
-      if (copy.propertyAttributes.indexOf(name) >= 0) {
-        copy[name] = copied
-      }
-    })
-    copy.ownerDocumentStore = this.ownerDocumentStore
-    return copy
-  }
-
-  /**
-   * Elements are equal when they have the same tag and the same attributes (in any order), which is what isEqualNode
-   * checks before it compares the children.
-   * @param {NodeService} other The element to compare with
-   * @returns {boolean}
-   */
-  equalsShallow (other) {
-    const mine = this.currentAttributes()
-    const theirs = other.currentAttributes()
-    return this.nodeName === other.nodeName && mine.length === theirs.length && mine.every(({
-      name,
-      value
-    }) => {
-      const match = theirs.find(attributeOfOther => attributeOfOther.name === name)
-      return typeof match !== 'undefined' && (0, isEqual_1.default)(value, match.value)
-    })
-  }
-
-  get tagName () {
-    return this.tag
-  }
-
-  get nodeType () {
-    return NodeService_1.NodeService.ELEMENT_NODE
-  }
-
-  get attributes () {
-    return new NamedNodeMapService_1.NamedNodeMapService(this.currentAttributes().map(({
-      name,
-      value
-    }) => new AttrService_1.AttrService(name, String(value), this)))
-  }
-
-  get classList () {
-    return this.tokenList
-  }
-
-  get className () {
-    return this.tokenList.value
-  }
-
-  set className (className) {
-    this.tokenList.value = className
-  }
-
-  /**
-   * Some elements have default behaviour, this registers it when the element is added.
-   * @returns {Function}
-   */
-  /**
-   * A live view of this element's element children (text, comments and the like are not included).
-   * @returns {PseudoHTMLCollection}
-   */
-  get children () {
-    return new HTMLCollectionService_1.HTMLCollectionService(this)
-  }
-
-  /**
-   * How many element children this element has.
-   * @returns {number}
-   */
-  get childElementCount () {
-    return this.children.length
-  }
-
-  /**
-   * The first child of this element which is an element, or null when there is none.
-   * @returns {PseudoElement|null}
-   */
-  get firstElementChild () {
-    return this.children.item(0)
-  }
-
-  /**
-   * The last child of this element which is an element, or null when there is none.
-   * @returns {PseudoElement|null}
-   */
-  get lastElementChild () {
-    const elementChildren = this.children
-    return elementChildren.item(elementChildren.length - 1)
-  }
-
-  /**
-   * The sibling after this one which is an element, or null when there is none.
-   * @returns {PseudoElement|null}
-   */
-  get nextElementSibling () {
-    let sibling = this.nextSibling
-    while (sibling && sibling.nodeType !== NodeService_1.NodeService.ELEMENT_NODE) {
-      sibling = sibling.nextSibling
-    }
-    return sibling
-  }
-
-  /**
-   * The sibling before this one which is an element, or null when there is none.
-   * @returns {PseudoElement|null}
-   */
-  get previousElementSibling () {
-    let sibling = this.previousSibling
-    while (sibling && sibling.nodeType !== NodeService_1.NodeService.ELEMENT_NODE) {
-      sibling = sibling.previousSibling
-    }
-    return sibling
-  }
-
-  /**
-   * Put an element at a position relative to this one: beforebegin (before this element, as its previous sibling),
-   * afterbegin (as this element's first child), beforeend (as this element's last child) or afterend (after this
-   * element, as its next sibling).
-   * @param {string} position beforebegin, afterbegin, beforeend or afterend
-   * @param {ElementService} element The element to insert
-   * @returns {ElementService|null} The inserted element, or null when the position needed a parent this element does not have
-   * @throws {Error} When the position is not one of the four above
-   */
-  insertAdjacentElement (position, element) {
-    return this.insertAdjacent(position, element)
-  }
-
-  /**
-   * Put text at a position relative to this element, the same as insertAdjacentElement but the text becomes a text node.
-   * @param {string} position beforebegin, afterbegin, beforeend or afterend
-   * @param {string} text The text to insert
-   * @throws {Error} When the position is not one of the four above
-   */
-  insertAdjacentText (position, text) {
-    this.insertAdjacent(position, text)
-  }
-
-  /**
-   * Shared implementation for insertAdjacentElement / insertAdjacentText.
-   * @param {string} position beforebegin, afterbegin, beforeend or afterend
-   * @param {PseudoNode|string} node The node (or text) to insert
-   * @returns {PseudoNode|null} The inserted node, or null when the position needed a parent this element does not have
-   * @throws {Error} When the position is not one of the four above
-   */
-  insertAdjacent (position, node) {
-    switch (position) {
-      case 'beforebegin':
-        if (!this.parentNode) {
-          return null
-        }
-        this.before(node)
-        return node
-      case 'afterbegin':
-        this.prepend(node)
-        return node
-      case 'beforeend':
-        this.append(node)
-        return node
-      case 'afterend':
-        if (!this.parentNode) {
-          return null
-        }
-        this.after(node)
-        return node
-      default:
-        throw new Error(`"${position}" is not one of beforebegin, afterbegin, beforeend or afterend.`)
-    }
-  }
-
-  /**
-   * Not implemented yet (HTML parsing is out of scope for now).
-   * @param {string} position beforebegin, afterbegin, beforeend or afterend
-   * @param {string} text The markup which would be parsed
-   * @throws {Error}
-   */
-  insertAdjacentHTML (position, text) {
-    throw new Error('ElementService.insertAdjacentHTML() is not implemented yet.')
-  }
-
-  /**
-   * Whether this element itself (not its descendants) matches the given CSS selector.
-   * @param {string} selectors A CSS selector
-   * @returns {boolean}
-   */
-  matches (selectors) {
-    return (0, query_1.matches)(this, selectors)
-  }
-
-  /**
-   * The nearest ancestor of this element (starting with this element itself) which matches the CSS selector, or
-   * null when none of them do.
-   * @param {string} selectors A CSS selector
-   * @returns {PseudoElement|null}
-   */
-  closest (selectors) {
-    return (0, query_1.closest)(this, selectors)
-  }
-
-  applyDefaultEvent () {
-    let callback = event => undefined
-    if (this.defaultEventApplied) {
-      return callback
-    }
-    switch (this.tagName) {
-      case 'button':
-      case 'input':
-        // Clicking a submit button submits the form it is in: the form gets a submit event, which can be cancelled
-        callback = event => {
-          const type = String(this.getAttribute('type') || this.type || '').toLowerCase()
-          const submits = this.tagName === 'button' ? type !== 'button' && type !== 'reset' : /^(submit|image)$/.test(type)
-          const forms = (0, getParentNodesFromAttribute_1.default)('tagName', 'form', this)
-          if (submits && forms.length && !this.hasAttribute('disabled')) {
-            forms[forms.length - 1].dispatchEvent((0, createEvent_1.default)('submit', {}, {
-              browser: true,
-              trusted: event.isTrusted
-            }))
-          }
-        }
-        super.setDefaultEvent('click', callback)
-        this.defaultEventApplied = true
-    }
-    return callback
-  }
-
-  /**
-   * An element which is added as a child gets its default events (for example a submit button submits its form).
-   * @param {NodeService} child The node which was inserted
-   */
-  childInserted (child) {
-    if (typeof child.applyDefaultEvent === 'function') {
-      child.applyDefaultEvent()
-    }
-  }
-
-  /**
-   * Check whether the element has an attribute by that name.
-   * @param {string} attributeName
-   * @returns {boolean}
-   */
-  hasAttribute (attributeName) {
-    return this.attributeList.some(({
-      name
-    }) => name === attributeName)
-  }
-
-  /**
-   * Set the value of an attribute, adding the attribute if it did not exist.
-   * @param {string} attributeName
-   * @param {string} attributeValue
-   * @returns {undefined}
-   */
-  setAttribute (attributeName, attributeValue) {
-    const existing = this.attributeList.find(({
-      name
-    }) => name === attributeName)
-    if (existing) {
-      existing.value = attributeValue
-    } else {
-      this.attributeList.push({
-        name: attributeName,
-        value: attributeValue
-      })
-    }
-    if (this.propertyAttributes.indexOf(attributeName) >= 0) {
-      this[attributeName] = attributeValue
-    }
-  }
-
-  /**
-   * Retrieve the value of an attribute.
-   * @param {string} attributeName
-   * @returns {string|null} The value, or null when there is no such attribute
-   */
-  getAttribute (attributeName) {
-    const found = this.currentAttributes().find(({
-      name
-    }) => name === attributeName)
-    return found ? found.value : null
-  }
-
-  /**
-   * Remove an attribute from the element.
-   * @param {string} attributeName
-   * @returns {undefined}
-   */
-  removeAttribute (attributeName) {
-    const index = this.attributeList.findIndex(({
-      name
-    }) => name === attributeName)
-    if (index >= 0) {
-      this.attributeList.splice(index, 1)
-    }
-  }
-}
-exports.ElementService = ElementService
+'use strict'
+
+require('core-js/modules/esnext.iterator.constructor.js')
+require('core-js/modules/esnext.iterator.every.js')
+require('core-js/modules/esnext.iterator.find.js')
+require('core-js/modules/esnext.iterator.for-each.js')
+require('core-js/modules/esnext.iterator.map.js')
+require('core-js/modules/esnext.iterator.some.js')
+require('core-js/modules/esnext.set.add-all.js')
+require('core-js/modules/esnext.set.delete-all.js')
+require('core-js/modules/esnext.set.difference.js')
+require('core-js/modules/esnext.set.every.js')
+require('core-js/modules/esnext.set.filter.js')
+require('core-js/modules/esnext.set.find.js')
+require('core-js/modules/esnext.set.intersection.js')
+require('core-js/modules/esnext.set.is-disjoint-from.js')
+require('core-js/modules/esnext.set.is-subset-of.js')
+require('core-js/modules/esnext.set.is-superset-of.js')
+require('core-js/modules/esnext.set.join.js')
+require('core-js/modules/esnext.set.map.js')
+require('core-js/modules/esnext.set.reduce.js')
+require('core-js/modules/esnext.set.some.js')
+require('core-js/modules/esnext.set.symmetric-difference.js')
+require('core-js/modules/esnext.set.union.js')
+const __importDefault = void 0 && (void 0).__importDefault || function (mod) {
+  return mod && mod.__esModule
+    ? mod
+    : {
+        default: mod
+      }
+}
+Object.defineProperty(exports, '__esModule', {
+  value: true
+})
+exports.ElementService = void 0
+const createEvent_1 = __importDefault(require('../factories/createEvent'))
+const NodeService_1 = require('./NodeService')
+const AttrService_1 = require('./AttrService')
+const DOMTokenListService_1 = require('./DOMTokenListService')
+const NamedNodeMapService_1 = require('./NamedNodeMapService')
+const getParentNodesFromAttribute_1 = __importDefault(require('../functions/getParentNodesFromAttribute'))
+const HTMLCollectionService_1 = require('./HTMLCollectionService')
+const cloneObject_1 = __importDefault(require('si-funciona/dist/helpers/objects/cloneObject'))
+const isEqual_1 = __importDefault(require('si-funciona/dist/helpers/objects/isEqual'))
+const query_1 = require('../factories/query')
+const ShadowRootService_1 = require('./ShadowRootService')
+const serializeHTML_1 = require('../factories/serializeHTML')
+const zeroRect = () => ({
+  x: 0,
+  y: 0,
+  width: 0,
+  height: 0,
+  top: 0,
+  right: 0,
+  bottom: 0,
+  left: 0
+})
+/**
+ * Simulate the behaviour of the Element Class when there is no DOM available.
+ * @author Joshua Heagle <joshuaheagle@gmail.com>
+ * @class
+ * @augments PseudoNode
+ * @property {string} tagName
+ * @property {string} className
+ * @property {string} id
+ * @property {string} innerHtml
+ * @property {Array} attributes
+ * @property {function} hasAttribute
+ * @property {function} setAttribute
+ * @property {function} getAttribute
+ * @property {function} removeAttribute
+ */
+class ElementService extends NodeService_1.NodeService {
+  /**
+   * @param {Object} [settings={}]
+   * @param {string} [settings.tagName=''] The name of the tag this element represents
+   * @param {Array<{name: string, value: *}>} [settings.attributes=[]] The attributes (also assigned as properties) to start with
+   * @param {PseudoNode|null} [settings.parent=null] The node to add this element to as its last child
+   * @param {Array<PseudoNode>} [settings.children=[]] The nodes to start as children
+   * @constructor
+   */
+  constructor ({
+    tagName = '',
+    attributes = [],
+    parent = null,
+    children = []
+  } = {}) {
+    super()
+    /** What getBoundingClientRect() returns - not really computed (there is no layout engine), set this directly. */
+    this.boundingClientRect = zeroRect()
+    /** What getClientRects() returns - set this directly. */
+    this.clientRects = []
+    /** What getAnimations() returns - set this directly. */
+    this.animations = []
+    /** What checkVisibility() returns - set this directly. */
+    this.isVisible = true
+    this.capturedPointers = new Set()
+    this.shadowRootInstance = null
+    this.defaultEventApplied = false
+    this.tokenList = new DOMTokenListService_1.DOMTokenListService()
+    this.tag = tagName
+    this.attributeList = attributes.concat([{
+      name: 'className',
+      value: ''
+    }, {
+      name: 'id',
+      value: ''
+    },
+    // Layout is not really computed (there is no rendering engine here): these start at 0, like an unrendered
+    // element's would, but can be set directly to whatever a test needs code under test to see.
+    {
+      name: 'clientHeight',
+      value: 0
+    }, {
+      name: 'clientLeft',
+      value: 0
+    }, {
+      name: 'clientTop',
+      value: 0
+    }, {
+      name: 'clientWidth',
+      value: 0
+    }, {
+      name: 'scrollHeight',
+      value: 0
+    }, {
+      name: 'scrollLeft',
+      value: 0
+    }, {
+      name: 'scrollTop',
+      value: 0
+    }, {
+      name: 'scrollWidth',
+      value: 0
+    }])
+    this.propertyAttributes = this.attributeList.map(({
+      name
+    }) => name)
+    this.attributeList.forEach(({
+      name,
+      value
+    }) => {
+      this[name] = value
+    })
+    children.forEach(child => {
+      if (!child || typeof child.nodeType !== 'number') {
+        throw new TypeError('The children of an element must be nodes.')
+      }
+      this.appendChild(child)
+    })
+    if (parent) {
+      parent.appendChild(this)
+    }
+  }
+
+  /**
+   * The attributes with the values they have now: the ones which are also properties (className, id, style, ...) can
+   * have been changed through the property, which does not change the stored list.
+   * @returns {Array<{name: string, value: *}>}
+   */
+  currentAttributes () {
+    return this.attributeList.map(({
+      name,
+      value
+    }) => ({
+      name,
+      value: this.propertyAttributes.indexOf(name) >= 0 ? this[name] : value
+    }))
+  }
+
+  get nodeName () {
+    return this.tag
+  }
+
+  /**
+   * A copy of this element without its children: the same tag and attributes (the values which are objects, such as
+   * style, are copied too rather than shared), but not its parent or listeners.
+   * @returns {ElementService}
+   */
+  cloneShallow () {
+    const copy = new this.constructor({
+      tagName: this.tag
+    })
+    copy.attributeList.length = 0
+    this.currentAttributes().forEach(({
+      name,
+      value
+    }) => {
+      const copied = typeof value === 'object' && value !== null ? (0, cloneObject_1.default)(value) : value
+      copy.attributeList.push({
+        name,
+        value: copied
+      })
+      if (copy.propertyAttributes.indexOf(name) >= 0) {
+        copy[name] = copied
+      }
+    })
+    copy.ownerDocumentStore = this.ownerDocumentStore
+    return copy
+  }
+
+  /**
+   * Elements are equal when they have the same tag and the same attributes (in any order), which is what isEqualNode
+   * checks before it compares the children.
+   * @param {NodeService} other The element to compare with
+   * @returns {boolean}
+   */
+  equalsShallow (other) {
+    const mine = this.currentAttributes()
+    const theirs = other.currentAttributes()
+    return this.nodeName === other.nodeName && mine.length === theirs.length && mine.every(({
+      name,
+      value
+    }) => {
+      const match = theirs.find(attributeOfOther => attributeOfOther.name === name)
+      return typeof match !== 'undefined' && (0, isEqual_1.default)(value, match.value)
+    })
+  }
+
+  get tagName () {
+    return this.tag
+  }
+
+  /**
+   * The local part of the element's qualified name. There is no real namespace parsing here, so this is always the
+   * same as tagName.
+   * @returns {string}
+   */
+  get localName () {
+    return this.tag
+  }
+
+  /**
+   * The element's namespace prefix, or null when it has none. There is no real namespace parsing here, so this is
+   * always null.
+   * @returns {string|null}
+   */
+  get prefix () {
+    return null
+  }
+
+  /**
+   * The HTML markup of this element's children. Only the getter is here (the setter, which needs to build new
+   * elements from parsed HTML, is on HTMLElementService - see its class comment).
+   * @returns {string}
+   */
+  get innerHTML () {
+    return (0, serializeHTML_1.serializeChildren)(this)
+  }
+
+  /**
+   * The HTML markup of this element itself, including its children. Only the getter is here (see innerHTML).
+   * @returns {string}
+   */
+  get outerHTML () {
+    return (0, serializeHTML_1.serializeOuter)(this)
+  }
+
+  get nodeType () {
+    return NodeService_1.NodeService.ELEMENT_NODE
+  }
+
+  get attributes () {
+    return new NamedNodeMapService_1.NamedNodeMapService(this.currentAttributes().map(({
+      name,
+      value
+    }) => new AttrService_1.AttrService(name, String(value), this)))
+  }
+
+  get classList () {
+    return this.tokenList
+  }
+
+  get className () {
+    return this.tokenList.value
+  }
+
+  set className (className) {
+    this.tokenList.value = className
+  }
+
+  /**
+   * Some elements have default behaviour, this registers it when the element is added.
+   * @returns {Function}
+   */
+  /**
+   * A live view of this element's element children (text, comments and the like are not included).
+   * @returns {PseudoHTMLCollection}
+   */
+  get children () {
+    return new HTMLCollectionService_1.HTMLCollectionService(this)
+  }
+
+  /**
+   * How many element children this element has.
+   * @returns {number}
+   */
+  get childElementCount () {
+    return this.children.length
+  }
+
+  /**
+   * The first child of this element which is an element, or null when there is none.
+   * @returns {PseudoElement|null}
+   */
+  get firstElementChild () {
+    return this.children.item(0)
+  }
+
+  /**
+   * The last child of this element which is an element, or null when there is none.
+   * @returns {PseudoElement|null}
+   */
+  get lastElementChild () {
+    const elementChildren = this.children
+    return elementChildren.item(elementChildren.length - 1)
+  }
+
+  /**
+   * The sibling after this one which is an element, or null when there is none.
+   * @returns {PseudoElement|null}
+   */
+  get nextElementSibling () {
+    let sibling = this.nextSibling
+    while (sibling && sibling.nodeType !== NodeService_1.NodeService.ELEMENT_NODE) {
+      sibling = sibling.nextSibling
+    }
+    return sibling
+  }
+
+  /**
+   * The sibling before this one which is an element, or null when there is none.
+   * @returns {PseudoElement|null}
+   */
+  get previousElementSibling () {
+    let sibling = this.previousSibling
+    while (sibling && sibling.nodeType !== NodeService_1.NodeService.ELEMENT_NODE) {
+      sibling = sibling.previousSibling
+    }
+    return sibling
+  }
+
+  /**
+   * Put an element at a position relative to this one: beforebegin (before this element, as its previous sibling),
+   * afterbegin (as this element's first child), beforeend (as this element's last child) or afterend (after this
+   * element, as its next sibling).
+   * @param {string} position beforebegin, afterbegin, beforeend or afterend
+   * @param {ElementService} element The element to insert
+   * @returns {ElementService|null} The inserted element, or null when the position needed a parent this element does not have
+   * @throws {Error} When the position is not one of the four above
+   */
+  insertAdjacentElement (position, element) {
+    return this.insertAdjacent(position, element)
+  }
+
+  /**
+   * Put text at a position relative to this element, the same as insertAdjacentElement but the text becomes a text node.
+   * @param {string} position beforebegin, afterbegin, beforeend or afterend
+   * @param {string} text The text to insert
+   * @throws {Error} When the position is not one of the four above
+   */
+  insertAdjacentText (position, text) {
+    this.insertAdjacent(position, text)
+  }
+
+  /**
+   * Shared implementation for insertAdjacentElement / insertAdjacentText.
+   * @param {string} position beforebegin, afterbegin, beforeend or afterend
+   * @param {PseudoNode|string} node The node (or text) to insert
+   * @returns {PseudoNode|null} The inserted node, or null when the position needed a parent this element does not have
+   * @throws {Error} When the position is not one of the four above
+   */
+  insertAdjacent (position, node) {
+    switch (position) {
+      case 'beforebegin':
+        if (!this.parentNode) {
+          return null
+        }
+        this.before(node)
+        return node
+      case 'afterbegin':
+        this.prepend(node)
+        return node
+      case 'beforeend':
+        this.append(node)
+        return node
+      case 'afterend':
+        if (!this.parentNode) {
+          return null
+        }
+        this.after(node)
+        return node
+      default:
+        throw new Error(`"${position}" is not one of beforebegin, afterbegin, beforeend or afterend.`)
+    }
+  }
+
+  /**
+   * Not implemented yet (HTML parsing is out of scope for now).
+   * @param {string} position beforebegin, afterbegin, beforeend or afterend
+   * @param {string} text The markup which would be parsed
+   * @throws {Error}
+   */
+  insertAdjacentHTML (position, text) {
+    throw new Error('ElementService.insertAdjacentHTML() is not implemented yet.')
+  }
+
+  /**
+   * Whether this element itself (not its descendants) matches the given CSS selector.
+   * @param {string} selectors A CSS selector
+   * @returns {boolean}
+   */
+  matches (selectors) {
+    return (0, query_1.matches)(this, selectors)
+  }
+
+  /**
+   * The nearest ancestor of this element (starting with this element itself) which matches the CSS selector, or
+   * null when none of them do.
+   * @param {string} selectors A CSS selector
+   * @returns {PseudoElement|null}
+   */
+  closest (selectors) {
+    return (0, query_1.closest)(this, selectors)
+  }
+
+  applyDefaultEvent () {
+    let callback = event => undefined
+    if (this.defaultEventApplied) {
+      return callback
+    }
+    switch (this.tagName) {
+      case 'button':
+      case 'input':
+        // Clicking a submit button submits the form it is in: the form gets a submit event, which can be cancelled
+        callback = event => {
+          const type = String(this.getAttribute('type') || this.type || '').toLowerCase()
+          const submits = this.tagName === 'button' ? type !== 'button' && type !== 'reset' : /^(submit|image)$/.test(type)
+          const forms = (0, getParentNodesFromAttribute_1.default)('tagName', 'form', this)
+          if (submits && forms.length && !this.hasAttribute('disabled')) {
+            forms[forms.length - 1].dispatchEvent((0, createEvent_1.default)('submit', {}, {
+              browser: true,
+              trusted: event.isTrusted
+            }))
+          }
+        }
+        super.setDefaultEvent('click', callback)
+        this.defaultEventApplied = true
+    }
+    return callback
+  }
+
+  /**
+   * An element which is added as a child gets its default events (for example a submit button submits its form).
+   * @param {NodeService} child The node which was inserted
+   */
+  childInserted (child) {
+    if (typeof child.applyDefaultEvent === 'function') {
+      child.applyDefaultEvent()
+    }
+  }
+
+  /**
+   * Check whether the element has an attribute by that name.
+   * @param {string} attributeName
+   * @returns {boolean}
+   */
+  hasAttribute (attributeName) {
+    return this.attributeList.some(({
+      name
+    }) => name === attributeName)
+  }
+
+  /**
+   * Set the value of an attribute, adding the attribute if it did not exist.
+   * @param {string} attributeName
+   * @param {string} attributeValue
+   * @returns {undefined}
+   */
+  setAttribute (attributeName, attributeValue) {
+    const existing = this.attributeList.find(({
+      name
+    }) => name === attributeName)
+    if (existing) {
+      existing.value = attributeValue
+    } else {
+      this.attributeList.push({
+        name: attributeName,
+        value: attributeValue
+      })
+    }
+    if (this.propertyAttributes.indexOf(attributeName) >= 0) {
+      this[attributeName] = attributeValue
+    }
+  }
+
+  /**
+   * Retrieve the value of an attribute.
+   * @param {string} attributeName
+   * @returns {string|null} The value, or null when there is no such attribute
+   */
+  getAttribute (attributeName) {
+    const found = this.currentAttributes().find(({
+      name
+    }) => name === attributeName)
+    return found ? found.value : null
+  }
+
+  /**
+   * Remove an attribute from the element.
+   * @param {string} attributeName
+   * @returns {undefined}
+   */
+  removeAttribute (attributeName) {
+    const index = this.attributeList.findIndex(({
+      name
+    }) => name === attributeName)
+    if (index >= 0) {
+      this.attributeList.splice(index, 1)
+    }
+  }
+
+  /**
+   * The name of every attribute on the element, in the order they were set.
+   * @returns {Array<string>}
+   */
+  getAttributeNames () {
+    return this.currentAttributes().map(({
+      name
+    }) => name)
+  }
+
+  /**
+   * Whether the element has any attributes at all.
+   * @returns {boolean}
+   */
+  hasAttributes () {
+    return this.attributeList.length > 0
+  }
+
+  /**
+   * Add the attribute (with an empty value) when it is not present, or remove it when it is - unless force says
+   * which of those to do instead. Returns whether the attribute is present after the call.
+   * @param {string} attributeName
+   * @param {boolean} [force]
+   * @returns {boolean}
+   */
+  toggleAttribute (attributeName, force) {
+    const present = this.hasAttribute(attributeName)
+    const shouldHave = typeof force === 'boolean' ? force : !present
+    if (shouldHave && !present) {
+      this.setAttribute(attributeName, '')
+    } else if (!shouldHave && present) {
+      this.removeAttribute(attributeName)
+    }
+    return shouldHave
+  }
+
+  /**
+   * The size of the element and its position, settable directly - there is no layout engine here to compute it.
+   * @returns {DOMRect}
+   */
+  getBoundingClientRect () {
+    return this.boundingClientRect
+  }
+
+  /**
+   * The bounding rectangles for each line of text in the element, settable directly - there is no layout engine
+   * here to compute it.
+   * @returns {Array<DOMRect>}
+   */
+  getClientRects () {
+    return this.clientRects
+  }
+
+  /**
+   * The Animation objects currently active on the element, settable directly - there is no animation engine here.
+   * @returns {Array<*>}
+   */
+  getAnimations () {
+    return this.animations
+  }
+
+  /**
+   * Whether the element is expected to be visible, settable directly - there is no rendering here to check it.
+   * @returns {boolean}
+   */
+  checkVisibility () {
+    return this.isVisible
+  }
+
+  /**
+   * A read-only view of the element's own inline style declarations (there is no CSS cascade here, so this is not a
+   * real computed style - just what the element's own style object holds).
+   * @returns {{get: function(string): (string|undefined)}}
+   */
+  computedStyleMap () {
+    const style = this.style
+    return {
+      get: property => {
+        const value = style ? style.getPropertyValue(property) : ''
+        return value === '' ? undefined : value
+      }
+    }
+  }
+
+  /**
+   * Whether this element currently has capture of the given pointer.
+   * @param {number} pointerId
+   * @returns {boolean}
+   */
+  hasPointerCapture (pointerId) {
+    return this.capturedPointers.has(pointerId)
+  }
+
+  /**
+   * Give this element capture of the given pointer.
+   * @param {number} pointerId
+   * @returns {undefined}
+   */
+  setPointerCapture (pointerId) {
+    this.capturedPointers.add(pointerId)
+  }
+
+  /**
+   * Release this element's capture of the given pointer, if it had it.
+   * @param {number} pointerId
+   * @returns {undefined}
+   */
+  releasePointerCapture (pointerId) {
+    this.capturedPointers.delete(pointerId)
+  }
+
+  /**
+   * Scroll to the given position (or, given an options object, the position(s) it has). There is no real scrollable
+   * viewport here: this just sets scrollLeft / scrollTop.
+   * @param {number|{left: number, top: number}} [x=0]
+   * @param {number} [y=0]
+   * @returns {undefined}
+   */
+  scroll (x = 0, y = 0) {
+    if (typeof x === 'number') {
+      this.scrollLeft = x
+      this.scrollTop = y
+      return
+    }
+    if (typeof x.left === 'number') {
+      this.scrollLeft = x.left
+    }
+    if (typeof x.top === 'number') {
+      this.scrollTop = x.top
+    }
+  }
+
+  /**
+   * Scroll to the given position. An alias for scroll.
+   * @param {number|{left: number, top: number}} [x=0]
+   * @param {number} [y=0]
+   * @returns {undefined}
+   */
+  scrollTo (x = 0, y = 0) {
+    this.scroll(x, y)
+  }
+
+  /**
+   * Scroll by the given amount, relative to the current position.
+   * @param {number|{left: number, top: number}} [x=0]
+   * @param {number} [y=0]
+   * @returns {undefined}
+   */
+  scrollBy (x = 0, y = 0) {
+    if (typeof x === 'number') {
+      this.scroll(this.scrollLeft + x, this.scrollTop + y)
+      return
+    }
+    this.scroll({
+      left: this.scrollLeft + (x.left || 0),
+      top: this.scrollTop + (x.top || 0)
+    })
+  }
+
+  /**
+   * Scroll an ancestor until this element is in view. There is no real viewport here for that to mean anything, so
+   * this does nothing (override it on an instance in a test which needs to observe the call).
+   * @returns {undefined}
+   */
+  scrollIntoView () {}
+  /**
+   * Asynchronously ask for the element to be shown fullscreen. There is no real fullscreen here, so this just
+   * resolves, like a browser granting the request would.
+   * @returns {Promise<void>}
+   */
+  requestFullscreen () {
+    return Promise.resolve()
+  }
+
+  /**
+   * Asynchronously ask for the pointer to be locked to this element. There is no real pointer lock here, so this
+   * just resolves, like a browser granting the request would.
+   * @returns {Promise<void>}
+   */
+  requestPointerLock () {
+    return Promise.resolve()
+  }
+
+  /**
+   * Attach a shadow tree to this element and return its ShadowRoot. Throws when it already hosts one.
+   * @param {{mode: string}} options
+   * @returns {PseudoShadowRoot}
+   * @throws {Error}
+   */
+  attachShadow (options) {
+    if (this.shadowRootInstance) {
+      throw new Error('Shadow root cannot be created on a host which already hosts a shadow tree.')
+    }
+    const root = new ShadowRootService_1.ShadowRootService()
+    root.host = this
+    root.mode = options.mode
+    this.shadowRootInstance = root
+    return root
+  }
+
+  /**
+   * This element's shadow root, when it has one attached in 'open' mode, or null (including when the mode is
+   * 'closed' - it still exists, but is not reachable this way, like the DOM's).
+   * @returns {PseudoShadowRoot|null}
+   */
+  get shadowRoot () {
+    return this.shadowRootInstance && this.shadowRootInstance.mode === 'open' ? this.shadowRootInstance : null
+  }
+}
+exports.ElementService = ElementService