dom-tools.ts

/**
 * @license
 * Copyright Google LLC All Rights Reserved.
 *
 * Use of this source code is governed by an MIT-style license that can be
 * found in the LICENSE file at https://angular.io/license
 */

/**
 * Exported DOM accessor utility functions
 */
export const _dom = {
  hasStyle,
  getDistributedNodes,
  getShadowRoot,
  getText,
  getStyle,
  childNodes,
  childNodesAsList,
  hasClass,
  hasAttribute,
  getAttribute,
  hasShadowRoot,
  isCommentNode,
  isElementNode,
  isPresent,
  isShadowRoot,
  tagName,
  lastElementChild
};

// ******************************************************************************************
// These functions are cloned from
//  *  @angular/platform-browser/src/browser/GenericBrowserDomAdapter
// and are to be used ONLY internally in custom-matchers.ts and Unit Tests
// ******************************************************************************************

function getStyle(element: any, stylename: string): string {
  return element.style[stylename];
}

function hasStyle(
  element: any,
  styleName: string,
  styleValue: string = null,
  inlineOnly = true
): boolean {
  let value = getStyle(element, styleName) || '';
  if (!value && !inlineOnly) {
    // Search stylesheets
    value = getComputedStyle(element).getPropertyValue(styleName) || '';
  }
  return styleValue ? value == styleValue : value.length > 0;
}

function getDistributedNodes(el: HTMLElement): Node[] {
  return (<any>el).getDistributedNodes();
}

function getShadowRoot(el: HTMLElement): DocumentFragment {
  return (<any>el).shadowRoot;
}

function getText(el: Node): string {
  return el.textContent;
}

function childNodesAsList(el: Node): any[] {
  const list = el.childNodes;
  const res = new Array(list.length);
  for (let i = 0; i < list.length; i++) {
    res[i] = list[i];
  }
  return res;
}

function hasClass(element: any, className: string): boolean {
  return element.classList.contains(className);
}

function hasAttribute(element: any, attributeName: string): boolean {
  return element.hasAttribute(attributeName);
}

function getAttribute(element: any, attributeName: string): string {
  return element.getAttribute(attributeName);
}

function childNodes(el: any): Node[] {
  return el.childNodes;
}

function hasShadowRoot(node: any): boolean {
  return isPresent(node.shadowRoot) && node instanceof HTMLElement;
}

function isCommentNode(node: Node): boolean {
  return node.nodeType === Node.COMMENT_NODE;
}

function isElementNode(node: Node): boolean {
  return node.nodeType === Node.ELEMENT_NODE;
}

function isShadowRoot(node: any): boolean {
  return node instanceof DocumentFragment;
}

function isPresent(obj: any): boolean {
  return obj != null;
}

function tagName(element: any): string {
  return element.tagName;
}

// ******************************************************************************************
// These functions are part of the DOM API
// and are to be used ONLY internally in custom-matchers.ts and Unit Tests
// ******************************************************************************************

function lastElementChild(element: any): Node | null {
  return element.lastElementChild;
}