Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Fungsi perpustakaan tersedia untuk skrip canary Node.js menggunakan Playwright

Bagian ini menjelaskan fungsi pustaka yang tersedia untuk skrip canary menggunakan runtime Node.js Playwright.

meluncurkan

Fungsi ini meluncurkan browser Chromium menggunakan fungsi peluncuran Playwright, dan mengembalikan objek browser. Ini mendekompresi binari browser dan meluncurkan browser chromium dengan menggunakan opsi default yang cocok untuk browser tanpa kepala. Untuk informasi selengkapnya tentang launch fungsi ini, lihat launchdi dokumentasi Playwright.

Penggunaan

const browser = await synthetics.launch();

Argumen

optionsopsi (opsional) adalah serangkaian opsi yang dapat dikonfigurasi untuk browser.

Pengembalian

Janji <Browser> di mana Browser adalah contoh browser Playwright.

Jika fungsi ini dipanggil lagi, browser yang sebelumnya dibuka ditutup sebelum memulai browser baru. Anda dapat mengganti parameter peluncuran yang digunakan oleh CloudWatch Synthetics, dan meneruskan parameter tambahan saat meluncurkan browser. Misalnya, cuplikan kode berikut meluncurkan browser dengan argumen default dan jalur default yang dapat dieksekusi, tetapi dengan viewport 800 x 600 piksel. Untuk informasi selengkapnya, lihat Opsi peluncuran Playwright di dokumentasi Playwright.

const browser = await synthetics.launch({
  defaultViewport: { 
      "deviceScaleFactor": 1, 
      "width": 800,
      "height": 600 
}});

Anda juga dapat menambahkan atau mengganti flag Chromium yang diteruskan secara default ke browser. Misalnya, Anda dapat menonaktifkan keamanan web dengan menambahkan --disable-web-security tanda ke argumen dalam parameter peluncuran CloudWatch Synthetics:

// This function adds the --disable-web-security flag to the launch parameters
const defaultOptions = await synthetics.getDefaultLaunchOptions();
const launchArgs = [...defaultOptions.args, '--disable-web-security'];
const browser = await synthetics.launch({
    args: launchArgs
  });

Halaman baru

newPage()Fungsi membuat dan mengembalikan halaman Playwright baru. Synthetics secara otomatis menyiapkan koneksi Chrome DevTools Protocol (CDP) untuk mengaktifkan tangkapan jaringan untuk pembuatan arsip HTTP (HAR).

Penggunaan

Gunakan newPage() salah satu cara berikut:

1. Membuat halaman baru dalam konteks browser baru:

const page = await synthetics.newPage(browser);

2. Membuat halaman baru dalam konteks browser tertentu:

// Create a new browser context
const browserContext = await browser.newContext();

// Create a new page in the specified browser context
const page = await synthetics.newPage(browserContext)

Argumen

Menerima contoh Playwright Browser atau contoh Playwright. BrowserContext

Pengembalian

Janji <Page>di mana Page adalah contoh Halaman Penulis Naskah.

tutup

Menutup browser yang saat ini dibuka.

Penggunaan

await synthetics.close();

Disarankan untuk menutup browser di finally blok skrip Anda.

Argumen

Tidak ada

Pengembalian

Mengembalikan Promise <void>yang digunakan oleh fungsi peluncuran Synthetics untuk meluncurkan browser.

getDefaultLaunchPilihan

getDefaultLaunchOptions()Fungsi mengembalikan opsi peluncuran browser yang digunakan oleh CloudWatch Synthetics.

Penggunaan

const defaultOptions = await synthetics.getDefaultLaunchOptions();

Argumen

Tidak ada

Pengembalian

Mengembalikan opsi peluncuran Playwright yang digunakan oleh launch fungsi Synthetics untuk meluncurkan browser.

executeStep

executeStepFungsi ini digunakan untuk mengeksekusi langkah dalam skrip Synthetics. Dalam CloudWatch Synthetics, langkah Synthetics adalah cara untuk memecah skrip kenari Anda menjadi serangkaian tindakan yang didefinisikan dengan jelas, memungkinkan Anda untuk memantau berbagai bagian perjalanan aplikasi Anda secara terpisah. Untuk setiap langkah, CloudWatch Synthetics melakukan hal berikut:

Penggunaan

await synthetics.executeStep("mystepname", async function () {
  await page.goto(url, { waitUntil: 'load', timeout: 30000 });
}

Argumen

Pengembalian

Mengembalikan Promise yang menyelesaikan dengan nilai yang dikembalikan oleh fungsi. functionToExecute Untuk contoh skrip, lihat Kode sampel untuk skrip canary di panduan ini.