如何在 Cypress 中處理 iframe

介紹

在 Web 應用程式中測試 iframe 通常很棘手，尤其是在使用現代測試自動化工具時。 Cypress 憑藉其直覺的設計和強大的 API，簡化了許多測試挑戰。然而，在 Cypress 中處理 iframe 需要一些額外的設置，因為 Cypress 不直接支援存取 iframe 內的內容。

在這篇文章中，我們將探討如何在 Cypress 中處理 iframe，並提供實際範例和高效 iframe 測試的技巧。

什麼是 iframe？

iframe（內嵌框架的縮寫）是一種在目前網頁中嵌入另一個文件的 HTML 元素。它通常用於將廣告、影片或小部件等外部內容載入到頁面中，而無需刷新整個頁面。

為什麼 iframe 在 Cypress 中具有挑戰性

Cypress 在瀏覽器上下文中運行，該上下文對於跨來源存取具有嚴格的安全限制。由於 iframe 實質上是在父頁中載入另一個網頁，因此由於這些瀏覽器安全限制，Cypress 無法使用 .get() 或 .find() 等標準指令直接存取 iframe 內的元素。

在 Cypress 中處理 iframe：基礎知識

要在 Cypress 使用 iframe，我們需要：

1. 存取 iframe 的內容。
2. 使用 Cypress 指令與 iframe 內的元素進行互動。

方法：使用 jQuery 和 Cypress

Cypress 在底層使用 jQuery，它提供了一種存取 iframe 內容的方法。使用 jQuery，我們可以存取 iframe 的文檔，然後從那裡我們可以定位 iframe 內的元素。

逐步範例

讓我們來看一個與網頁上的 iframe 互動的範例。在此範例中，我們將：

• 載入包含 iframe 的網頁。
• 訪問 iframe。
• 與 iframe 內的元素交互作用。

1。載入頁面並造訪 iframe
以下是帶有 iframe 的 HTML 結構範例：

  <title>Iframe Example</title>


  <h1 id="Welcome-to-the-iframe-Example">Welcome to the iframe Example</h1>
  <iframe id="myIframe" src="https://example.com/iframe-content"></iframe>

在此範例中，我們有一個 id="myIframe" 的 iframe。我們將使用 Cypress 存取此 iframe 並與其中的內容進行互動。

2。用於處理 iframe 的 Cypress 自訂指令
由於處理 iframe 是一項常見任務，因此建立自訂 Cypress 命令可以簡化此過程。讓我們建立一個檢索 iframe 主體的自訂指令：

Cypress.Commands.add('getIframeBody', (iframeSelector) => {
  // Wait for the iframe to load
  cy.get(iframeSelector)
    .its('0.contentDocument.body').should('not.be.empty')
    .then(cy.wrap);
});

3。與 iframe 內的元素交互作用
現在我們有了存取 iframe 主體的自訂指令，我們可以與 iframe 內的元素進行互動。以下是如何在測試中使用它的範例：

describe('Iframe Test', () => {
  it('should access and interact with an element inside an iframe', () => {
    cy.visit('http://localhost:8080/iframe-page');

    // Use the custom command to get the iframe body
    cy.getIframeBody('#myIframe').within(() => {
      // Now we can interact with elements inside the iframe
      cy.get('h1').should('contain.text', 'Iframe Content Title');
      cy.get('button#submit').click();
    });
  });
});

在此測試中：

• 我們使用 iframe 來存取頁面。
• 我們使用自訂的 getIframeBody 指令來存取 iframe 內容。
• 我們與 iframe 內的元素進行交互，例如斷言 h1 元素的文字並點擊按鈕。

處理跨源 iframe

由於瀏覽器安全策略的原因，使用跨來源 iframe（從不同網域載入內容的 iframe）會帶來額外的挑戰。由於同源政策，Cypress 無法直接存取跨源 iframe 內的元素或與之互動。

以下是 Cypress 中處理跨源 iframe 的一些策略：

1. 模擬 iframe 內容： 不要載入實際的跨來源內容，而是在測試中模擬 iframe 內容。
2. 使用 API 測試：如果您在 iframe 內處理外部服務，請考慮使用 API 測試來直接測試服務而不是 UI。
3. 使用 cy.origin(): 如果 Cypress 和瀏覽器支持，則可以使用 cy.origin() 指令來處理跨來源 iframe 內容。但是，請注意，這是實驗性的，可能需要額外的設定。

範例：使用 cy.origin() 處理跨源 iframe

describe('Cross-Origin Iframe Test', () => {
  it('should handle a cross-origin iframe', () => {
    cy.visit('http://localhost:8080/cross-origin-iframe-page');

    cy.origin('https://example-iframe.com', () => {
      cy.get('#iframe-element').should('contain.text', 'Cross-Origin Content');
    });
  });
});

在此測試中，cy.origin() 指令允許我們與跨來源 iframe 內的元素進行交互，前提是網域設定允許這樣做。

在 Cypress 中處理 iframe 的最佳實踐

以下是在 Cypress 中使用 iframe 時需要記住的一些最佳實踐：

1. Gunakan Perintah Tersuai: Merangkumkan logik pengendalian iframe dalam perintah tersuai, seperti getIframeBody, menjadikan ujian anda lebih bersih dan lebih mudah diselenggara.
2. Elakkan iframe Silang Asal: Jika boleh, elakkan bergantung pada iframe silang asal. Jika anda mesti menguji iframe silang asal, pertimbangkan untuk menggunakan cy.origin() atau ujian API.
3. Tunggu sehingga iframe dimuatkan: Sentiasa pastikan kandungan iframe dimuatkan sepenuhnya sebelum cuba berinteraksi dengannya. Gunakan .should('not.be.empty') atau .its('contentDocument.body') untuk mengesahkan bahawa kandungan iframe boleh diakses.
4. Modularize Ujian: Jika aplikasi anda menggunakan berbilang iframe, susun ujian anda secara modular untuk mengendalikan setiap interaksi iframe secara berasingan.

Kesimpulan

Mengendalikan iframe dalam Cypress memerlukan sedikit kerja tambahan, tetapi dengan mencipta arahan tersuai dan menggunakan kaedah jQuery, anda boleh berinteraksi dengan elemen dalam iframe dengan berkesan. Untuk iframe silang asal, pertimbangkan untuk menggunakan cy.origin() atau ujian API jika boleh. Dengan pendekatan yang betul dan strategi ujian yang kukuh, anda boleh menguji aplikasi web yang bergantung pada iframe dengan yakin.

以上是如何在 Cypress 中處理 iframe的詳細內容。更多資訊請關注PHP中文網其他相關文章！