Cypress で iframe を処理する方法

pengenalan

Menguji iframe dalam aplikasi web selalunya boleh menjadi rumit, terutamanya apabila bekerja dengan alat automasi ujian moden. Cypress, dengan reka bentuk intuitif dan API yang berkuasa, memudahkan banyak cabaran ujian. Walau bagaimanapun, pengendalian iframe dalam Cypress memerlukan sedikit persediaan tambahan kerana Cypress tidak menyokong secara langsung mengakses kandungan dalam iframe.

Dalam catatan blog ini, kami akan meneroka cara mengendalikan iframe dalam Cypress, lengkap dengan contoh praktikal dan petua untuk ujian iframe yang cekap.

Apakah iframes?

Iframe (singkatan untuk bingkai sebaris) ialah elemen HTML yang membenamkan dokumen lain dalam halaman web semasa. Ia biasanya digunakan untuk memuatkan kandungan luaran seperti iklan, video atau widget ke dalam halaman tanpa memuatkan semula keseluruhan halaman.

Mengapa iframes Mencabar di Cypress

Cypress beroperasi dalam konteks penyemak imbas, yang mempunyai had keselamatan yang ketat mengenai akses silang asal. Memandangkan iframe pada asasnya memuatkan halaman web lain dalam halaman induk, Cypress tidak boleh mengakses terus elemen dalam iframe menggunakan arahan standard seperti .get() atau .find() disebabkan oleh sekatan keselamatan penyemak imbas ini.

Mengendalikan iframe dalam Cypress: Asas

Untuk bekerja dengan iframe dalam Cypress, kita perlu:

1. Dapatkan akses kepada kandungan iframe.
2. Gunakan arahan Cypress untuk berinteraksi dengan elemen di dalam iframe.

Pendekatan: Menggunakan jQuery dan Cypress

Cypress menggunakan jQuery di bawah hud, yang menyediakan cara untuk mengakses kandungan iframe. Dengan jQuery, kita boleh mengakses dokumen iframe, dan dari situ, kita boleh menyasarkan elemen di dalam iframe.

Contoh Langkah demi Langkah

Mari kita lihat contoh di mana kita berinteraksi dengan iframe pada halaman web. Dalam contoh ini, kita akan:

• Muatkan halaman web yang mengandungi iframe.
• Akses iframe.
• Berinteraksi dengan elemen dalam iframe.

1. Muatkan Halaman dan Akses iframe
Berikut ialah contoh struktur HTML dengan iframe:

  <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>

Dalam contoh ini, kami mempunyai iframe dengan id="myIframe". Kami akan menggunakan Cypress untuk mengakses iframe ini dan berinteraksi dengan kandungan di dalamnya.

2. Perintah Tersuai Cypress untuk Mengendalikan iframe
Memandangkan pengendalian iframe adalah tugas biasa, mencipta perintah Cypress tersuai memudahkan proses. Mari buat perintah tersuai yang mendapatkan semula badan 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. Berinteraksi dengan Elemen Di Dalam iframe
Kini setelah kita mempunyai perintah tersuai untuk mengakses badan iframe, kita boleh berinteraksi dengan elemen di dalam iframe. Berikut ialah contoh cara menggunakannya dalam ujian:

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();
    });
  });
});

Dalam ujian ini:

• Kami melawat halaman dengan iframe.
• Kami menggunakan perintah getIframeBody tersuai untuk mengakses kandungan iframe.
• Kami berinteraksi dengan elemen dalam iframe, seperti menegaskan teks elemen h1 dan mengklik butang.

Mengendalikan iframe Silang Asal

Bekerja dengan iframe silang asal (iframe yang memuatkan kandungan daripada domain berbeza) menimbulkan cabaran tambahan kerana dasar keselamatan penyemak imbas. Cypress tidak boleh mengakses atau berinteraksi secara langsung dengan elemen dalam iframe silang asal disebabkan oleh Dasar Asal Sama.

Berikut ialah beberapa strategi untuk mengendalikan iframe silang asal dalam Cypress:

1. Olok-olok kandungan iframe: Daripada memuatkan kandungan silang asal sebenar, olok-olok kandungan iframe dalam ujian anda.
2. Gunakan ujian API: Jika anda berurusan dengan perkhidmatan luaran di dalam iframe, pertimbangkan untuk menggunakan ujian API untuk menguji perkhidmatan secara langsung dan bukannya UI.
3. Gunakan cy.origin(): Jika Cypress dan penyemak imbas menyokongnya, anda boleh menggunakan perintah cy.origin() untuk mengendalikan kandungan iframe silang asal. Walau bagaimanapun, ambil perhatian bahawa ini adalah percubaan dan mungkin memerlukan persediaan tambahan.

Contoh: Mengendalikan iframe Cross-Origin dengan cy.origin()

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');
    });
  });
});

Dalam ujian ini, perintah cy.origin() membenarkan kami berinteraksi dengan elemen di dalam iframe silang asal, dengan syarat domain disediakan untuk membenarkannya.

Amalan Terbaik untuk Mengendalikan iframe dalam Cypress

Berikut ialah beberapa amalan terbaik yang perlu diingat semasa bekerja dengan iframe dalam Cypress:

1. カスタム コマンドの使用: getIframeBody などのカスタム コマンドで iframe 処理ロジックをカプセル化すると、テストがよりクリーンになり、保守が容易になります。
2. クロスオリジン iframe を避ける: 可能な限り、クロスオリジン iframe への依存を避けてください。クロスオリジン iframe をテストする必要がある場合は、cy.origin() または API テストの使用を検討してください。
3. iframe がロードされるまで待機します: iframe コンテンツを操作する前に、必ず iframe コンテンツが完全にロードされていることを確認してください。 .Should('not.be.empty') または .its('contentDocument.body') を使用して、iframe コンテンツにアクセスできることを確認します。
4. テストのモジュール化: アプリケーションで複数の iframe を使用する場合は、各 iframe インタラクションを個別に処理するようにテストをモジュール的に構造化します。

結論

Cypress で iframe を処理するには、少し追加の作業が必要ですが、カスタム コマンドを作成し、jQuery メソッドを使用することで、iframe 内の要素を効果的に操作できます。クロスオリジン iframe の場合は、可能であれば cy.origin() または API テストの使用を検討してください。適切なアプローチと確実なテスト戦略があれば、iframe に依存する Web アプリケーションを自信を持ってテストできます。

以上がCypress で iframe を処理する方法の詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。