Cara Mengendalikan iframe dalam Cypress

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 secara langsung menyokong akses 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, kami boleh mengakses dokumen iframe, dan dari situ, kami 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, kami 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. 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.

Atas ialah kandungan terperinci Cara Mengendalikan iframe dalam Cypress. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!