JavaScript无法访问Iframe内元素，求正确实现方案

尝试使用iframe.contentWindow.document.getElementsByClassName("element")方法访问iframe内元素但失败，相关代码如下：

10.html 文件代码 #

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8" />
  <meta http-equiv="X-UA-Compatible" content="IE=edge" />
  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
  <title>Onboard Access Iframe Elements</title>
  <link rel="stylesheet" href="./10.css" />
</head>
<body>
  <div class="layer">
    <div class="iframe-container">
      <!-- I wanted to access the element inside the iframe bellow  -->
      <iframe
        class="iframe-element"
        height="100%"
        width="100%"
        src="./iframe.html"
        frameborder="0"
      ></iframe>
    </div>
  </div>
  <script src="./10.js"></script>
</body>
</html>

iframe.html 文件代码 #

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8" />
  <meta http-equiv="X-UA-Compatible" content="IE=edge" />
  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
  <title>HTML For Iframe</title>
  <style>
    body {
      width: 100vw;
      height: 100vh;
      display: flex;
      flex-direction: column;
      overflow: hidden;
    }
    .element {
      font-size: 24px;
    }
  </style>
</head>
<body>
  <div class="element element1">1</div>
  <div class="element element2">2</div>
  <div class="element element3">3</div>
  <div class="element element4">4</div>
  <div class="element element5">5</div> 
</body> 
</html>

10.js 文件代码 #

(function () {
const classes = {
  iframeElement: "iframe-element",
};
/**
 * @param {HTMLIFrameElement} iframe
 */
function getIframeElements(iframe) {
  console.log(
    iframe.contentWindow.document.getElementsByClassName("element")
  );
}
function main() {
  const iframeElement = document.getElementsByClassName(
    classes.iframeElement
  )[0];
  getIframeElements(iframeElement);
}
main();
})();

10.css 文件代码 #

* {
  box-sizing: border-box;
  margin: 0;
  padding: 0;
}
.layer {
width: 100%;
height: 100vh;
background-color: blanchedalmond;
display: flex;
justify-content: center;
align-items: center;
}
.iframe-container {
width: 500px;
height: 300px;
border: 5px solid #000;
}

• 等待iframe加载完成再访问：当前代码在页面初始化时立即执行，但iframe内容尚未加载完毕，此时contentWindow.document未完全初始化。需监听iframe的load事件，确保内容加载完成后再访问：
  修改后的10.js代码：

  (function () {
  const classes = {
    iframeElement: "iframe-element",
  };
  /**
   * @param {HTMLIFrameElement} iframe
   */
  function getIframeElements(iframe) {
    console.log(iframe.contentWindow.document.getElementsByClassName("element"));
  }
  function main() {
    const iframeElement = document.getElementsByClassName(classes.iframeElement)[0];
    // 监听加载完成事件
    iframeElement.addEventListener('load', () => {
      getIframeElements(iframeElement);
    });
  }
  main();
  })();
  

• 确认同源策略合规：必须保证iframe的src与主页面同源（相同协议、域名、端口）。跨域情况下浏览器会阻止直接访问contentWindow，此时只能通过postMessage与iframe页面通信，或目标页面配置CORS规则。你的代码中iframe为本地文件，通过HTTP服务器打开而非直接双击本地文件，即可满足同源要求。
• 优化元素选择方式：可以使用querySelectorAll替代getElementsByClassName，返回静态NodeList，更便于后续操作：

  iframe.contentWindow.document.querySelectorAll(".element")
  

内容的提问来源于stack exchange，提问作者tcvd