How to find the highest z-index on a page using JavaScript

Learn to use JavaScript to find the highest z-index value on a web page. Discover a method for identifying the topmost element with a high z-index.

To find the highest z-index value on a page using JavaScript, you can loop through all the elements on the page and check their z-index values. The element with the highest z-index value will be the one that appears on top of all other elements.

The z-index property in CSS controls the stacking order of overlapping elements on a page. An element with a higher z-index value will appear in front of an element with a lower z-index value. To set an element behind another element, add a negative value like z-index: -1;.

Practical code example for finding highest z-index

The following code written in JavaScript determines the highest z-index used on the page. Optionally, you can specify a CSS selector to limit the search to specific elements. The function also accounts for elements within shadow DOMs.

function getHighestZindex() {
  const zIndexes = [];
  const allElements = Array.from(document.querySelectorAll('*'));

  function collectZIndexes(elements) {
    for (const element of elements) {
      const zIndex = window.getComputedStyle(element, null).getPropertyValue("z-index");

      if (zIndex !== undefined && zIndex !== 'auto') {
        zIndexes.push(Number(zIndex));
      }
    }
  }

  collectZIndexes(allElements);

  const shadowRoots = allElements.filter(el => el.shadowRoot);

  for (const root of shadowRoots) {
    if (root.shadowRoot === null) {
      continue;
    }

    collectZIndexes(Array.from(root.shadowRoot.querySelectorAll('*')));
  }

  return zIndexes.length === 0 ? 0 : Math.max(...zIndexes);
}

You can also use the document.elementsFromPoint() method to get all elements at a given point on the page and use that instead of Array.from(document.querySelectorAll(selector || "body *")).

Can this method be modified to work with iframes or shadow DOM?

Yes, the method can be modified to work with iframes or shadow DOM. However, due to security reasons, scripts running on a page do not have direct access to the content inside an iframe from a different origin. Similarly, the Shadow DOM provides encapsulation for JavaScript, CSS, and templating, preventing access to the inner DOM structure of shadow trees.

However, if you have control over the iframe or Shadow DOM, you can write a similar function inside the iframe or shadow DOM and call it from the main document.

The example of how you might do this for an iframe

const iframeWindow = document.querySelector('#exampleIframe').contentWindow;
const iframeDocument = iframeWindow.document;

function getHighestZindexIncludingIframes(selector) {
  const zIndexes = [];
  const elements = Array.from(iframeDocument.querySelectorAll(selector || "*"));

  function collectZIndexes(elements) {
    for (const element of elements) {
      const zIndex = iframeWindow.getComputedStyle(element, null).getPropertyValue("z-index");

      if (zIndex !== null && zIndex !== "auto") {
        zIndexes.push(Number(zIndex));
      }
    }
  }

  collectZIndexes(elements);

  const shadowRoots = elements.filter(el => el.shadowRoot);

  for (const root of shadowRoots) {
    if (root.shadowRoot === null) {
      continue;
    }

    collectZIndexes(Array.from(root.shadowRoot.querySelectorAll("*")));
  }

  return zIndexes.length === 0 ? 0 : Math.max(...zIndexes);
}

Optimize function for performance

Walking through a large number of DOM elements might significantly slow down the function’s execution. However, a few strategies could be taken into consideration:

• Use :not() CSS pseudo-class. This helps to exclude certain elements from the list. An example that excludes script and style HTML elements: document.querySelectorAll('body *:not(script, style)');. Note that symbol * is called an universal CSS selector.
• The for loop instead of forEach, map, filter. Using the for loop can sometimes be faster because it avoids the overhead of calling a function on each iteration loop. Besides, the for loop can be stopped on certain conditions, while forEach, map, and filter must loop to the last item in the loop.